Buat paket aset kustom
Grafik untuk Android

Kelola paket aset pada runtime

Unity menyediakan API untuk mengelola paket aset pada runtime. Mereka menggunakan API PlayCore Google, yang berarti mereka memiliki keterbatasan yang sama seperti PlayCore, dan tidak dapat mengelola paket aset install-time. Menggunakan PlayCore API juga berarti aplikasi Anda memerlukan plugin PlayCore. Jika proyek Anda memiliki paket aset, baik paket aset kustom atau paket aset yang dihasilkan Unity, Unity secara otomatis menambahkan ketergantungan PlayCore ke manifestasi aplikasi.

Cara Anda mengunduh paket aset dan mengakses aset mereka tergantung pada mode pengiriman paket aset. Ada tiga mode pengiriman paket aset:

  • install-time: Google Play secara otomatis mengunduh paket aset install-time ketika perangkat menginstal aplikasi. Login Bermain mempertimbangkan paket aset ini menjadi bagian dari aplikasi dasar, dan pengguna akhir tidak dapat menghapusnya tanpa menghapus seluruh aplikasi. API PlayCore tidak menangani paket aset install-time, yang berarti Anda tidak dapat memeriksa status, meminta untuk mengunduh, atau menghapus paket aset install-time. Anda juga tidak dapat langsung mengakses aset di dalam paket aset ini, kecuali aset streaming dalam paket aset Unity-generasi install-time. Untuk mengakses aset streaming, gunakan Aplikasi.streamingAssetsPath untuk mendapatkan jalur untuk streaming lokasi aset, kemudian gunakan UnityWebRequest untuk mengakses aset di jalan itu. Jika Anda membuat paket aset kustom, Anda tidak dapat mengakses aset di dalamnya menggunakan API file standar. Sebagai gantinya, gunakan API AssetManager Android.
  • fast-follow: Google Play secara otomatis mulai mengunduh paket aset fast-follow setelah menginstal aplikasi. Namun, dimungkinkan bahwa tidak semua paket aset fast-follow tersedia pada saat pertama peluncuran aplikasi. Untuk memeriksa status dan mengunduh paket aset fast-follow, lihat Unduh paket aset.
  • on-demand: Google Play tidak secara otomatis mengunduh paket aset on-demand. Anda harus memulai unduhan secara manual. Untuk informasi tentang cara melakukan ini, lihat di bawah ini.

Untuk informasi lebih lanjut tentang mode pengiriman, lihat Mode pengiriman.

Unduh paket aset

Jika aplikasi Anda menggunakan paket aset fast-follow atau on-demand, perangkat harus mengunduh paket aset ini sebelum aplikasi dapat mengakses aset di dalamnya. Untuk memeriksa status paket aset dan mengunduhnya jika tidak ada di perangkat, Anda harus terlebih dahulu tahu nama setiap paket aset. Untuk mendapatkan nama paket aset Unity-generated, hubungi AndroidAssetPacks.GetCoreUnityAssetPackNames. Tidak ada API runtime untuk mendapatkan nama paket aset kustom sehingga Anda harus melacaknya sendiri. Anda mengatur nama paket aset kustom pada waktu build; itu adalah nama direktori.

Setelah Anda memiliki nama paket aset Anda, untuk memeriksa status setiap paket aset, hubungi AndroidAssetPacks.GetAssetPackStateAsync, lewat nama paket aset. Ini mengembalikan status paket aset yang Anda kuis, dan Anda dapat menggunakan hasilnya untuk menentukan apakah Anda perlu mengunduh paket aset. Jika Anda ingin dengan cepat meminta status setiap paket aset yang dihasilkan Unity, Anda dapat menggunakan AndroidAssetPacks.coreUnityAssetPaketDownloaded. Ini berguna karena Anda harus memastikan bahwa setiap paket aset yang dihasilkan Unity tersedia sebelum Anda memuat setiap sceneAdegan berisi lingkungan dan menu permainan Anda. Pikirkan setiap file Adegan unik sebagai tingkat yang unik. Di setiap Adegan, Anda menempatkan lingkungan, hambatan, dan dekorasi, pada dasarnya merancang dan membangun permainan Anda dalam potongan-potongan. More info
Lihat di Glossary
selain yang pertama atau mencoba untuk mengakses sumber daya lain yang menangani Unity.

Untuk setiap paket aset yang perlu Anda unduh, hubungi AndroidAssetPacks.DownloadAssetPackAsync, lewatkan nama paket aset. Meskipun unduhan paket aset, monitor status unduhan karena unduhan dapat berhenti atau gagal. Ada dua cara untuk melakukan ini:

Sumber daya tambahan

Buat paket aset kustom
Grafik untuk Android