將 Firebase 新增至您的 Unity 專案

步驟 2：透過 Firebase 註冊應用程式

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

1. 前往 Firebase 控制台。

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

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

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

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

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

   • 適用於 Android：在「Android 套件名稱」欄位中輸入 Unity 專案的 Android ID。
     「套件名稱」和「應用程式 ID」這兩個詞彙經常互通使用。

   如何找到 Unity 專案的 ID？

   在 Unity IDE 中開啟 Unity 專案，然後前往各個平台的設定部分：

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

   • Android 裝置：依序前往「Android」>「Player Settings」>「Other Settings」。

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

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

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

步驟 3：新增 Firebase 設定檔

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

   • 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

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。瞭解哪些產品有此依附元件。Google Play services 必須更新至最新版本，才能使用這些產品。

請在應用程式開頭加入下列 using 陳述式和初始化程式碼。您可以在呼叫 SDK 中的任何其他方法之前，檢查 Google Play services 是否為必要版本，並視需要將其更新為必要版本。

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. 如要設定桌面平台的 Unity 專案，請按照行動平台的操作說明操作 (從上述的「透過 Firebase 註冊應用程式」步驟開始)。

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

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

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

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

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

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

系統支援的 Firebase 產品

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

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

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

適用於電腦的 Firebase 程式庫

Firebase Unity SDK 包含部分產品的電腦版工作流程支援功能，可在 Windows、macOS 和 Linux 的 Unity 編輯器和獨立電腦版版本中使用 Firebase 的特定部分。

Firebase 會提供其他桌面程式庫做為暫置 (非功能性) 實作，方便您建構 Windows、macOS 和 Linux 應用程式。因此，您不需要依條件編譯程式碼，以便指定電腦。

後續步驟

• 探索 Firebase 應用程式範例。

• 準備發布應用程式：

  • 在 Google Cloud 控制台中為專案設定預算快訊。
  • 請在 Firebase 控制台中監控使用量和帳單資訊主頁，全面掌握專案在多項 Firebase 服務中的用量。
  • 詳閱 Firebase 上市檢查清單。

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