使用 Unity 入門

App Center SDK 使用模組化架構,因此您可以使用任何或所有服務。

讓我們開始著手,並設定 App Center Unity SDK 以使用 App Center 分析和損毀。 若要將 App Center 散發新增至您的應用程式,請參閱 App Center 散發的檔

1.Prerequisites

開始之前,請確定您的專案已在 Unity 2018.1 或更新版本中設定。

適用于 Unity 的 App Center SDK 支援下列平臺:

  • iOS (9.0 或更新版本)
  • Android (5.0/API 21 或更新版本)
  • UWP (組建16299或更新版本)

注意

UWP 平臺已不再支援 .NET 3.5 腳本執行階段版本和 .NET 腳本後端。

若要瞭解如何使用協同程式/回呼,而不是使用 async/await .NET 3.5 後端,請參閱檔的 Unity SDK 一節中的非同步 api

此外,適用于 Unity 的 App Center SDK 僅適用于 c #。

2. 在 App Center 入口網站中建立您的應用程式以取得應用程式秘密

如果您已在 App Center 入口網站中建立應用程式,則可以略過此步驟。

  1. 前往 appcenter.ms
  2. 註冊或登入 App Center。
  3. 按一下入口網站右上角的藍色按鈕,其會顯示 [ 加入新 的],然後從下拉式功能表中選取 [新增 應用程式 ]。
  4. 輸入應用程式的名稱和選擇性描述。
  5. 根據您的專案,選取適當的作業系統和平臺,如上所述。
  6. 按一下頁面右下角的 [ 新增應用程式 ] 按鈕。

建立應用程式之後,您可以在 app Center 入口網站的 設定 頁面上取得其 應用程式密碼。 在 設定 頁面的右上角,按一下 三個垂直點,然後選取 Copy app secret 以取得您的應用程式密碼。

3. 將 App Center SDK 新增至您的專案

3a 安裝延伸模組編輯器

App Center SDK 的整合方式是將 Unity 套件匯入您的專案中。 若要這樣做,請先安裝 App Center Unity Editor Extensions 外掛程式。 透過 Unity 功能表開啟編輯器延伸模組: Window > App Center > 編輯器延伸模組,然後選取 [安裝 App Center SDK]。

注意

在 Unity 版本 2019.1.2 f1 和更新版本中,安裝期間可能會發生錯誤(例如) Coroutine continue failure 。 這是已知的 Unity 問題,您應該忽略它。

3.1 b 安裝個別套件

或者,您可以下載並匯入每個個別的 Unity 套件。 您可以在App Center Unity SDK GitHub 頁面找到這些資訊。 下載您想要使用的最新版本套件 (s) 。 其名稱格式應為 AppCenter {Analytics/損毀/散發}-v {version}. unitypackage

3.2 b 匯入套件

開啟您的 Unity 專案,然後按兩下您所下載的套件。 快顯視窗應該會出現在包含檔案清單的 Unity 專案中。 選取 [匯 ],SDK 就會加入至您的專案。 針對您下載並計畫在專案中使用的每個套件重複此步驟。

3.3 如果您使用自動備份來避免取得裝置的不正確資訊,請遵循後續步驟:

注意

以 Android 6.0 (API 層級 23) 或更高版本為目標的應用程式會自動啟用自動備份。

注意

如果您已經有包含備份規則的自訂檔案,請切換至第三個步驟。

a. 在 [資產/外掛程式/Android/res/xml ] 資料夾中建立 appcenter_backup_rule.xml 檔案。

b. 開啟專案的 AndroidManifest.xml 檔案。 將 android:fullBackupContent 屬性加入至 <application> 元素。 它應該指向 appcenter_backup_rule.xml 資源檔。

注意

如果您還沒有自己的 AndroidManifest.xml 檔案,請在 [ 資產/外掛程式/Android ] 資料夾中建立它。 此資訊清單會與組建時建立的預設 Unity 合併。

android:fullBackupContent="@xml/appcenter_backup_rule"

c. 將下列備份規則新增至 appcenter_backup_rule.xml 檔案:

<full-backup-content xmlns:tools="http://schemas.android.com/tools">
    <exclude domain="sharedpref" path="AppCenter.xml"/>
    <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
    <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
    <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
    <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
</full-backup-content>

4. 啟用 SDK

4.1 建立空白的遊戲物件

App Center 的運作方式,就是您在遊戲推出的場景中附加至遊戲物件的元件。 流覽至此場景,並新增空白的遊戲物件。 為它提供描述性名稱,例如「App Center」。

4.2 附加 App Center 腳本

在 [ Project ] 視窗中,流覽至已加入至專案的 "AppCenter" 資料夾。 找出名為 AppCenterBehavior 的腳本,並將它拖曳至 [階層] 視窗中新 建立的遊戲 物件。

注意

您不需要將 App Center 新增至您想要使用它的每個場景。 將它新增至第一個載入的場景即已足夠。

4.3 設定 App Center 設定

按一下這個新的「App Center」物件,並將您的應用程式秘密新增至偵測 視窗中的對應欄位。 請務必同時針對您要使用的每個 App Center 服務,勾選 [使用 {service}] 方塊

App Center 腳本設定

注意

如果您的專案不支援設定中所列的三個平臺之一,請將應用程式秘密欄位保持原狀。它不會有任何作用。 如果您的專案支援 App Center 不支援的平臺,則 Api 和設定不會影響這些平臺。


很棒的是,您都可以將分析和診斷 (損毀,並在入口網站中) 資料時,SDK 會自動收集資料。

查看 App Center 分析app center 損毀的檔,以瞭解如何使用這兩項服務的更先進功能。

若要瞭解如何開始使用應用程式內更新,請閱讀 App Center 散發的檔。