Mengintegrasikan Asset Delivery (Unity)

Saat mengintegrasikan Asset Delivery, game Unity dapat mengakses paket aset menggunakan Addressables atau AssetBundles. Addressables adalah solusi pengiriman aset yang lebih baru dan direkomendasikan untuk game yang dibuat menggunakan Unity 2019.4 atau lebih tinggi, sementara AssetBundles memberikan dukungan paket aset di Unity 2017.4 dan 2018.4.

Addressables Unity

Game yang dibangun dengan Unity 2019.4 atau lebih tinggi harus menggunakan Addressables untuk pengiriman aset di Android. Unity menyediakan Play Asset Delivery (PAD) API untuk menangani paket aset Android menggunakan Addressables. Untuk informasi tentang penggunaan Addressables, lihat berikut ini:

• Paket Addressables untuk Android
• Panduan PAD untuk Unity
• PAD API untuk Unity dokumentasi referensi

Menggunakan file AssetBundle

Game yang dibangun dengan Unity 2017.4 dan 2018.4 dapat menggunakan file AssetBundle untuk pengiriman aset di Android. File AssetBundle Unity berisi aset serial yang dapat dimuat oleh mesin Unity saat aplikasi berjalan. File ini bersifat khusus untuk setiap platform (misalnya, dibuat untuk Android) dan dapat digunakan bersama paket aset. Biasanya, satu file AssetBundle dipaketkan menjadi satu paket aset, dengan paket yang menggunakan nama yang sama dengan AssetBundle. Jika Anda menginginkan fleksibilitas lebih tinggi dalam membuat paket aset, konfigurasikan paket aset menggunakan API.

Saat runtime, gunakan class Play Asset Delivery for Unity untuk mengambil AssetBundle yang dikemas dalam paket aset.

Prasyarat

1. Siapkan lingkungan pengembangan Anda:

OpenUPM-CLI

Jika telah menginstal OpenUPM CLI, Anda dapat menginstal registry OpenUPM dengan perintah berikut:

openupm add com.google.play.assetdelivery

OpenUPM

1. Buka setelan pengelola paket dengan memilih opsi menu Unity Edit > Setelan Project > Pengelola Paket.

2. Tambahkan OpenUPM sebagai scoped registry ke jendela Package Manager:

   Name: package.openupm.com
   URL: https://package.openupm.com
   Scopes: com.google.external-dependency-manager
     com.google.play.common
     com.google.play.core
     com.google.play.assetdelivery
     com.google.android.appbundle
   

3. Buka menu package manager dengan memilih opsi menu Unity Window > Package Manager.

4. Setel drop-down cakupan pengelola untuk memilih My Registries.

5. Pilih paket plugin Google Play Integrity untuk Unity dari daftar paket, lalu tekan Install.

Mengimpor dari GitHub

1. Download rilis .unitypackage terbaru dari GitHub.

2. Impor file .unitypackage dengan memilih opsi menu Unity Assets > Import package > Custom Package dan mengimpor semua item.

Catatan: Dengan mendownload dan menggunakan Google Play Unity Plugin, Anda menyetujui Persyaratan Layanan Software Development Kit Play Core.

1. Membuat AssetBundles di Unity.

   Catatan: Anda dapat menggunakan Browser AssetBundle Unity untuk membuat dan mengelola AssetBundle di project Unity Anda.

Mengonfigurasikan AssetBundles menggunakan UI

1. Mengonfigurasikan setiap AssetBundle dalam sebuah paket aset:

   1. Pilih Google > Android App Bundle > Setelan Asset Delivery.
   2. Untuk memilih folder yang langsung berisi file AssetBundle, klik Tambahkan Folder.

   

2. Untuk setiap paket, ubah Mode Pengiriman menjadi Saat Menginstal, Mulai Segera, atau On Demand. Atasi error atau dependensi, dan tutup jendela.

   

3. Pilih Google > Buat Android App Bundle untuk membuat app bundle.

4. (Opsional) Konfigurasikan app bundle Anda untuk mendukung berbagai format kompresi tekstur.

Mengonfigurasi paket aset menggunakan API

Anda dapat mengonfigurasi asset delivery melalui skrip editor yang dapat dijalankan sebagai bagian dari sistem build otomatis.

Gunakan class AssetPackConfig untuk menentukan aset yang akan disertakan dalam build Android App Bundle, serta mode pengiriman aset. Paket aset ini tidak perlu berisi AssetBundle.

public void ConfigureAssetPacks {
   // Creates an AssetPackConfig with a single asset pack, named
   // examplePackName, containing all the files in path/to/exampleFolder.
   var assetPackConfig = new AssetPackConfig();
   assetPackConfig.AddAssetsFolder("examplePackName",
                                   "path/to/exampleFolder",
                                   AssetPackDeliveryMode.OnDemand);

   // Configures the build system to use the newly created assetPackConfig when
   // calling Google > Build and Run or Google > Build Android App Bundle.
   AssetPackConfigSerializer.SaveConfig(assetPackConfig);

   // Alternatively, use BundleTool.BuildBundle to build an App Bundle from script.
   BuildBundle(new buildPlayerOptions(), assetPackConfig);
}

Anda juga dapat menggunakan metode BuildBundle statis di class Bundletool untuk menghasilkan Android App Bundle dengan paket aset, mengingat BuildPlayerOptions dan AssetPackConfig.

Untuk tutorial terpandu, lihat Menggunakan Play Asset Delivery di Codelab game Unity.

Melakukan integrasi dengan Play Asset Delivery Unity API

Play Asset Delivery Unity API menyediakan fungsi untuk meminta asset pack, mengelola download, dan mengakses aset. Pastikan untuk Menambahkan plugin Unity terlebih dahulu ke project Anda.

Fungsi yang digunakan di API bergantung pada bagaimana Anda membuat asset pack.

Jika Anda membuat paket aset menggunakan UI plugin, pilih Paket aset yang dikonfigurasi plugin.

Jika Anda membuat paket aset menggunakan API (atau UI plugin), pilih paket aset yang dikonfigurasi API.

Paket aset yang dikonfigurasi plugin Paket aset yang dikonfigurasi API

Langkah berikutnya

Uji pengiriman aset secara lokal dan dari Google Play.