將 Firebase 新增至您的 Unity 專案

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

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

MechaHamster (GitHub)

MechaHamster (應用程式商店)

MechaHamster (Play 商店)

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

瞭解哪些做法 Firebase 產品：Firebase Unity SDK 支援。

是否已將 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 模擬器。

    請問要使用 Cloud Messaging 嗎？

    如要使用 iOS 或 tvOS 上的 Cloud Messaging，請先完成下列必要條件：

    • 設定實體裝置。
    • 為您的Apple Developer 帳戶取得 Apple 推播通知驗證金鑰。
    • 在 XCode 中依序前往「App」>「Capabilities」，啟用推播通知。

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

• 使用 Google 帳戶登入 Firebase。

如果您還沒有 Unity 專案，但想試用 Firebase 產品，可以下載我們的快速入門範例。

步驟 1：建立 Firebase 專案

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

建立 Firebase 專案

1. 在 Firebase 控制台中，按一下「新增專案」。

   • 如要將 Firebase 資源新增至現有的 Google Cloud 專案，請輸入專案的名稱 或從下拉式選單中選取專案

   • 如要建立新專案，請輸入所需的專案名稱。您也可以視需要編輯專案名稱下方顯示的專案 ID。

     Firebase 會為您的 Firebase 專案產生專屬 ID 建立起關係如果您想編輯這個專案 ID，請務必立即執行，因為 Firebase 為專案配置資源後，就無法再變更。請參閱「瞭解 Firebase 專案」，瞭解 Firebase 如何使用專案 ID。

2. 系統提示時，請詳閱並接受 Firebase 條款。

3. 按一下「繼續」。

4. (選用) 為專案設定 Google Analytics，進而 ，使用下列任一 Firebase 產品來獲得最佳體驗：

   Firebase Crashlytics Firebase Cloud Messaging

   Firebase In-App Messaging Firebase Remote Config

   Remote Config 個人化 Firebase A/B Testing

   選取現有項目 Google Analytics 帳戶 或建立新帳戶

   如果您建立新帳戶，請選取Analytics報表位置，然後接受專案的資料共用設定和 Google Analytics 條款。

   您之後隨時可以前往以下位置設定 Google Analytics： 整合 專案設定的分頁

5. 按一下「建立專案」。如果使用「新增 Firebase」， 現有的 Google Cloud 專案)。

Firebase 會自動為你的 Firebase 專案佈建資源。程序完成後，您會前往 Firebase 主控台的 Firebase 專案總覽頁面。

步驟 2：將應用程式註冊至 Firebase

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

如果您要同時在 iOS 和 Android 裝置上發布遊戲，請同時註冊 使用同一個 Firebase 專案時，可為 Unity 專案建立目標。 如果您具有多個建構變數，且兩者搭配不同的 iOS 套件 ID 或 Android 應用程式 ID，您必須使用已定義的 存取同一項 Firebase 專案

1. 前往 Firebase 控制台。

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

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

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

   注意：如果您現在只註冊 Unity 專案的一個版本目標，之後隨時都可以返回設定工作流程，註冊其他版本目標。

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

   • 適用於 iOS：在 iOS 軟體包 ID 欄位中輸入 Unity 專案的 iOS ID。

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

   如何找到 Unity 專案的 ID？

   在 Unity IDE 中開啟 Unity 專案，然後前往設定頁面 」一節：

   • iOS 版：依序前往「Build Settings」>「iOS」。

   • Android 使用者 - 前往「Android」>播放器設定 > 其他設定。

   Unity 專案的 ID 是「Bundle Identifier」值 (ID 範例：com.yourcompany.yourproject)。

   請務必輸入專案實際使用的 ID。ID 值須區分大小寫，且不得 這些 Firebase 應用程式向您的 Firebase 專案。

5. (選用) 輸入 Unity 專案的平台專屬暱稱。
   這些暱稱為內部方便識別身分，且只有公開顯示 是在 Firebase 控制台中確定。

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

步驟 3：新增 Firebase 設定檔

1. 取得特定平台的 Firebase 設定檔，方法是前往 Firebase 控制台設定工作流程。

   如果您同時註冊 iOS 和 您必須下載 Unity 專案的建構目標 設定檔，

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

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

   您需要瞭解這個設定檔的哪些資訊？

   • Firebase 設定檔包含專案的非祕密專屬 ID。如要進一步瞭解這個設定檔，請參閱「瞭解 Firebase 專案」。

   • 您隨時可以重新下載 Firebase 設定檔。

   • 請確認設定檔名稱未附加額外的字元，例如 (2)。

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

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

步驟 4：新增 Firebase Unity SDK

注意： Unity SDK 版本。針對特定用途，Firebase 提供其他設定流程。

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

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

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

2. 在開啟的 Unity 專案中，前往 素材資源 >「Import 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 控制台，在設定工作流程中點選「下一步」。

重要事項：使用 Firebase Unity SDK for iOS 時，請勿停用方法混合。SDK 必須使用 Swizz；缺少關鍵 Firebase 功能 (例如 FCM 權杖處理) 無法正常運作。

步驟 5：確認 Google Play 服務版本需求

Firebase Unity SDK for Android 規定 Google Play services，其中必須 但 SDK 必須是最新版本 才能使用 SDK

將下列 using 陳述式和初始化程式碼加到 應用程式。您可以先檢查 Google Play services，並視需要將其更新為 Firebase Unity SDK 所需的版本，再呼叫 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 版)

注意： Firebase Unity SDK 電腦版支援目前仍為 Beta 版功能。這項功能僅適用於遊戲開發期間的工作流程，不適用於公開發布的程式碼。

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

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

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

   注意：Firebase 會找出您新增至 Unity 專案的行動 Firebase 設定檔 (GoogleService-Info.plist 或 google-services.json)。接著，系統會自動透過行動裝置設定檔 Firebase 產生電腦版 Firebase 設定檔 (google-services-desktop.json)。 這個電腦設定檔含有您輸入的 Unity 專案 ID Firebase 控制台設定工作流程。這個檔案會將您的應用程式與 您的 Firebase 專案。
   
   如果編輯器找不到 desktop 設定檔，請確認 StreamingAssets 目錄是否存在，以及 desktop 設定檔是否位於其中。

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

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

   1. 建立編輯器使用的 FirebaseApp 時，請不要使用 預設執行個體。

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

      這點很重要，可避免 Unity IDE 使用的例項與 Unity 專案使用的例項之間的選項發生衝突。

系統支援的 Firebase 產品

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

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

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

注意： 以 Apple 平台來說，每個 Firebase 程式庫可能僅支援 Apple OS 平台 (iOS、tvOS 等)。如要瞭解各個程式庫支援哪些平台，請參閱「進一步瞭解 Unity 和 Firebase」一文。

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 SDK 的電腦版支援功能為 Beta 版功能。這項功能僅適用於遊戲開發期間的工作流程，不適用於公開發布的程式碼。

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 應用程式。因此，您不需要依條件編譯程式碼，以便指定電腦。

後續步驟

• 探索 Firebase 應用程式範例。

• 準備發布應用程式：

  • 設定預算 快訊 。Google Cloud.
  • 監控用量與計費 資訊主頁 前往 Firebase 控制台查看專案的整體概況 以及跨多項 Firebase 服務的用量
  • 詳閱 Firebase 上市檢查清單。

• 使用 Firebase 和 Unity 專案時遇到問題嗎？ 請參閱 Unity 疑難排解與常見問題。