將 Firebase 新增至您的 Unity 專案

使用我們的 Firebase Unity SDK 強化 Unity 遊戲。

為展示將 Firebase 整合到 Unity 專案的簡單程度，我們製作了 範例遊戲 MechaHamster如果您想嘗試將 Firebase 新增至遊戲，請使用 GitHub 上的入門版本。如需完整版，請前往 App Store 或 Google Play Store 查看。

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (Play 商店)


如要進一步瞭解如何透過 Firebase 提升遊戲效能，請前往 Firebase 遊戲專頁。

是否已將 Firebase 新增至 Unity 專案？請確認您使用的是最新版的 Firebase Unity SDK。

事前準備

  • 安裝 Unity 2021 LTS 以上版本。我們已淘汰 Unity 2020 的支援服務，因此在下一個主要版本後，我們將不再積極提供支援。較舊版本也可能相容，但不會積極支援。

  • (僅限 Apple 平台) 安裝以下項目：

    • Xcode 13.3.1 以上版本
    • CocoaPods 1.12.0 以上版本

  • 請確認您的 Unity 專案符合下列規定：

    • iOS 裝置：指定 iOS 13 以上版本
    • 適用於 tvOS：指定 tvOS 13 以上版本
    • Android - 指定 API 級別 21 (Lollipop) 以上版本

  • 設定實體裝置或使用模擬器執行應用程式。

    • Apple 平台：設定實體裝置或使用 iOS 或 tvOS 模擬器。

    • Android 裝置： 模擬器必須使用 模擬器映像檔。

如果您還沒有 Unity 專案，只想試用 Firebase 產品，您可以下載其中一個快速入門導覽課程範例。

步驟 1：建立 Firebase 專案

您必須先建立 Firebase 專案，才能將 Firebase 新增至 Unity 專案。前往 如要進一步瞭解 Firebase 專案，請參閱這篇文章 Firebase 專案。

步驟 2：向 Firebase 註冊應用程式

您可以註冊一或多個應用程式或遊戲，以便連結至 Firebase 專案。

  1. 前往 Firebase 控制台。

  2. 按一下專案總覽頁面中央的「Unity」圖示 ()。 啟動設定工作流程

    如果您已將應用程式新增至 Firebase 專案，請按一下「Add app」，顯示平台選項。

  3. 選取要註冊的 Unity 專案版本目標，甚至可以選取現在同時註冊兩個目標。

  4. 輸入 Unity 專案的平台專屬 ID。

    • iOS：在 iOS 軟體包 ID ] 欄位。

    • Android：在網站的 Android 套件 name (名稱) 欄位輸入新的名稱。
      經常使用「套件名稱」和「應用程式 ID」這兩個字詞 兩地間的關聯

  5. (選用) 輸入 Unity 專案的平台專屬暱稱。
    這些暱稱是內部方便使用的 ID，只有您在 Firebase 控制台中才能看到。

  6. 按一下 [Register app] (註冊應用程式)。

步驟 3：新增 Firebase 設定檔

  1. 在 Firebase 主控台設定工作流程中取得特定平台的 Firebase 設定檔。

    • iOS 裝置 — 點選「Download GoogleService-Info.plist」。

    • Android 版：按一下「Download google-services.json」。

  2. 開啟 Unity 專案的「Project」視窗，然後移動設定 個檔案放入 Assets 資料夾。

  3. 返回 Firebase 控制台，在設定工作流程中點選「下一步」。

步驟 4：新增 Firebase Unity SDK

  1. 在 Firebase 控制台中，依序按一下「Download Firebase Unity SDK」和解壓縮 下載 SDK

    • 您隨時可以重新下載 Firebase Unity SDK。

    • Firebase Unity SDK 不限於特定平台。

  2. 在您開啟的 Unity 專案中，依序前往「Assets」>「Import Package」>「Custom Package」。

  3. 在已解壓縮的 SDK 中，選取系統支援的 Firebase 裝置 要使用的產品

    已啟用 Analytics

    • 新增 Google Analytics 的 Firebase 套件： 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 for Android 需要 Google Play services，您必須先更新至最新版本，才能使用 SDK。

將下列 using 陳述式和初始化程式碼加到 應用程式。您可以檢查 Google Play services，並視需要更新 Firebase Unity 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 疑難排解與常見問題。

設定電腦工作流程 (Beta 版)

建立遊戲時，透過 先在 Unity 編輯器和電腦平台上，在行動裝置上部署及測試 還有的裝置也在開發階段為支援這項工作流程，我們提供 可執行的 Firebase Unity SDK 子集 Windows、macOS、Linux 和 Unity 編輯器中。

  1. 按照 適用於行動平台 (從 向 Firebase 註冊應用程式)。

  2. 在 Unity IDE 中執行 Unity 專案，或選取建構適用於電腦的 Unity 專案。

  3. (選用) 在編輯模式中執行 Unity 專案。

    Firebase Unity SDK 也可以在 Unity 的編輯模式中執行，讓您在編輯器外掛程式中使用。

    1. 建立編輯器使用的 FirebaseApp 時，請勿使用預設例項。

    2. 請改為為 FirebaseApp.Create() 呼叫提供不重複的名稱。

      請務必注意，避免所用執行個體之間的選項發生衝突 以及 Unity 專案使用的執行個體

系統支援的 Firebase 產品

如要進一步瞭解 Unity Firebase 程式庫，請參閱 參考說明文件。

適用於行動裝置的 Firebase 程式庫

Firebase Unity SDK 支援下列 Firebase 產品 Apple 和 Android：

Firebase 產品 Unity 套件
AdMob 在 AdMob Unity 外掛程式中個別分發
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
Dynamic Links FirebaseDynamicLinks.unitypackage
(建議) FirebaseAnalytics.unitypackage
Realtime Database FirebaseDatabase.unitypackage
Remote Config FirebaseRemoteConfig.unitypackage
(建議) FirebaseAnalytics.unitypackage

電腦版可用的 Firebase 程式庫

Firebase Unity SDK 包含電腦工作流程支援 也方便在部分產品中使用 Firebase 的特定部分 Unity 編輯器和獨立桌面版本，適用於 Windows、macOS 和 Linux。

Firebase 產品 (電腦版) Unity 套件
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 上進行建構。 因此，您不需要條件式編譯程式碼即可指定電腦。

後續步驟