Petunjuk

Mulai menggunakan Unity dan Android XR

Waktu baca: 6 menit
Lihat profil Luke Hopkins
Luke Hopkins Developer Relations Engineer, Android

Samsung Galaxy XR kini telah hadir, didukung oleh Android XR. Postingan blog ini adalah bagian dari Android XR Spotlight Week, tempat kami menyediakan referensi—postingan blog, video, kode contoh, dan lainnya—yang semuanya dirancang untuk membantu Anda mempelajari, membangun, dan menyiapkan aplikasi untuk Android XR. 

Sekarang adalah waktu yang tepat untuk mulai mengembangkan XR. Desember lalu, kami mengumumkan Android XR, platform Android baru Google yang dibangun berdasarkan standar terbuka seperti OpenXR dan Vulkan, yang membuat pengembangan XR lebih mudah diakses daripada sebelumnya.


Dan jika digabungkan dengan alat XR Unity yang sudah ada, Anda akan mendapatkan stack pengembangan yang andal dan matang. Hal ini memungkinkan pembuatan dan deployment aplikasi XR yang berfungsi di beberapa perangkat.

openxr_face_tracking2.webp

Baik Anda sudah pernah melakukan pengembangan XR maupun belum, kami ingin membantu Anda memulai.

Blog ini akan membantu Anda memulai pengembangan Android XR dan Unity. Kita akan berfokus pada langkah-langkah praktis untuk mengonfigurasi lingkungan Anda, memahami ekosistem paket, dan mulai membangun.

Di akhir blog ini, Anda akan memiliki pemahaman yang baik tentang:

  • Ekosistem paket
  • Langkah penyiapan penting
  • Metode masukan
  • Privasi dan izin
  • Lapisan komposisi

Pengembangan Unity untuk Android XR

Anda dapat memilih Unity karena kompatibilitas lintas platformnya, sehingga Anda dapat membangun sekali dan men-deploy ke Android XR dan perangkat XR lainnya.

Saat menggunakan Unity, Anda akan mendapatkan manfaat dari ekosistem dan alat XR yang sudah matang. Unity sudah memiliki paket yang sudah ada seperti XR Interaction Toolkit, plugin OpenXR, lapisan komposisi XR, XR Hands, penyimpanan aset yang luas dan penuh dengan komponen dan template siap pakai XR, serta alat simulasi dan pengujian XR. Dan karena Unity 6 dirilis November lalu, Anda juga akan mendapatkan manfaat dari peningkatan performa Universal Render Pipeline (URP), dukungan grafis Vulkan yang lebih baik, dan profil build yang ditingkatkan.

Berikut beberapa contoh project untuk mendapatkan gambaran tentang apa yang dapat dilakukan:

Konfigurasi penting: fondasi pengembangan Anda

Persyaratan dan penginstalan Unity 6

Anda memerlukan Unity 6 untuk membuat aplikasi, karena versi sebelumnya tidak mendukung Android XR. Instal Unity Hub terlebih dahulu, lalu Unity 6 dengan modul Android Build Support, dengan mengikuti langkah-langkah ini.

unity6.png

Profil build Android XR: menyederhanakan konfigurasi

Profil build Unity adalah aset project yang menyimpan setelan dan konfigurasi khusus platform Anda. Jadi, daripada harus menyiapkan 15-20 setelan berbeda secara manual di beberapa menu, Anda dapat menggunakan profil build untuk melakukannya secara otomatis.
Anda dapat membuat profil build sendiri, tetapi untuk saat ini sebaiknya gunakan profil build Android XR khusus yang kami buat.

Anda dapat memilih profil build dengan memilih File > Build Profile dari project Unity Anda. Untuk mengetahui petunjuk lengkapnya, lihat halaman alur kerja Mengembangkan untuk Android XR.

Jika melakukan perubahan sendiri, Anda dapat membuat profil build baru untuk dibagikan kepada tim. Dengan cara ini, Anda memastikan pengalaman build yang konsisten secara keseluruhan.

buildprofiles.png

Setelah langkah-langkah ini, Anda dapat mem-build dan menjalankan APK untuk perangkat Android XR.

Graphics API: alasan Vulkan penting

Setelah menyiapkan project Unity dengan profil build Android XR, sebaiknya pastikan Anda telah menetapkan Vulkan sebagai API grafis. Android XR dibuat sebagai platform yang mengutamakan Vulkan. Pada Maret 2025, Google mengumumkan bahwa Vulkan kini menjadi API grafis resmi untuk Android. Vulkan adalah API grafis tingkat rendah modern yang membantu developer memaksimalkan performa GPU modern dan membuka fitur lanjutan seperti ray-tracing dan multithreading untuk visual game yang realistis dan imersif.

