包含 Addressable 情境

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

本頁面說明如何設定 Android Performance Tuner,以便在 Unity 中加入 Addressable 場景。

Addressable 可讓開發人員在執行階段動態載入內容。這包括在建構 .apk 時,Unity 版本設定中沒有的場景。在 Android Performance Tuner 1.5.1 版本推出之前,Android Performance Tuner 無法辨識這些場景,而這些場景也無法在 Play 管理中心進行檢查。

需求條件

如要為 Addressable 場景提供支援,須滿足以下條件:

  • Android Performance Tuner 1.5.1 或以上版本
  • Unity 2019.3 或以上版本
  • Addressable 套件 1.19.4 或以上版本

新增 Addressable 場景

為了讓 Android Performance Tuner 識別您的 Addressable 場景,請按照下列步驟操作:

  1. 當您準備好測試應用程式時,請依序前往「Window」>「Android Performance Tuner」>「Setup」,然後開啟「Addressables Settings」分頁標籤。

    圖 1. 「Addressables Settings」視窗。

  2. 按一下「Update Addressables Scenes」按鈕。

根據預設,AddressableAssetSettingsDefaultObject 包含的所有場景都納入 Android Performance Tuner 中。該視窗現在會顯示清單,內含所有找到的場景,以及 proto 檔案中儲存的對應值。

圖 2. Android Performance Tuner 中列出的 Addressable 場景。

如要變更收集場景的 Addressable Settings Object,請按照下列步驟操作:

  1. 前往「Assets/AndroidPerformanceTuner_gen/Runtime/Resources」資料夾,並在「Inspector」中開啟「SetupConfig」指令碼物件。

  2. 在「Addressables Settings Object Path」欄位中,輸入自訂 Settings Object 的路徑,包括檔案名稱。

建議您在場景版面配置進行到一半時更新 Addressable 場景,以免發生回溯相容性問題。

Android Performance Tuner 只會針對上傳至 Play 管理中心的 .apk 檔案中出現的場景收集資料。

重設 Addressable 場景

如要重設 Addressable 場景,請在「Addressables Settings」分頁標籤中按一下「Reset Addressables Scenes」。不過,這樣做會破壞與目前發布的應用程式版本的相容性。

如果動態更新應用程式中的 SetupConfig 物件,但未發布新版本,會導致 Play 管理中心發生錯誤,因為系統不會保留場景與值之間的關聯。

在註解中設定 Addressable 場景

如果您使用預設註解,Android Performance Tuner 會自動設定正確的場景。如要使用自訂註解,請呼叫 ConvertAddressableScenePathToAPTSceneIndex()

tuner.SetCurrentAnnotation(new Annotation
{
    Scene = (Scene) tuner.ConvertAddressableScenePathToAPTSceneIndex(scenePath),
    Difficulty = Difficulty.Medium
});