Menyertakan scene Addressables

Halaman ini menjelaskan cara mengonfigurasi Android Performance Tuner untuk menyertakan scene Addressables di Unity.

Addressables memungkinkan developer memuat konten secara dinamis saat runtime. Ini dapat mencakup scene yang tidak ada di setelan build Unity saat .apk di-build. Sebelum Android Performance Tuner 1.5.1, scene tersebut tidak dikenali oleh Android Performance Tuner dan tidak dapat diperiksa di Konsol Play.

Persyaratan

Dukungan untuk scene Addressables memiliki persyaratan berikut:

• Android Performance Tuner 1.5.1 atau yang lebih baru
• Unity 2019.3 atau yang lebih baru
• Paket Addressables 1.19.4 atau yang lebih baru

Menambahkan scene Addressables

Agar Android Performance Tuner mengenali scene Addressables, lakukan langkah berikut:

1. Jika sudah siap untuk menguji aplikasi, buka Window > Android Performance Tuner > Setup, lalu buka tab Addressables Settings.

   Gambar 1. Jendela Addressables Settings.

2. Klik tombol Update Addressables Scenes.

Secara default, semua scene yang terdapat dalam AddressableAssetSettingsDefaultObject akan disertakan dalam Android Performance Tuner. Jendela sekarang menampilkan daftar semua scene yang ditemukan bersama nilainya seperti yang disimpan dalam file proto.

Gambar 2. Scene Addressables yang dicantumkan oleh Android Performance Tuner.

Untuk mengubah Addressables Settings Object tempat scene diambil:

1. Buka folder Assets/AndroidPerformanceTuner_gen/Runtime/Resources dan buka objek scriptable SetupConfig di Inspector.

2. Masukkan jalur ke Settings Object kustom di kolom Addressables Settings Object Path, termasuk nama file.

Sebaiknya update scene Addressables jika tata letak scene sudah semifinal untuk menghindari masalah kompatibilitas mundur.

Android Performance Tuner hanya mengumpulkan data untuk scene yang ada dalam file .apk yang diupload ke Konsol Play.

Mereset scene Addressables

Anda dapat mereset scene Addressables dengan mengklik Reset Addressables Scenes di tab Addressables Settings. Namun, hal ini akan mengganggu kompatibilitas dengan versi aplikasi yang saat ini dipublikasikan.

Mengupdate objek SetupConfig secara dinamis di aplikasi tanpa memublikasikan rilis baru akan menyebabkan error di Konsol Play karena hubungan scene-nilai tidak akan dipertahankan.

Menetapkan scene Addressables di anotasi

Jika Anda menggunakan anotasi default, Android Performance Tuner akan otomatis menetapkan scene yang benar. Jika Anda menggunakan anotasi kustom, panggil ConvertAddressableScenePathToAPTSceneIndex():

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