Mengintegrasikan plugin

Halaman ini menjelaskan cara mendownload, mengimpor, dan mengonfigurasi plugin Unity untuk Android Performance Tuner.

Persyaratan

Untuk menggunakan plugin di game Anda, gunakan versi Unity yang didukung:

• Unity versi 2017.4 atau yang lebih baru dan .NET versi 4.6
• Untuk menggunakan file Ekspansi APK, diperlukan Unity 2018.2
• Untuk peningkatan kecepatan frame dan pengukuran GPU, diperlukan Unity versi 2019.3.14 atau yang lebih baru
• Untuk dukungan scene Addressables, diperlukan Unity 2019.3 atau yang lebih baru dan Paket Addressables 1.19.4 atau yang lebih baru.

Mendownload plugin

Download plugin dari repositori GitHub. Pilih download file .unitypackage.

Mengimpor plugin

Sebelum mengimpor plugin, pastikan project Anda menggunakan .NET versi 4.6. Ini berlaku untuk Unity versi 2018.4 dan yang lebih lama (versi Unity yang lebih baru hanya berisi .NET versi 4.6).

1. Pilih File > Build Settings. Pastikan Android dipilih sebagai platform saat ini.
2. Klik tombol Setelan Pemain.
3. Di bagian Setelan Lainnya, temukan Scripting Runtime Version dan pilih .NET 4.6.

Plugin ini disediakan sebagai Unity Package yang dapat Anda impor di project. Pilih Assets > Import Package > Custom Package, lalu pilih file .unitypackage yang telah Anda download.

Android Performance Tuner versi 1.5.1 atau yang lebih baru dengan Unity 2017

Penggunaan Android Performance Tuner versi 1.5.1 atau yang lebih baru dengan Unity 2017 memerlukan langkah-langkah tambahan berikut saat mengimpor plugin:

1. Buka folder Assets/AndroidPerformanceTuner/Editor.
2. Klik file Google.Android.PerformanceTuner.Editor untuk membukanya di Inspector.
3. Klik referensi assembly yang tidak ada, lalu klik - untuk menghapusnya.

4. Klik tombol Apply.

   Gambar 1. Referensi assembly yang tidak ada.

5. Buka folder Assets/AndroidPerformanceTuner/Runtime.

6. Klik file Google.Android.PerformanceTuner untuk membukanya di Inspector.

7. Ulangi langkah 3 untuk menghapus dua referensi assembly yang tidak ada.

8. Mulai ulang Unity.

9. Buka Window > AndroidPerformanceTuner > Setup dan pastikan tidak ada error yang ditampilkan.

Mengimpor ulang plugin setelah dihapus

Jika Anda mengimpor ulang plugin setelah menghapusnya dari project, hapus ANDROID_PERFORMANCE_TUNER_UTILITIES dari Player Settings > Scripting Define Symbols terlebih dahulu.

Mengonfigurasi plugin

Untuk mengonfigurasi plugin, lakukan hal berikut:

1. Untuk Unity versi 2019.3.14 atau yang lebih baru:

   • Aktifkan library Android Frame Pacing. Android Performance Tuner akan menggunakan library ini untuk mengukur performa game Anda, termasuk pengukuran yang lebih mendalam daripada yang hanya dilaporkan oleh Unity.

     Pilih File > Build Settings, lalu klik tombol Setelan Pemain. Pada Resolution and Presentation, centang Optimized Frame Pacing.

   • Menyinkronkan rendering frame dengan vertikal kosong.

     Dari Setelan Pemain, pilih tab Kualitas dan cari menu VSync Count. Gunakan pilihan apa pun (kecuali Jangan Sinkronkan). Pilihan selain Jangan Sinkronkan memungkinkan pengukuran yang lebih tepat bersama dengan library Android Frame Pacing.

2. (Untuk versi Unity sebelum 2019) Setel sistem build ke Gradle. Pilih File > Build Settings. Temukan Build System, lalu pilih Gradle.

3. Menambahkan izin akses internet. Di bagian Other Settings, temukan Internet Access dan pilih Require.

4. Masukkan kunci API Anda. Setelah plugin terpasang, Anda dapat memasukkannya dari menu Window > Android Performance Tuner > Setup. Pada dialog ini, pilih tab Setelan dan masukkan kunci API dari project Google Cloud Anda ke dalam kolom kunci API.

   Catatan: Jika tidak memasukkan kunci API, Android Performance Tuner tidak akan mengirim data kinerja game ke Konsol Google Play. Android Performance Tuner merekam error ini dalam log, dan Anda dapat melihat error tersebut menggunakan adb logcat. (Anda akan menjalankan adb logcat di bagian berikutnya untuk mengonfirmasi operasi yang benar pada Android Performance Tuner.)

   Gambar 2. Tab Settings (Setelan) di plugin