Mulai menggunakan Android XR Interaction Framework untuk Unity

Perangkat XR yang kompatibel
Panduan ini membantu Anda membangun pengalaman untuk jenis perangkat XR ini.
Mempelajari jenis perangkat XR →
Headset XR
Kacamata XR Berkabel
Mempelajari jenis perangkat XR →

Android XR Interaction Framework (AXRIF) menyediakan interaksi tingkat tinggi yang familiar, berpendapat untuk aplikasi OpenXR di Android XR. AXRIF menjembatani kesenjangan antara interaksi tingkat sistem dan interaksi dalam aplikasi, sehingga menawarkan cara yang intuitif dan kohesif untuk menangani input pengguna.

Ikuti panduan ini untuk menyiapkan dan mulai menggunakan AXRIF dengan Unity.

Prasyarat

Sebelum memulai, pastikan lingkungan pengembangan Anda memenuhi persyaratan berikut:

Menyiapkan dan mengonfigurasi Unity

Sebelum dapat mencoba adegan contoh, Anda harus menyiapkan dan mengonfigurasi Unity untuk AXRIF. Ikuti langkah-langkah di bagian berikut untuk menyelesaikan proses ini.

Mengimpor paket AXRIF

Pertama, instal paket AXRIF dan dependensinya:

  1. Buka Window > Package Manager.
  2. Buka menu add di toolbar Package Manager.
  3. Di opsi untuk menambahkan paket, klik + (plus).

  4. Dari menu drop-down, pilih Install package from git URL.

    Impor paket AXRIF menggunakan URL git-nya.

  5. Masukkan URL berikut:

    https://github.com/android-xr/android-xr-interaction-framework-unity-package.git

  6. Klik Install.

    Detail paket AXRIF di Unity Package Manager.

Memeriksa versi XR Interaction Toolkit

Paket AXRIF berfungsi bersama Unity XR Interaction Toolkit (XRIT) dan tidak menggantikannya. Karena paket AXRIF menentukan dependensi ke XRIT, Unity seharusnya telah menginstal XRIT saat Anda menginstal paket AXRIF pada langkah-langkah sebelumnya. Namun, Anda harus memeriksa apakah versi 3.3.1 atau yang lebih tinggi telah diinstal dengan membuka Window > Package Manager > Unity Registry > XR Interaction Toolkit di Unity Editor.

Gambar 1. Periksa versi XR Interaction Toolkit yang diinstal di Unity Editor.

Memilih profil build Android XR

Pilih profil build Android XR untuk mengaktifkan Setelan build dan Ekstensi OpenXR yang sesuai untuk Android XR:

  1. Buka File > Build Profiles.

  2. Klik Android XR, lalu klik Switch Platform.

    Pilih profil build Android XR di setelan Unity.

Mengonfigurasi setelan OpenXR

Konfigurasikan setelan OpenXR Unity agar Unity dapat mengakses data OpenXR yang diperlukan:

  1. Buka Edit > Project Settings > XR Plug-in Management > OpenXR.
  2. Di tab Android, klik + (plus) untuk bagian Enabled Interaction Profiles.

  3. Tambahkan salah satu profil berikut, bergantung pada kebutuhan aplikasi Anda:

    • Profil Interaksi Pandangan Mata
    • Profil Interaksi Tangan
    • Profil Pengontrol Sentuh Oculus
    • Profil Interaksi Mouse Android XR

  4. Dalam daftar fitur di XR Plug-in Management > OpenXR, aktifkan fitur berikut:

    • Android XR (Extensions): Passthrough Composition Layer
    • Android XR (Extensions): Session Management
    • Android XR Support
    • Android XR: AR Camera
    • Android XR: AR Session
    • Android XR: AR Hand Mesh Data
    • Composition Layers Support
    • Hand Tracking Subsystem

Melakukan validasi project

Lakukan validasi project untuk memperbaiki error OpenXR dalam konfigurasi project Anda:

  1. Buka Edit > Project Settings > XR Plug-in Management > Project Validation.

  2. Perbaiki setiap peringatan atau pemberitahuan yang belum diselesaikan untuk memastikan error runtime tidak memengaruhi kompilasi.

    Selesaikan masalah OpenXR yang belum terselesaikan dengan melakukan validasi project.

Menggunakan adegan contoh

Setelah menyelesaikan penyiapan dan konfigurasi awal, Anda dapat menggunakan adegan contoh AXRIF. Ikuti langkah-langkah di bagian berikut untuk mendapatkan adegan contoh dan mencobanya.

Mengimpor paket contoh XRIT dan contoh AXRIF

