Как добавить Firebase в проект Unity

Улучшайте свои игры для Unity с помощью наших SDK: Firebase и Unity.

Чтобы показать, как легко добавить Firebase в проект Unity, мы создали игру MechaHamster. Если вы хотите попробовать добавить Firebase в игру, используйте стартовую версию, доступную на GitHub. Если вам нужна полная версия, скачайте ее в App Store или Google Play Store.

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (Google Play)


Подробнее о том, как использовать Firebase в играх, можно узнать на странице Firebase для игр.

Вы уже добавили Firebase в проект Unity? Убедитесь, что вы используете последнюю версию Firebase Unity SDK.

Требования

  • Установите Unity 2021 LTS или более позднюю версию. Более ранние версии также могут быть совместимы, но не будут активно поддерживаться.

  • Только для платформ Apple. Установите следующее:

    • Xcode 26.2 или более поздней версии.
    • CocoaPods 1.12.0 или более поздней версии.

  • Убедитесь, что ваш проект Unity соответствует следующим требованиям:

    • Для iOS – iOS 15 или более поздней версии.
    • Для tvOS – tvOS 15 или более поздней версии.
    • Для Android – целевой уровень API 23 (Marshmallow) или выше.

  • Настройте физическое устройство или используйте эмулятор для запуска приложения.

    • Для платформ Apple настройте физическое устройство или используйте симулятор iOS или tvOS.

    • Для Android эмуляторы должны использовать образ эмулятора с Google Play.

Если у вас нет проекта Unity и вы просто хотите попробовать продукт Firebase, скачайте один из наших примеров быстрого запуска.

Шаг 1. Создайте проект Firebase

Прежде чем добавить Firebase в проект Unity, создайте проект Firebase, который будет связан с проектом Unity. Подробнее о проектах Firebase…

Шаг 2. Зарегистрируйте приложение в Firebase

Вы можете зарегистрировать одно или несколько приложений или игр, чтобы подключить их к проекту Firebase.

  1. Откройте консоль Firebase.

  2. На странице Project Overview (Обзор проекта) нажмите на значок Unity (). Будет запущен мастер настройки.

    Если вы уже добавили приложение в проект Firebase, нажмите Добавить приложение, чтобы открыть варианты платформы.

  3. Выберите целевую платформу сборки проекта Unity, которую вы хотите зарегистрировать. Вы также можете зарегистрировать обе платформы одновременно.

  4. Введите идентификаторы, относящиеся к платформе вашего проекта Unity.

    • Для iOS введите идентификатор iOS проекта Unity в поле Идентификатор пакета iOS.

    • Для Android – введите Android ID проекта Unity в поле Название пакета Android.
      Термины название пакета и идентификатор приложения часто используются как взаимозаменяемые.

  5. Необязательно. Укажите псевдонимы для разных платформ, используемые в вашем проекте Unity.
    Эти псевдонимы являются внутренними идентификаторами и видны только вам в консоли Firebase.

  6. Нажмите Register app (Зарегистрировать приложение).

Шаг 3. Добавьте файлы конфигурации Firebase

  1. Получите файлы конфигурации Firebase для своей платформы в процессе настройки консоли Firebase.

    • Для iOS нажмите Скачать GoogleService-Info.plist.

    • Для Android нажмите Скачать google-services.json.

  2. Откройте окно Project в проекте Unity и перенесите файлы конфигурации в папку Assets.

  3. Вернитесь в консоль Firebase и в рабочем процессе настройки нажмите Далее.

Шаг 4. Добавьте Firebase Unity SDK

  1. В консоли Firebase нажмите Скачать SDK Firebase Unity и распакуйте его в удобном месте.

    • Вы можете в любое время скачать Firebase Unity SDK.

    • Firebase Unity SDK не зависит от платформы.

  2. В открытом проекте Unity выберите Assets (Ресурсы) > Import Package (Импортировать пакет) > Custom Package (Собственный пакет).

  3. В распакованном SDK выберите поддерживаемые продукты Firebase, которые хотите использовать в приложении.

    Analytics включена

    • Добавьте пакет Firebase для Google Analytics: FirebaseAnalytics.unitypackage
    • Добавьте пакеты для других продуктов Firebase, которые вы хотите использовать в приложении. Например, чтобы использовать Firebase Authentication и Firebase Realtime Database:
      FirebaseAuth.unitypackage и FirebaseDatabase.unitypackage

    Analytics не включен

    Добавьте пакеты для продуктов Firebase, которые вы хотите использовать в приложении. Например, чтобы использовать Firebase Authentication и Firebase Realtime Database, добавьте следующие строки:
    FirebaseAuth.unitypackage и FirebaseDatabase.unitypackage

  4. В окне Import Unity Package нажмите Import.

  5. Вернитесь в консоль Firebase и в рабочем процессе настройки нажмите Далее.

