將 Firebase 新增至您的 Unity 專案

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

為了展示將 Firebase 插入 Unity 專案有多麼簡單，我們製作了一款範例遊戲 MechaHamster。如要嘗試在遊戲中加入 Firebase，請使用 GitHub 上的入門版。如需完整版本，請前往 應用程式商店 或 Google Play Store。

MechaHamster (GitHub)

MechaHamster (應用程式商店)

MechaHamster (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 專案前，請先建立要連結至該 Unity 專案的 Firebase 專案。如要進一步瞭解 Firebase 專案，請參閱「瞭解 Firebase 專案」一文。

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

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

  1. 前往 Firebase 控制台。

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

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

  3. 選取要註冊的 Unity 專案建構目標，也可以同時選取兩個目標。

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

    • iOS：在「iOS bundle ID 」欄位中，輸入 Unity 專案的 iOS ID。

    • Android：在「 Android package name」(Android 套件名稱) 欄位中，輸入 Unity 專案的 Android ID。
      「套件名稱」和「應用程式 ID」這兩個詞通常可以互換使用。

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

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

步驟 3：新增 Firebase 設定檔

  1. 在 Firebase 控制台設定工作流程中，取得平台專屬的 Firebase 設定檔。

    • iOS：按一下「下載 GoogleService-Info.plist」。

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

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

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

步驟 4：新增 Firebase Unity SDK

  1. 在 Firebase 控制台中，按一下「Download Firebase Unity SDK」(下載 Firebase Unity SDK)，然後將 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 控制台，在設定工作流程中按一下「Next」(下一步)。

步驟 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 產品 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 包含部分產品的電腦工作流程支援，可在 Unity 編輯器和 Windows、macOS 和 Linux 的獨立電腦版本中使用 Firebase 的特定部分。

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

後續步驟