使用我們的 Firebase Unity SDK 增強您的Unity遊戲。
為了展示將 Firebase 插入 Unity 專案是多麼容易,我們製作了一個範例遊戲 MechaHamster。如果您想嘗試將 Firebase 新增到遊戲中,請使用GitHub上的入門版本。如果您想要完整版本,請查看App Store或Google Play 商店中的版本。
請造訪我們的Firebase 遊戲頁面,以了解有關使用 Firebase 增強遊戲效能的更多資訊。
已將 Firebase 新增到您的 Unity 專案中?確保您使用的是最新版本的Firebase Unity SDK 。
先決條件
安裝 Unity 2019.1 或更高版本。早期版本也可能相容,但不會得到積極支援。對 Unity 2019.1 的支援被視為已棄用,並且在下一個主要版本後將不再主動支援。
(僅限 Apple 平台)安裝以下內容:
- Xcode 13.3.1 或更高版本
- CocoaPods 1.10.0 或更高版本
確保您的 Unity 專案符合以下要求:
- 對於 iOS — 面向 iOS 11 或更高版本
- 對於 tvOS - 目標為 tvOS 12 或更高版本
- 對於 Android — 目標 API 等級 19 (KitKat) 或更高版本
設定實體設備或使用模擬器來運行您的應用程式。
對於 Apple 平台— 設定實體裝置或使用 iOS 或 tvOS 模擬器。
對於 iOS 或 tvOS 上的雲端訊息傳遞,以下是先決條件:
- 設定物理設備。
- 為您的Apple 開發者帳戶取得 Apple 推播通知驗證金鑰。
- 在App > Capability下的 XCode 中啟用推播通知。
對於 Android —模擬器必須使用 Google Play 模擬器映像。
- 使用您的 Google 帳戶登入 Firebase 。
如果您還沒有 Unity 專案而只想嘗試 Firebase 產品,則可以下載我們的快速入門範例之一。
第 1 步:建立 Firebase 項目
在將 Firebase 新增至 Unity 專案之前,您需要建立一個 Firebase 專案以連接到您的 Unity 專案。請造訪了解 Firebase 專案以了解有關 Firebase 專案的更多資訊。
步驟 2 : 向 Firebase 註冊您的應用
您可以註冊一個或多個應用程式或遊戲來與您的 Firebase 專案連線。
轉到Firebase 控制台。
在專案概述頁面的中心,按一下Unity圖示 (
) 以啟動設定工作流程。如果您已將應用程式新增至 Firebase 項目,請按一下新增應用程式以顯示平台選項。
選擇您想要註冊的 Unity 專案的建置目標,或者您甚至可以選擇現在同時註冊兩個目標。
輸入 Unity 專案的平台特定 ID。
對於 iOS - 在iOS 捆綁包 ID欄位中輸入 Unity 專案的 iOS ID。
對於 Android — 在Android 套件名稱欄位中輸入 Unity 專案的 Android ID。
術語包名稱和應用程式 ID通常可以互換使用。
在 Unity IDE 中開啟 Unity 項目,然後導航到每個平台的設定部分:
對於 iOS — 導覽至「建置設定」>「iOS」 。
對於 Android — 導覽至Android > 播放器設定 > 其他設定。
您的 Unity 專案的 ID 是捆綁包識別碼值(範例 ID:
com.yourcompany.yourproject
)。(可選)輸入 Unity 項目的平台特定暱稱。
這些暱稱是內部方便標識符,僅您在 Firebase 控制台中可見。點擊註冊應用程式。
第 3 步:新增 Firebase 設定文件
在 Firebase 控制台設定工作流程中取得特定於平台的 Firebase 設定檔。
對於 iOS — 按一下下載 GoogleService-Info.plist 。
對於 Android — 按一下下載 google-services.json 。
Firebase 設定檔包含您的專案的唯一但非秘密的識別碼。要了解有關此設定檔的更多信息,請訪問了解 Firebase 專案。
您可以隨時再次下載Firebase 設定檔。
確保設定檔名未附加其他字符,例如
(2)
。
開啟 Unity 專案的專案窗口,然後將設定檔移至
Assets
資料夾。返回 Firebase 控制台,在設定工作流程中,按一下下一步。
第 4 步:新增 Firebase Unity SDK
在 Firebase 控制台中,按一下「下載 Firebase Unity SDK」 ,然後將 SDK 解壓縮到方便的位置。
您可以隨時再次下載Firebase Unity SDK 。
Firebase Unity SDK 不特定於平台。
在開啟的 Unity 專案中,導覽至Assets > Import Package > Custom Package 。
從解壓縮的 SDK 中,選擇您想要在應用中使用的受支援的 Firebase 產品。
啟用分析
- 新增適用於 Google Analytics 的 Firebase 套件:
FirebaseAnalytics.unitypackage
- 新增您想要在應用程式中使用的任何其他 Firebase 產品的軟體包。例如,要使用 Firebase 驗證和 Firebase 即時資料庫:
FirebaseAuth.unitypackage
和FirebaseDatabase.unitypackage
未啟用分析
新增您想要在應用程式中使用的 Firebase 產品的軟體包。例如,要使用 Firebase 驗證和 Firebase 即時資料庫:
FirebaseAuth.unitypackage
和FirebaseDatabase.unitypackage
- 新增適用於 Google Analytics 的 Firebase 套件:
在「匯入 Unity 套件」視窗中,按一下「匯入」 。
返回 Firebase 控制台,在設定工作流程中,按一下下一步。
第 5 步:確認 Google Play 服務版本要求
適用於 Android 的 Firebase Unity SDK 需要Google Play 服務,該服務必須是最新的才能使用 SDK。
在應用程式的開頭添加以下程式碼。在呼叫 SDK 中的任何其他方法之前,您可以檢查並選擇將 Google Play 服務更新至 Firebase Unity SDK 所需的版本。
Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWith(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 故障排除和常見問題。
設定桌面工作流程(測試版)
當您創建遊戲時,首先在 Unity 編輯器和桌面平台上測試遊戲通常要容易得多,然後在開發過程中在行動裝置上進行部署和測試。為了支援此工作流程,我們提供了Firebase Unity SDK 的子集,它可以在 Windows、macOS、Linux 上以及在 Unity 編輯器中運行。
按照與行動平台相同的說明設定桌面平台 Unity 專案(從上面的「向 Firebase 註冊您的應用程式」步驟開始)。
在 Unity IDE 中執行您的 Unity 專案或選擇建置桌面版Unity 專案。
(可選)在編輯模式下執行 Unity 專案。
Firebase Unity SDK 還可以在 Unity 的編輯模式下運行,從而允許在編輯器插件中使用。
當您建立編輯器使用的
FirebaseApp
時,請勿使用預設實例。相反,請為
FirebaseApp.Create()
呼叫提供唯一的名稱。這對於避免 Unity IDE 使用的實例與 Unity 專案所使用的實例之間的選項衝突非常重要。
支援的 Firebase 產品
在參考文件中了解有關 Unity Firebase 庫的更多資訊。
適用於行動裝置的可用 Firebase 庫
Firebase Unity SDK 支援Apple和Android上的以下 Firebase 產品:
Firebase 產品 | 統一包 |
---|---|
AdMob | 在 AdMob Unity 外掛程式中單獨分發 |
分析 | FirebaseAnalytics.unitypackage |
應用程式檢查 | FirebaseAppCheck.unitypackage |
驗證 | FirebaseAuth.unitypackage |
雲端Firestore | FirebaseFirestore.unitypackage |
雲端功能 | FirebaseFunctions.unitypackage |
雲端訊息傳遞 | FirebaseMessaging.unitypackage (建議) FirebaseAnalytics.unitypackage |
雲端儲存 | FirebaseStorage.unitypackage |
崩潰解決方案 | FirebaseCrashlytics.unitypackage (建議) FirebaseAnalytics.unitypackage |
動態連結 | FirebaseDynamicLinks.unitypackage (建議) FirebaseAnalytics.unitypackage |
即時資料庫 | FirebaseDatabase.unitypackage |
遠端配置 | FirebaseRemoteConfig.unitypackage (建議) FirebaseAnalytics.unitypackage |
適用於桌面的可用 Firebase 庫
Firebase Unity SDK 包括對部分產品的桌面工作流程支持,使 Firebase 的某些部分能夠在 Unity 編輯器以及 Windows、macOS 和 Linux 上的獨立桌面構建中使用。
Firebase 產品(桌面) | 統一包 |
---|---|
應用程式檢查 | FirebaseAppCheck.unitypackage |
驗證 | FirebaseAuth.unitypackage |
雲端功能 | FirebaseFunctions.unitypackage |
雲端Firestore | FirebaseFirestore.unitypackage |
雲端儲存 | FirebaseStorage.unitypackage |
即時資料庫 | FirebaseDatabase.unitypackage |
遠端配置 | FirebaseRemoteConfig.unitypackage |
Firebase 提供剩餘的桌面庫作為存根(非功能性)實現,以便在針對 Windows、macOS 和 Linux 進行建置時提供方便。因此,您不需要有條件地編譯程式碼以面向桌面。
下一步
準備啟動您的應用程式:
- 在 Google Cloud Console 中為您的專案設定預算提醒。
- 監控 Firebase 控制台中的使用情況和計費資訊中心,全面了解專案在多個 Firebase 服務中的使用情況。
- 查看Firebase 啟動清單。
Firebase 和您的 Unity 專案遇到問題嗎?請造訪Unity 故障排除和常見問題。