Standar ini memberikan kompatibilitas terbaik untuk aplikasi yang ada serta mengurangi masalah dan biaya porting. Selain itu, plugin ini memungkinkan pengaktifan fitur Android XR lanjutan seperti URP Application Space Warp dan foveated rendering. 

Unity 6 menangani Vulkan secara otomatis, jadi saat Anda menggunakan profil build Android XR, Unity akan mengonfigurasi Vulkan sebagai API grafis Anda. Hal ini memastikan Anda mendapatkan akses ke semua fitur Android XR lanjutan tanpa konfigurasi manual.

Anda dapat memverifikasi setelan API grafis dengan membuka ‘Edit’ >’ Setelan Project’ > ‘Player’ > ‘Android tab’ > ‘Other settings’ > ‘Graphics APIs’.

graphics-api.png
appentrypoint.png

Memahami ekosistem paket

Ada dua paket berbeda yang dapat Anda gunakan untuk Android XR di Unity. Salah satunya adalah dengan menggunakan Android XR Extensions untuk Unity, dan yang lainnya adalah menggunakan paket Unity OpenXR: Android XR.

Kedua hal ini mungkin terdengar sama, tetapi perhatikan baik-baik.

Paket Unity OpenXR: Android XR adalah paket Unity resmi untuk dukungan Android XR. Plugin ini menyediakan sebagian besar fitur Android XR, yang tersedia melalui standar OpenXR. Plugin ini juga memungkinkan integrasi AR Foundation untuk fitur mixed reality. Manfaat utama menggunakan paket Unity OpenXR: Android XR adalah paket ini menawarkan API terpadu untuk mendukung perangkat XR.


Sedangkan Android XR Extensions for Unity adalah paket XR Google, yang dirancang khusus untuk pengembangan perangkat Android XR. Plugin ini melengkapi paket Unity OpenXR dengan fitur tambahan seperti mode penggabungan lingkungan, meshing scene, pelacakan gambar, dan pelacakan tubuh. Konsekuensinya adalah Anda hanya dapat mengembangkan aplikasi untuk perangkat Android XR.


Pilihan Anda akan bergantung pada kebutuhan spesifik Anda, tetapi kami umumnya merekomendasikan Unity OpenXR: Android XR, karena memberikan fleksibilitas yang jauh lebih besar untuk perangkat yang akan kompatibel dengan aplikasi Anda, dan kemudian berdasarkan persyaratan aplikasi, Anda dapat menambahkan Android XR Extensions untuk Unity.

Cara menginstal paket

Untuk menambahkan paket baru, dengan project Anda terbuka di Unity, pilih ‘Window’ > ‘Package Management’ > ‘Package Manager’.

Dari sini, Anda dapat menginstal paket ini dari tab ‘Unity Registry’:

packagemanager.png

Anda dapat menginstal paket Android XR untuk Unity melalui GitHub dengan memilih ikon ➕, memilih ‘Install package from git URL’, lalu memasukkan ‘https://github.com/android/android-xr-unity-package.git’

packagemanager2.png

Fitur OpenXR yang diperlukan

Setelah menginstal paket yang diperlukan, mari kita aktifkan beberapa fitur inti agar project kita berfungsi.

Anda dapat mengaktifkan setelan OpenXR untuk Android: ‘Edit’ -> ‘Setelan Project’ -> ‘Pengelolaan Plugin XR’ -> Klik Android dan aktifkan OpenXR

xrpluginmgmt.png

Selanjutnya, kita perlu mengaktifkan dukungan untuk: 'Android XR support'. Kita akan membahas fitur OpenXR lainnya sesuai kebutuhan. Untuk saat ini, kita hanya perlu mengaktifkan dukungan Android XR.

Input

Android XR mendukung input untuk Tangan, Suara, Pelacakan gerak mata, Keyboard, dan Pengontrol. Sebaiknya instal XR Interaction Toolkit dan XR Hands karena keduanya berisi prefab terbaik untuk memulai. Dengan menggunakan prefab ini, Anda akan memiliki semua yang diperlukan untuk mendukung Tangan dan Pengontrol di aplikasi Anda.

xrinteractiontoolkit.png

Setelah XR Hands dan XR Interaction Toolkit diinstal, sebaiknya impor Starter Assets dan Hands Interaction Demo. Kemudian, Anda perlu mengaktifkan profil Hand Interaction dan Khronos Simple Controller, serta mengaktifkan fitur Hand Tracking Subsystem dan Meta Hand Tracking Aim.

