获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

Unity 프로젝트에 Firebase 추가

Firebase Unity SDK로 Unity 게임을 강화하세요.

Firebase를 Unity 프로젝트에 연결하는 것이 얼마나 쉬운지 보여주기 위해 GitHub , App StoreGoogle Play Store 에서 다운로드할 수 있는 샘플 게임인 MechaHamster를 만들었습니다.

메카햄스터(GitHub)

메카햄스터(앱스토어)

메카햄스터(Play 스토어)


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 시뮬레이터를 사용합니다.

    • Android의 경우에뮬레이터 는 Google Play에서 에뮬레이터 이미지를 사용해야 합니다.

아직 Unity 프로젝트가 없고 Firebase 제품을 사용해 보고 싶다면 빠른 시작 샘플 중 하나를 다운로드할 수 있습니다.

1단계 : Firebase 프로젝트 생성

Unity 프로젝트에 Firebase를 추가하려면 먼저 Unity 프로젝트에 연결할 Firebase 프로젝트를 만들어야 합니다. Firebase 프로젝트에 대해 자세히 알아보려면 Firebase 프로젝트 이해 를 방문하세요.

2단계 : Firebase에 앱 등록

Firebase 프로젝트에 연결할 하나 이상의 앱 또는 게임을 등록할 수 있습니다.

  1. Firebase 콘솔 로 이동합니다.

  2. 프로젝트 개요 페이지 중앙에서 Unity 아이콘( )을 클릭하여 설정 워크플로를 시작합니다.

    Firebase 프로젝트에 앱을 이미 추가한 경우 앱 추가 를 클릭하여 플랫폼 옵션을 표시합니다.

  3. 등록하려는 Unity 프로젝트의 빌드 대상을 선택하거나 지금 동시에 두 대상을 등록하도록 선택할 수도 있습니다.

  4. Unity 프로젝트의 플랫폼별 ID를 입력합니다.

    • iOS의 경우iOS 번들 ID 필드에 Unity 프로젝트의 iOS ID를 입력합니다.

    • Android의 경우Android 패키지 이름 필드에 Unity 프로젝트의 Android ID를 입력합니다.
      패키지 이름애플리케이션 ID 라는 용어는 종종 같은 의미로 사용됩니다.

  5. (선택 사항) Unity 프로젝트의 플랫폼별 닉네임을 입력합니다.
    이러한 닉네임은 내부 편의 식별자이며 Firebase 콘솔에서만 볼 수 있습니다.

  6. 앱 등록 을 클릭합니다.

3단계 : Firebase 구성 파일 추가

  1. Firebase 콘솔 설정 워크플로에서 플랫폼별 Firebase 구성 파일을 가져옵니다.

    • iOS의 경우GoogleService-Info.plist 다운로드 를 클릭합니다.

    • Android의 경우google-services.json 다운로드 를 클릭합니다.

  2. Unity 프로젝트의 프로젝트 창을 연 다음 구성 파일을 Assets 폴더로 이동합니다.

  3. Firebase 콘솔로 돌아가서 설정 워크플로에서 다음 을 클릭합니다.

4단계 : Firebase Unity SDK 추가

  1. Firebase 콘솔에서 Firebase Unity SDK 다운로드 를 클릭한 다음 편리한 위치에 SDK의 압축을 풉니다.

    • 언제든지 Firebase Unity SDK 를 다시 다운로드할 수 있습니다.

    • Firebase Unity SDK는 플랫폼별로 다르지 않습니다.

  2. 열려 있는 Unity 프로젝트에서 Assets > Import Package > Custom Package 로 이동합니다.

  3. 압축을 푼 SDK에서 앱에서 사용하려는 지원되는 Firebase 제품 을 선택합니다.

    애널리틱스 사용

    • Google 애널리틱스용 Firebase 패키지 추가: FirebaseAnalytics.unitypackage
    • 앱에서 사용하려는 다른 Firebase 제품의 패키지를 추가합니다. 예를 들어 Firebase 인증 및 Firebase 실시간 데이터베이스를 사용하려면 다음을 수행합니다.
      FirebaseAuth.unitypackageFirebaseDatabase.unitypackage

    애널리틱스가 사용 설정되지 않음

    앱에서 사용하려는 Firebase 제품의 패키지를 추가합니다. 예를 들어 Firebase 인증 및 Firebase 실시간 데이터베이스를 사용하려면 다음을 수행합니다.
    FirebaseAuth.unitypackageFirebaseDatabase.unitypackage

  4. Unity 패키지 가져오기 창에서 가져오기 를 클릭합니다.

  5. 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의 하위 집합을 제공합니다.

  1. 모바일 플랫폼과 동일한 지침에 따라 데스크톱 플랫폼 Unity 프로젝트를 설정합니다(위 의 Firebase에 앱 등록 단계부터 시작).

  2. Unity IDE에서 Unity 프로젝트를 실행하거나 데스크톱 용 Unity 프로젝트를 빌드하도록 선택합니다.

  3. (선택 사항) 편집 모드에서 Unity 프로젝트를 실행합니다.

    Firebase Unity SDK는 Unity의 편집 모드에서도 실행할 수 있으므로 편집기 플러그인에서 사용할 수 있습니다.

    1. 편집기에서 사용하는 FirebaseApp 을 만들 때 기본 인스턴스를 사용하지 마세요.

    2. 대신 FirebaseApp.Create() 호출에 고유한 이름을 제공하십시오.

      이는 Unity IDE에서 사용하는 인스턴스와 Unity 프로젝트에서 사용하는 인스턴스 간의 옵션 충돌을 피하는 데 중요합니다.

지원되는 Firebase 제품

참조 문서 에서 Unity Firebase 라이브러리에 대해 자세히 알아보세요.

모바일용으로 사용 가능한 Firebase 라이브러리

Firebase Unity SDK는 AppleAndroid 에서 다음과 같은 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용으로 빌드할 때 편의를 위해 나머지 데스크톱 라이브러리를 스텁(비기능) 구현으로 제공합니다. 따라서 데스크톱을 대상으로 하는 코드를 조건부로 컴파일할 필요가 없습니다.

다음 단계