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

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

Чтобы показать, как легко подключить Firebase к проекту Unity, мы создали пример игры – MechaHamster. Если вы хотите попробовать добавить Firebase в игру, используйте начальную версию на GitHub. Если вы хотите получить полную версию, посмотрите версии в магазине приложений или 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 24 (Nougat) или выше.

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

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

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

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

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

Прежде чем добавить Firebase в проект Unity, создайте проект Firebase. Подробнее о проектах 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 – нажмите Download google-services.json (Скачать google-services.json).

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

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

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

  1. В консоли Firebase нажмите Download Firebase Unity SDK (Скачать SDK для ), а затем распакуйте SDK в удобное место.

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

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

  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 и в процессе настройки нажмите Next (Далее).

Шаг 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 и на настольных платформах, а затем развернуть и протестировать на мобильных устройствах на более поздних этапах разработки. Чтобы поддержать этот рабочий процесс, мы предоставляем подмножество SDK Firebase Unity, которые могут работать в Windows, macOS, Linux и в редакторе Unity.

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

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

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

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

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

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

      Это важно, чтобы избежать конфликта между экземплярами, используемыми Unity IDE и вашим проектом 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. Поэтому вам не нужно условно компилировать код для ПК.

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