Firebase Unity SDK로 Unity 게임을 강화하세요.
Firebase를 Unity 프로젝트에 연결하는 것이 얼마나 쉬운지 보여주기 위해 GitHub , App Store 및 Google Play Store 에서 다운로드할 수 있는 샘플 게임인 MechaHamster를 만들었습니다.
Firebase 게임 페이지 에서 Firebase로 게임을 강화하는 방법에 대해 자세히 알아보세요.
Unity 프로젝트에 Firebase를 이미 추가하셨나요? 최신 버전의 Firebase Unity SDK 를 사용하고 있는지 확인하세요.
전제 조건
Unity 2019.1 이상을 설치합니다. 이전 버전도 호환될 수 있지만 적극적으로 지원되지는 않습니다. Unity 2019.1에 대한 지원은 더 이상 사용되지 않는 것으로 간주되며 다음 주요 릴리스 이후에는 더 이상 적극적으로 지원되지 않습니다.
(Apple 플랫폼만 해당) 다음을 설치합니다.
- 엑스코드 13.3.1 이상
- 코코아팟 1.10.0 이상
Unity 프로젝트가 다음 요구 사항을 충족하는지 확인하세요.
- iOS의 경우 — iOS 11 이상을 대상으로 합니다.
- tvOS용 - tvOS 12 이상 대상
- Android의 경우 — API 레벨 19(KitKat) 이상을 대상으로 합니다.
실제 기기를 설정하거나 에뮬레이터를 사용하여 앱을 실행합니다.
Apple 플랫폼의 경우 — 물리적 장치를 설정하거나 iOS 또는 tvOS 시뮬레이터를 사용합니다.
iOS 또는 tvOS의 클라우드 메시징에 대한 전제 조건은 다음과 같습니다.
- 물리적 장치 를 설정합니다.
- Apple 개발자 계정 에 대한 Apple 푸시 알림 인증 키를 얻습니다.
- App > Capabilities 아래의 XCode에서 푸시 알림을 활성화합니다.
Android의 경우 — 에뮬레이터 는 Google Play에서 에뮬레이터 이미지를 사용해야 합니다.
- Google 계정을 사용하여 Firebase에 로그인 합니다.
아직 Unity 프로젝트가 없고 Firebase 제품을 사용해 보고 싶다면 빠른 시작 샘플 중 하나를 다운로드할 수 있습니다.
1단계 : Firebase 프로젝트 생성
Unity 프로젝트에 Firebase를 추가하려면 먼저 Unity 프로젝트에 연결할 Firebase 프로젝트를 만들어야 합니다. Firebase 프로젝트에 대해 자세히 알아보려면 Firebase 프로젝트 이해 를 방문하세요.
2단계 : Firebase에 앱 등록
Firebase 프로젝트에 연결할 하나 이상의 앱 또는 게임을 등록할 수 있습니다.
Firebase 콘솔 로 이동합니다.
프로젝트 개요 페이지 중앙에서 Unity 아이콘(
)을 클릭하여 설정 워크플로를 시작합니다.Firebase 프로젝트에 앱을 이미 추가한 경우 앱 추가 를 클릭하여 플랫폼 옵션을 표시합니다.
등록하려는 Unity 프로젝트의 빌드 대상을 선택하거나 지금 동시에 두 대상을 등록하도록 선택할 수도 있습니다.
Unity 프로젝트의 플랫폼별 ID를 입력합니다.
iOS의 경우 — iOS 번들 ID 필드에 Unity 프로젝트의 iOS ID를 입력합니다.
Android의 경우 — Android 패키지 이름 필드에 Unity 프로젝트의 Android ID를 입력합니다.
패키지 이름 과 애플리케이션 ID 라는 용어는 종종 같은 의미로 사용됩니다.
Unity IDE에서 Unity 프로젝트를 연 다음 각 플랫폼의 설정 섹션으로 이동합니다.
iOS의 경우 — 빌드 설정 > iOS 로 이동합니다.
Android의 경우 — Android > 플레이어 설정 > 기타 설정 으로 이동합니다.
Unity 프로젝트의 ID는 번들 식별자 값입니다(예제 ID:
com.yourcompany.yourproject
).(선택 사항) Unity 프로젝트의 플랫폼별 닉네임을 입력합니다.
이러한 닉네임은 내부 편의 식별자이며 Firebase 콘솔에서만 볼 수 있습니다.앱 등록 을 클릭합니다.
3단계 : Firebase 구성 파일 추가
Firebase 콘솔 설정 워크플로에서 플랫폼별 Firebase 구성 파일을 가져옵니다.
iOS의 경우 — GoogleService-Info.plist 다운로드 를 클릭합니다.
Android의 경우 — google-services.json 다운로드 를 클릭합니다.
Firebase 구성 파일에는 고유하지만 비밀이 아닌 프로젝트 식별자가 포함되어 있습니다. 이 구성 파일에 대해 자세히 알아보려면 Firebase 프로젝트 이해 를 방문하세요.
언제든지 Firebase 구성 파일 을 다시 다운로드할 수 있습니다.
구성 파일 이름에
(2)
와 같은 추가 문자가 추가되지 않았는지 확인하십시오.
Unity 프로젝트의 프로젝트 창을 연 다음 구성 파일을
Assets
폴더로 이동합니다.Firebase 콘솔로 돌아가서 설정 워크플로에서 다음 을 클릭합니다.
4단계 : Firebase Unity SDK 추가
Firebase 콘솔에서 Firebase Unity SDK 다운로드 를 클릭한 다음 편리한 위치에 SDK의 압축을 풉니다.
언제든지 Firebase Unity SDK 를 다시 다운로드할 수 있습니다.
Firebase Unity SDK는 플랫폼별로 다르지 않습니다.
열려 있는 Unity 프로젝트에서 Assets > Import Package > Custom Package 로 이동합니다.
압축을 푼 SDK에서 앱에서 사용하려는 지원되는 Firebase 제품 을 선택합니다.
애널리틱스 사용
- Google 애널리틱스용 Firebase 패키지 추가:
FirebaseAnalytics.unitypackage
- 앱에서 사용하려는 다른 Firebase 제품의 패키지를 추가합니다. 예를 들어 Firebase 인증 및 Firebase 실시간 데이터베이스를 사용하려면 다음을 수행합니다.
FirebaseAuth.unitypackage
및FirebaseDatabase.unitypackage
애널리틱스가 사용 설정되지 않음
앱에서 사용하려는 Firebase 제품의 패키지를 추가합니다. 예를 들어 Firebase 인증 및 Firebase 실시간 데이터베이스를 사용하려면 다음을 수행합니다.
FirebaseAuth.unitypackage
및FirebaseDatabase.unitypackage
- Google 애널리틱스용 Firebase 패키지 추가:
Unity 패키지 가져오기 창에서 가져오기 를 클릭합니다.
Firebase 콘솔로 돌아가서 설정 워크플로에서 다음 을 클릭합니다.
5단계 : Google Play 서비스 버전 요구 사항 확인
Android용 Firebase Unity SDK에는 Google Play 서비스 가 필요하며 SDK를 사용하려면 최신 버전이어야 합니다.
애플리케이션 시작 부분에 다음 코드를 추가합니다. SDK에서 다른 메서드를 호출하기 전에 Firebase Unity SDK에 필요한 버전으로 Google Play 서비스를 확인하고 선택적으로 업데이트할 수 있습니다.
Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWith(task => { var dependencyStatus = task.Result; if (dependencyStatus == Firebase.DependencyStatus.Available) { // Create and hold a reference to your FirebaseApp, // where app is a Firebase.FirebaseApp property of your application class. app = Firebase.FirebaseApp.DefaultInstance; // Set a flag here to indicate whether Firebase is ready to use by your app. } else { UnityEngine.Debug.LogError(System.String.Format( "Could not resolve all Firebase dependencies: {0}", dependencyStatus)); // Firebase Unity SDK is not safe to use here. } });
설정이 완료되었습니다. Unity 프로젝트가 Firebase를 사용하도록 등록 및 구성되었습니다.
하지만 설정하는 데 문제가 있는 경우 Unity 문제 해결 및 FAQ 를 방문하세요.
데스크톱 워크플로 설정( 베타 )
게임을 만들 때 먼저 Unity 에디터와 데스크톱 플랫폼에서 게임을 테스트한 다음 나중에 개발 단계에서 모바일 장치에 배포하고 테스트하는 것이 훨씬 쉬운 경우가 많습니다. 이 워크플로를 지원하기 위해 Windows, macOS, Linux 및 Unity 편집기 내에서 실행할 수 있는 Firebase Unity SDK의 하위 집합을 제공합니다.
모바일 플랫폼과 동일한 지침에 따라 데스크톱 플랫폼 Unity 프로젝트를 설정합니다(위 의 Firebase에 앱 등록 단계부터 시작).
Unity IDE에서 Unity 프로젝트를 실행하거나 데스크톱 용 Unity 프로젝트를 빌드하도록 선택합니다.
(선택 사항) 편집 모드에서 Unity 프로젝트를 실행합니다.
Firebase Unity SDK는 Unity의 편집 모드에서도 실행할 수 있으므로 편집기 플러그인에서 사용할 수 있습니다.
편집기에서 사용하는
FirebaseApp
을 만들 때 기본 인스턴스를 사용하지 마세요.대신
FirebaseApp.Create()
호출에 고유한 이름을 제공하십시오.이는 Unity IDE에서 사용하는 인스턴스와 Unity 프로젝트에서 사용하는 인스턴스 간의 옵션 충돌을 피하는 데 중요합니다.
지원되는 Firebase 제품
참조 문서 에서 Unity Firebase 라이브러리에 대해 자세히 알아보세요.
모바일용으로 사용 가능한 Firebase 라이브러리
Firebase Unity SDK는 Apple 및 Android 에서 다음과 같은 Firebase 제품을 지원합니다.
Firebase 제품 | 유니티 패키지 |
---|---|
애드몹 | AdMob Unity 플러그인에서 별도로 배포 |
해석학 | FirebaseAnalytics.unitypackage |
입증 | FirebaseAuth.unitypackage |
클라우드 파이어스토어 | FirebaseFirestore.unitypackage |
클라우드 함수 | FirebaseFunctions.unitypackage |
클라우드 메시징 | FirebaseMessaging.unitypackage (권장) FirebaseAnalytics.unitypackage |
클라우드 스토리지 | FirebaseStorage.unitypackage |
Crashlytics | FirebaseCrashlytics.unitypackage (권장) FirebaseAnalytics.unitypackage |
동적 링크 | FirebaseDynamicLinks.unitypackage (권장) FirebaseAnalytics.unitypackage |
실시간 데이터베이스 | FirebaseDatabase.unitypackage |
원격 구성 | FirebaseRemoteConfig.unitypackage (권장) FirebaseAnalytics.unitypackage |
데스크톱용으로 사용 가능한 Firebase 라이브러리
Firebase Unity SDK에는 일부 제품에 대한 데스크톱 워크플로 지원 이 포함되어 있어 Firebase의 특정 부분을 Unity 편집기와 Windows, macOS, Linux의 독립형 데스크톱 빌드에서 사용할 수 있습니다.
Firebase 제품(데스크톱) | 유니티 패키지 |
---|---|
입증 | FirebaseAuth.unitypackage |
클라우드 기능 | FirebaseFunctions.unitypackage |
클라우드 파이어스토어 | FirebaseFirestore.unitypackage |
클라우드 스토리지 | FirebaseStorage.unitypackage |
실시간 데이터베이스 | FirebaseDatabase.unitypackage |
원격 구성 | FirebaseRemoteConfig.unitypackage |
Firebase는 Windows, macOS 및 Linux용으로 빌드할 때 편의를 위해 나머지 데스크톱 라이브러리를 스텁(비기능) 구현으로 제공합니다. 따라서 데스크톱을 대상으로 하는 코드를 조건부로 컴파일할 필요가 없습니다.
다음 단계
샘플 Firebase 앱 을 살펴보세요.
앱 실행 준비:
- Google Cloud Console에서 프로젝트에 대한 예산 알림 을 설정하세요.
- Firebase Console에서 사용량 및 결제 대시보드 를 모니터링하여 여러 Firebase 서비스에서 프로젝트 사용량을 전체적으로 파악하세요.
- Firebase 출시 체크리스트 를 검토하세요.
Firebase와 Unity 프로젝트에 문제가 있습니까? Unity 문제 해결 및 FAQ 를 방문하십시오.