將 Firebase 新增至您的 Unity 專案

使用我們的 Firebase Unity SDK，即可提升 Unity 遊戲的運作效能。

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

MechaHamster (GitHub)

MechaHamster (應用程式商店)

MechaHamster (Play 商店)


如要進一步瞭解如何透過 Firebase 強化遊戲，請參閱我們的 Firebase 遊戲頁面。

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

先備知識

  • 安裝 Unity 2019.1 以上版本。較舊版本也可能相容，但系統將不會主動提供支援。Unity 2019.1 的支援視為已淘汰，下一個主要版本之後將不再主動提供支援。

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

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

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

    • iOS - 指定 iOS 11 以上版本
    • 針對 tvOS：指定 tvOS 12 以上版本
    • Android - 指定 API 級別 19 (KitKat) 以上版本

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

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

    • Android：模擬器必須搭配 Google Play 使用模擬器映像檔。

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

步驟 1：建立 Firebase 專案

您必須先建立要連結至 Unity 專案的 Firebase 專案，才能將 Firebase 新增到 Unity 專案。如要進一步瞭解 Firebase 專案，請參閱「瞭解 Firebase 專案」。

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

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

  1. 前往 Firebase 主控台。

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

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

  3. 選取您要註冊的 Unity 專案的建構目標，或選擇立即註冊兩個目標。

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

    • iOS：在「iOS 軟體包 ID」欄位中輸入 Unity 專案的 iOS 編號。

    • Android：在「Android package name」(Android 套件名稱) 欄位中輸入 Unity 專案的 Android ID。
      套件名稱和應用程式 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 驗證和 Firebase 即時資料庫，可以執行以下動作：
      FirebaseAuth.unitypackage 和 FirebaseDatabase.unitypackage

    未啟用 Analytics (分析)

    針對您要在應用程式中使用的 Firebase 產品新增套件。例如，如果想使用 Firebase 驗證和 Firebase 即時資料庫，可以執行以下動作：
    FirebaseAuth.unitypackage 和 FirebaseDatabase.unitypackage

  4. 在「Import Unity Package」視窗中，按一下「Import」。

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

步驟 5：確認 Google Play 服務版本規定

Android 版 Firebase Unity SDK 需要 Google Play 服務，Google Play 服務必須先更新才能使用 SDK。

在應用程式啟動時，加入下列 using 陳述式和初始化程式碼。在呼叫 SDK 中的任何其他方法之前，您可以檢查 Google Play 服務，並視需要更新為 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. 按照行動平台的操作說明，設定電腦平台 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 外掛程式中另外發布
數據分析 FirebaseAnalytics.unitypackage
App Check FirebaseAppCheck.unitypackage
身分驗證 FirebaseAuth.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Cloud Functions FirebaseFunctions.unitypackage
雲端通訊 FirebaseMessaging.unitypackage
(建議) FirebaseAnalytics.unitypackage
Cloud Storage FirebaseStorage.unitypackage
Crashlytics FirebaseCrashlytics.unitypackage
(建議) FirebaseAnalytics.unitypackage
動態連結 FirebaseDynamicLinks.unitypackage
(建議) FirebaseAnalytics.unitypackage
即時資料庫 FirebaseDatabase.unitypackage
遠端設定 FirebaseRemoteConfig.unitypackage
(建議) FirebaseAnalytics.unitypackage

電腦版可用的 Firebase 程式庫

Firebase Unity SDK 針對部分產品提供電腦版工作流程支援，能在 Unity 編輯器中使用 Firebase 的特定部分，並在 Windows、macOS 和 Linux 的獨立電腦上使用。

Firebase 產品 (電腦版) Unity 套件
App Check FirebaseAppCheck.unitypackage
身分驗證 FirebaseAuth.unitypackage
Cloud Functions FirebaseFunctions.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Cloud Storage FirebaseStorage.unitypackage
即時資料庫 FirebaseDatabase.unitypackage
遠端設定 FirebaseRemoteConfig.unitypackage

Firebase 提供剩餘的桌面程式庫做為虛設常式 (非功能性) 實作，方便您建構 Windows、macOS 和 Linux。因此，您不需要條件式編譯程式碼即可指定電腦。

後續步驟