Adegan contoh AXRIF bergantung pada paket contoh Aset Starter XR Interaction Toolkit (XRIT) dan Demo Interaksi Tangan Unity.

Mengimpor paket contoh XRIT

Impor paket contoh XRIT yang digunakan oleh contoh AXRIF:

  1. Buka Window > Package Manager.
  2. Pilih XR Interaction Toolkit dari daftar paket.

  3. Di tab Samples, klik Import di samping Starter Assets dan Hands Interaction Demo.

    Impor paket sampel XRIT yang diperlukan sebelum mengimpor paket sampel AXRIF.

Mengimpor contoh AXRIF

Impor contoh AXRIF untuk mendapatkan adegan contoh:

  1. Buka Window > Package Manager.
  2. Pilih Android XR Interaction Framework dari daftar paket.

  3. Di tab Samples, klik Import di samping Axrif Sample.

    Impor contoh AXRIF di pengelola paket Unity.

Membuka Adegan

Setelah mengimpor paket contoh yang diperlukan, Anda dapat membuka adegan:

  1. Buka Assets > Samples > Android XR Interaction Framework > [AXRIF Version Number] > Axrif Sample.

  2. Buka AxrifDemoScene.

    Impor paket contoh AXRIF di pengelola paket Unity.

Menjelajahi prefab

Adegan ini telah dikonfigurasi sebelumnya menggunakan prefab modular yang terletak di bagian Packages > Android XR Interaction Framework > Prefabs.

Prefab interaktor

Prefab Interaktor Axrif mendorong mekanisme interaktor Unity XRIT menggunakan modalitas input yang sesuai dari daftar berikut:

  • Sinar Tangan/Pengontrol:
    • Axrif Left Interactor - Menggunakan raycast atau pengontrol tangan kiri.
    • Axrif Right Interactor - Menggunakan raycast atau pengontrol tangan kanan.
  • Cubit Pandangan:
    • Axrif Left GazePinch Interactor - Menggunakan pandangan mata dan gerakan tangan kiri saat mencubit.
    • Axrif Right GazePinch Interactor - Menggunakan pandangan mata dan gerakan tangan kanan saat mencubit.
    • Axrif Gaze Interactor - Hanya menggunakan pandangan mata untuk menunjuk.
  • Sentuhan Tangan:
    • Axrif Left Poke Interactor - Menggunakan jari telunjuk kiri saat menyentuh objek yang dapat berinteraksi.
    • Axrif Right Poke Interactor - Menggunakan jari telunjuk kanan saat menyentuh objek yang dapat berinteraksi.
  • Mouse:
    • Axrif Mouse Interactor - Menggunakan mouse spasial Android XR.

Prefab Pengelola Interaksi dan Asal Axrif

  • Pengelola Interaksi Axrif: Prefab ini adalah hub pusat untuk AXRIF dalam adegan. Prefab ini berisi komponen Pengelola Interaksi Axrif, yang dirancang untuk bekerja bersama dengan Pengelola Interaksi XRIT XR. Prefab ini bertanggung jawab untuk:

    • Menginisialisasi dan mengelola subsistem AXRIF inti saat runtime.
    • Memproses dan merutekan data input dari OpenXR menggunakan Adaptor Input Framework Interaksi.
    • Mengamati status UI dan collider menggunakan Integrator Adegan Framework Interaksi.

  • Asal XR Axrif: Berfungsi sebagai karakter utama dan driver kamera serta mengelola visualisator mesh tangan.

Mengonfigurasi tindakan input

Untuk menjembatani data runtime OpenXR dengan Tindakan Input Unity, daftarkan binding peta di seluruh project:

  1. Buka Packages > Android XR Interaction Framework > InputActions.
  2. Temukan AndroidXRInteractionFramework Input Actions.

  3. Klik Assign as the Project-wide Input Actions.

    Konfigurasi tindakan input untuk Unity guna menjembatani data runtime dengan Tindakan Input Unity.

Mengubah interaksi

Dengan menggunakan prefab Pengelola Interaksi Axrif, Anda dapat mengaktifkan atau menonaktifkan modalitas input yang berbeda. AXRIF mendukung modalitas input berikut:

  • Raycasting Pengontrol
  • Cubit dan Pandangan
  • Raycasting Tangan
  • Tangan Langsung
  • Interaksi Mouse.

Anda dapat mengonfigurasi modalitas input langsung di dalam Inspector di bagian Configurations komponen Interaction Framework Manager.

Gambar 2. Konfigurasikan modalitas input di dalam Inspector.

Mem-build contoh

Jika ingin mem-build contoh, klik Build atau Build and Run di Unity Editor.