Шаг 5. Проверьте требования к версии сервисов Google Play

Для некоторых продуктов в Firebase Unity SDK для Android требуется Google Play services. Узнайте, какие продукты имеют эту зависимость. Чтобы использовать эти продукты, нужно обновить Google Play services.

Добавьте в начало приложения приведенный ниже код инициализации и оператор using. Вы можете проверить и при необходимости обновить Google Play services до нужной версии, прежде чем вызывать другие методы в SDK.

using Firebase.Extensions;

Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWithOnMainThread(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.

Как настроить рабочий процесс на компьютере (бета)

При создании игры часто бывает проще сначала протестировать ее в редакторе Unity и на платформах для ПК, а затем развернуть и протестировать на мобильных устройствах. Для поддержки этого рабочего процесса мы предоставляем подмножество SDK Firebase Unity, которые можно запускать в Windows, macOS, Linux и в редакторе Unity.

  1. Настройте проект Unity для платформы ПК, следуя тем же инструкциям, что и для мобильной платформы (начните с шага Зарегистрируйте приложение в Firebase выше).

  2. Запустите проект Unity в IDE Unity или выберите сборку проекта Unity для компьютера.

  3. Необязательно. Запустите проект Unity в режиме редактирования.

    SDK Firebase Unity также можно запустить в режиме редактирования Unity, что позволяет использовать его в плагинах редактора.

    1. При создании FirebaseApp, используемого редактором, не используйте экземпляр по умолчанию.

    2. Вместо этого укажите уникальное название в вызове FirebaseApp.Create().

      Это важно, чтобы избежать конфликта между экземпляром, используемым IDE Unity, и экземпляром, используемым вашим проектом Unity.

Поддерживаемые продукты Firebase

Подробнее о библиотеках Firebase для Unity можно узнать из справочной документации.

Доступные библиотеки Firebase для мобильных устройств

Firebase Unity SDK поддерживает следующие продукты Firebase на платформах Apple и Android:

Продукт Firebase Пакет Unity
AdMob Распространяется отдельно в AdMob плагине Unity
Firebase AI Logic FirebaseAI.unitypackage
Analytics FirebaseAnalytics.unitypackage
App Check FirebaseAppCheck.unitypackage
Authentication FirebaseAuth.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Cloud Functions FirebaseFunctions.unitypackage
Cloud Messaging FirebaseMessaging.unitypackage
(рекомендуется) FirebaseAnalytics.unitypackage
Cloud Storage FirebaseStorage.unitypackage
Crashlytics FirebaseCrashlytics.unitypackage
(рекомендуется) FirebaseAnalytics.unitypackage
Realtime Database FirebaseDatabase.unitypackage
Remote Config FirebaseRemoteConfig.unitypackage
(рекомендуется) FirebaseAnalytics.unitypackage
УСТАРЕВШИЕ ИЛИ НЕПОДДЕРЖИВАЕМЫЕ БИБЛИОТЕКИ
Dynamic Links FirebaseDynamicLinks.unitypackage
(рекомендуется) FirebaseAnalytics.unitypackage

Доступные библиотеки Firebase для компьютеров

Firebase Unity SDK включает поддержку рабочего процесса на компьютере для некоторых продуктов, позволяя использовать определенные части Firebase в редакторе Unity и в отдельных сборках для компьютеров с ОС Windows, macOS и Linux.

Продукт Firebase (компьютер) Пакет Unity
Firebase AI Logic FirebaseAI.unitypackage
App Check FirebaseAppCheck.unitypackage
Authentication FirebaseAuth.unitypackage
Cloud Functions FirebaseFunctions.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Cloud Storage FirebaseStorage.unitypackage
Realtime Database FirebaseDatabase.unitypackage
Remote Config FirebaseRemoteConfig.unitypackage

Остальные библиотеки Firebase для компьютеров предоставляются в виде заглушек (нефункциональных реализаций), чтобы вам было удобнее создавать приложения для Windows, macOS и Linux. Поэтому вам не нужно условно компилировать код для показа на компьютерах.

Дальнейшие действия