Anda dapat mengedit setelan ini dengan membuka ‘Edit’ > ‘Setelan Project’ > XR Plug-in Management’ > ‘OpenXR’

profiles.png

Kami juga merekomendasikan prefab Unity, XR Origin, yang mewakili posisi dan orientasi pengguna di ruang XR. Ini berisi rig kamera dan komponen pelacakan yang diperlukan untuk merender pengalaman XR Anda dari sudut pandang yang benar.

Cara termudah untuk menambahkan prefab ini adalah dengan mengimpornya dari demo integrasi tangan yang kita impor sebelumnya, yang dapat ditemukan di sini ‘Hands Integration Toolkit’ > ’Hand Interaction’ > ’Prefabs’ > ’XR Origin’

prefabs.png

Sebaiknya gunakan Prefab ini daripada opsi ‘XR Origin’ di objek game Anda karena Prefab ini menggunakan XR Input Modality Manager yang otomatis beralih antara tangan dan pengontrol pengguna. Tindakan ini akan memberikan keberhasilan terbaik untuk beralih antara tangan dan pengontrol.

Privasi dan izin: membangun kepercayaan pengguna

Apa pun yang Anda buat, Anda harus mendapatkan izin runtime dari pengguna. Hal ini karena pemahaman scene, pelacakan gerak mata, pelacakan wajah, dan pelacakan gerak tangan memberikan akses ke data yang mungkin lebih sensitif bagi pengguna.

Kemampuan ini memberikan informasi pribadi yang lebih mendalam daripada aplikasi desktop atau seluler biasa, sehingga izin runtime memastikan pengguna Anda memiliki kontrol penuh atas data yang mereka pilih untuk dibagikan. Jadi, untuk mematuhi kebijakan keamanan dan privasi Android, Android XR memiliki izin untuk setiap fitur ini.

Misalnya, jika Anda menggunakan paket XR Hands untuk gestur tangan kustom, Anda harus meminta izin pelacakan gerak tangan (lihat di bawah) karena paket ini perlu melacak banyak informasi tentang tangan pengguna. Hal ini mencakup hal-hal seperti melacak pose sendi tangan serta kecepatan sudut dan linear;

Catatan: Untuk mengetahui daftar lengkap ekstensi yang memerlukan izin, lihat informasi di situs developer XR.

const string k_Permission = "android.permission.HAND_TRACKING";

#if UNITY_ANDROID
void Start()
{
    if (!Permission.HasUserAuthorizedPermission(k_Permission))
    {
        var callbacks = new PermissionCallbacks();
        callbacks.PermissionDenied += OnPermissionDenied;
        callbacks.PermissionGranted += OnPermissionGranted;
        
        Permission.RequestUserPermission(k_Permission, callbacks);
    }
}

void OnPermissionDenied(string permission)
{
    // handle denied permission
}


void OnPermissionGranted(string permission)
{
    // handle granted permission
}

#endif // UNITY_ANDROID

Meningkatkan kualitas visual dengan lapisan komposisi

Lapisan Komposisi adalah cara yang direkomendasikan untuk merender elemen UI. Overlay memungkinkan elemen ditampilkan dengan kualitas yang jauh lebih tinggi dibandingkan dengan pipeline rendering standar Unity karena semuanya dirender langsung ke compositor platform.

Misalnya, jika Anda menampilkan teks, rendering Unity standar lebih cenderung memiliki teks buram, tepi lembut, dan artefak visual. Sedangkan dengan lapisan komposisi, teks akan lebih jelas, garis tepi akan lebih tajam, dan pengalaman secara keseluruhan akan lebih baik.


Selain teks, model ini juga merender video, gambar, dan elemen UI dengan kualitas yang jauh lebih tinggi. Hal ini dilakukan dengan memanfaatkan dukungan native untuk lapisan compositor runtime.

Untuk mengaktifkan Composition Layers, buka Package Manager, pilih ‘Unity Register’, lalu instal ‘XR Composition Layers’.

Mem-build dan Menjalankan

Setelah menginstal paket OpenXR dan mengaktifkan fitur, serta menyiapkan prefab untuk gerakan tangan dan kepala, Anda kini dapat membuat scene dan men-deploy-nya langsung ke headset untuk pengujian.

Langkah berikutnya: memperluas keterampilan Anda

Setelah menyiapkan lingkungan pengembangan Android XR dan memahami konsep utamanya, berikut langkah-langkah selanjutnya untuk melanjutkan perjalanan pengembangan XR Anda:

Referensi penting untuk pembelajaran berkelanjutan:

Contoh project untuk dipelajari:

Ditulis oleh:
Lanjutkan membaca