使用我們的 Firebase Unity SDK,即可提升 Unity 遊戲的運作效能。
為展示將 Firebase 整合到 Unity 專案的難易度,我們製作了 範例遊戲 MechaHamster如果想嘗試將 Firebase 新增至遊戲 GitHub 上的入門版本。如果您需要完整的版本 請查看 App Store 或 Google 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 級別 19 (KitKat) 以上版本
設定實體裝置或使用模擬器執行應用程式。
Apple 平台:設定實體裝置或使用 iOS 或 tvOS 模擬工具
Android 裝置: 模擬器必須使用 模擬器映像檔。
- 使用 Google 帳戶登入 Firebase 讓他們使用服務帳戶
如果您還沒有 Unity 專案,只想試用 Firebase 產品,您可以下載其中一個快速入門導覽課程範例。
步驟 1:建立 Firebase 專案
如要將 Firebase 新增到 Unity 專案,請先建立 Firebase 連線至 Unity 專案前往 如要進一步瞭解 Firebase 專案,請參閱這篇文章 Firebase 專案。
步驟 2:向 Firebase 註冊應用程式
您可以註冊一或多個應用程式或遊戲來與 Firebase 連結 專案。
前往 Firebase 主控台。
按一下專案總覽頁面中央的「Unity」圖示 (
)。 啟動設定工作流程如果您已在 Firebase 專案中加入應用程式,請按一下「新增應用程式」 顯示平台選項
選取您要註冊的 Unity 專案的建構目標。 或者,你也可以選擇立即登錄兩個目標
輸入 Unity 專案的平台專屬 ID。
iOS:在 iOS 軟體包 ID ] 欄位。
Android:在網站的 Android 套件 name (名稱) 欄位輸入新的名稱。
經常使用「套件名稱」和「應用程式 ID」這兩個字詞 兩地間的關聯
(選用) 輸入 Unity 專案的平台專屬暱稱。
這些暱稱為內部方便識別身分,且只有公開顯示 。按一下 [Register app] (註冊應用程式)。
步驟 3:新增 Firebase 設定檔
取得特定平台的 Firebase 設定檔,方法是前往 Firebase 控制台設定工作流程。
iOS 裝置 — 點選「Download GoogleService-Info.plist」。
Android 裝置 - 點選「Download google-services.json」。
開啟 Unity 專案的「Project」視窗,然後移動設定 檔案複製到
Assets
資料夾中。返回 Firebase 控制台,在設定工作流程中點選「下一步」。
步驟 4:新增 Firebase Unity SDK
在 Firebase 控制台中,按一下「Download Firebase Unity SDK」,然後解壓縮 下載 SDK
您隨時可以再次下載 Firebase Unity SDK。
Firebase Unity SDK 並非平台專用。
在開啟的 Unity 專案中,前往 素材資源 >「Import Package」>自訂套件。
在已解壓縮的 SDK 中,選取系統支援的 Firebase 裝置 要使用的產品
Analytics 已啟用
- 加入 Google Analytics 專用 Firebase 套件:
FirebaseAnalytics.unitypackage
- 新增要用於其他 Firebase 產品的套件
舉例來說,如要使用 Firebase 驗證
Firebase 即時資料庫:
「FirebaseAuth.unitypackage
」和FirebaseDatabase.unitypackage
未啟用 Analytics
針對您要在應用程式中使用的 Firebase 產品新增套件。 舉例來說,如要使用 Firebase 驗證和 Firebase 即時資料庫:
「FirebaseAuth.unitypackage
」和FirebaseDatabase.unitypackage
- 加入 Google Analytics 專用 Firebase 套件:
在「Import Unity Package」視窗中,按一下「Import」。
返回 Firebase 控制台,在設定工作流程中點選「下一步」。
步驟 5:確認 Google Play 服務版本規定
Firebase Unity SDK for Android 規定 Google Play 服務 (必須 但 SDK 必須是最新版本 才能使用 SDK
將下列 using
陳述式和初始化程式碼加到
應用程式。您可以檢查 Google Play 服務,並視需要將 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 編輯器中。
按照 適用於行動平台 (從 向 Firebase 註冊應用程式)。
在 Unity IDE 中執行 Unity 專案,或選擇建構 Unity desktop專案。
(選用) 在編輯模式中執行 Unity 專案。
您也可以在 Unity 的編輯模式中執行 Firebase Unity SDK,以便使用 。
建立編輯器使用的
FirebaseApp
時,請不要使用 預設執行個體。請改為為
FirebaseApp.Create()
呼叫提供專屬名稱。請務必注意,避免所用執行個體之間的選項發生衝突 以及 Unity 專案使用的執行個體
系統支援的 Firebase 產品
如要進一步瞭解 Unity Firebase 程式庫,請參閱 參考說明文件。
適用於行動裝置的 Firebase 程式庫
Firebase Unity SDK 支援下列 Firebase 產品: Apple 和 Android:
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 提供電腦工作流程支援 也方便在部分產品中使用 Firebase 的特定部分 Unity 編輯器和獨立桌面版本,適用於 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 上進行建構。 因此,您不需要條件式編譯程式碼即可指定電腦。
後續步驟
探索 Firebase 應用程式範例。
準備推出應用程式:
- 設定預算 快訊 也可前往 Google Cloud 控制台
- 監控用量與計費 資訊主頁 在 Firebase 控制台中查看專案的整體概況 以及跨多項 Firebase 服務的用量
- 查看 Firebase 發布檢查清單。
使用 Firebase 和 Unity 專案時遇到問題嗎? 請參閱 Unity 疑難排解與常見問題。