Добавьте Firebase в свой проект Unity

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

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

МехаХамстер (GitHub)

МехаХамстер (магазин приложений)

MechaHamster (Play Маркет)


Узнайте больше о том, как улучшить свои игры с помощью Firebase, на нашей странице игр Firebase .

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

Предпосылки

  • Установите Unity 2018.4 или более позднюю версию. Более ранние версии также могут быть совместимы, но не будут активно поддерживаться. Поддержка Unity 2018.4 считается устаревшей и больше не будет активно поддерживаться после выхода следующего основного выпуска.

  • (только для iOS) Установите следующее:

    • Xcode 13.3.1 или выше
    • CocoaPods 1.10.0 или выше

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

    • Для iOS — ориентируется на iOS 10 или выше.

    • Для Android — уровень API 19 (KitKat) или выше.

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

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

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

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

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

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

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

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

  1. Перейдите в консоль Firebase .

  2. В центре страницы обзора проекта щелкните значок Unity ( ), чтобы запустить рабочий процесс установки.

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

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

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

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

    • Для Android — введите идентификатор Android вашего проекта Unity в поле имени пакета Android .
      Термины « имя пакета» и « идентификатор приложения» часто используются взаимозаменяемо.

  5. (Необязательно) Введите псевдоним(а) вашего проекта Unity для конкретной платформы.
    Эти псевдонимы являются внутренними, удобными идентификаторами и видны только вам в консоли Firebase.

  6. Щелкните Зарегистрировать приложение .

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

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

    • Для iOS — нажмите Загрузить GoogleService-Info.plist .

    • Для Android : нажмите Загрузить google-services.json .

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

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

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

  1. В консоли Firebase нажмите « Загрузить SDK Firebase Unity » и разархивируйте SDK в удобное место.

    • Вы можете снова загрузить Firebase Unity SDK в любое время.

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

  2. В открытом проекте Unity перейдите к Assets > Import Package > Custom Package .

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

    Аналитика включена

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

    Аналитика не включена

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

  4. В окне « Импорт пакета Unity » нажмите « Импорт ».

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

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

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

Добавьте следующий код в начале вашего приложения. Вы можете проверить и при необходимости обновить сервисы Google Play до версии, необходимой для Firebase Unity SDK, прежде чем вызывать какие-либо другие методы в SDK.

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 .

Настройка рабочего процесса на рабочем столе ( бета-версия )

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

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

  2. Запустите свой проект Unity в Unity IDE или выберите сборку проекта Unity для рабочего стола .

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

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

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

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

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

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

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

Firebase Unity SDK поддерживает следующие продукты Firebase для iOS и Android :

Продукт Firebase Пакет единства
AdMob Распространяется отдельно в составе плагина AdMob Unity.
Аналитика FirebaseAnalytics.unitypackage
Аутентификация FirebaseAuth.unitypackage
Облако Firestore 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
Облако Firestore FirebaseFirestore.unitypackage
Облачное хранилище FirebaseStorage.unitypackage
База данных реального времени FirebaseDatabase.unitypackage
Удаленная конфигурация FirebaseRemoteConfig.unitypackage

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

Следующие шаги