Table of Contents

Menggunakan contoh EasyAR pada headset atau kacamata XR

EasyAR menyediakan contoh seragam untuk semua headset, contoh ini tidak memiliki kode sama sekali, semuanya diimplementasikan melalui konfigurasi dalam scene. Penggunaan fungsionalitas itu sendiri dapat merujuk pada implementasi contoh pada ponsel Android/iOS terkait.

Nama contoh headset adalah Combination_BasedOn_*, misalnya contoh untuk Pico adalah Combination_BasedOn_Pico. Contoh ini mendemonstrasikan sebagian besar fungsionalitas EasyAR dalam satu scene, yang dapat diaktifkan/dinonaktifkan secara dinamis, dapat digunakan secara terpisah, atau dibuka bersamaan.

Persiapan

  • Pastikan headset atau kacamata Anda saat ini ada dalam daftar dukungan EasyAR
  • Unduh dan impor paket plugin Unity EasyAR
  • Unduh dan impor paket ekstensi perangkat XR Unity EasyAR
  • Dapatkan lisensi EasyAR yang sesuai untuk headset atau kacamata XR, jenis lisensi yang tersedia untuk headset atau kacamata termasuk
    • EasyAR Sense 4.x XR License versi uji coba (uji coba, aktifkan sendiri di situs web EasyAR)
    • EasyAR Sense 4.x XR License versi resmi (berbayar setelah digunakan, silakan hubungi penjualan untuk pembelian dan aktivasi)
    • EasyAR Sense 4.x XR License versi perusahaan (digunakan dengan SDK versi perusahaan)
Hati-Hati

Pada headset dan kacamata hanya diperbolehkan menggunakan XR License, lisensi biasa tidak dapat menggunakan fungsi EasyAR.

Mengimpor contoh resmi

  1. Contoh untuk perangkat yang didukung secara bawaan berada dalam paket plugin Unity EasyAR, impor contoh yang diperlukan secara terpisah berdasarkan perangkat. xr-samples-location

  2. Contoh untuk perangkat yang didukung melalui ekstensi didistribusikan bersama ekstensi headset yang sesuai. Anda dapat menggunakan Unity untuk mengimpor contoh ke dalam proyek. Mengambil Pico sebagai contoh. xr-pico-extension

Membangun dan menjalankan contoh

Selesaikan konfigurasi proyek headset dan instruksi penggunaan contoh secara terpisah.

  • Merujuk ketat pada dokumentasi dan petunjuk resmi headset terkait untuk melakukan konfigurasi yang sesuai, konten terkait tidak akan dicakup dalam dokumentasi EasyAR.

  • Lakukan konfigurasi sesuai dengan petunjuk platform di dokumentasi EasyAR.

    Android: Silakan merujuk Konfigurasi proyek Android

    visionOS: Silakan merujuk Konfigurasi proyek visionOS

    XREAL selain pengaturan sesuai platform Android, tambahan diperlukan Konfigurasi proyek XREAL

  • Membangun contoh Di Unity, bangun contoh untuk digunakan, dan terapkan ke perangkat untuk dijalankan. Metode spesifik lihat Menjalankan contoh di Unity.

Penjelasan penggunaan

Contoh memiliki beberapa tombol bawaan, dengan fungsi spesifik sebagai berikut. xr-sample-usage-7

  • Tombol1 HUD: Mengubah mode tampilan UI, status awal UI akan terpaku di dunia nyata, setelah HUD dibuka UI akan selalu ditampilkan di depan mata.
  • Tombol2 Record: Mengaktifkan/menonaktifkan perekaman EIF. Setelah dibuka, harus ditutup untuk merekam file EIF normal, jika tidak file yang direkam tidak dapat digunakan.
  • Tombol3 Image: Mengaktifkan/menonaktifkan pelacakan gambar.
  • Tombol4 Image fusion: Mengaktifkan/menonaktifkan mode pelacakan gambar + fusi gerakan.
  • Tombol5 Dense: Mengaktifkan/menonaktifkan pemetaan ruang padat.
  • Tombol6 Sparse: Mengaktifkan/menonaktifkan pemetaan ruang jarang.
  • Tombol7 Mega: Mengaktifkan/menonaktifkan Mega.

Penjelasan fungsionalitas terperinci

  • Sakelar fungsi bawaan

    Semua fungsi saat dimulai secara bawaan dinonaktifkan, ini diimplementasikan dengan menonaktifkan skrip terkait di editor, operasi tombol mengoperasikan pengaktifan/penonaktifan skrip terkait, dapat mengatur fungsi yang diaktifkan secara bawaan sesuai contoh yang sebenarnya akan dijalankan.

    hmd-default-disable

  • Referensi titik asal sistem koordinat

    Dalam contoh, di titik asal sistem koordinat pelacakan gerakan ditempatkan model panda diam, digunakan untuk memeriksa status pelacakan gerakan. Model ini membantu dalam memecahkan masalah, misalnya saat menjalankan Mega, beberapa pergeseran cepat disebabkan oleh pelacakan gerakan perangkat (yaitu cacat perangkat itu sendiri), saat ini model ini juga akan bergeser bersama/dapat menyesuaikan atau menghapus model panda ini sesuai kebutuhan.

  • Menggunakan gambar pelacakan gambar yang disematkan

    • Contoh telah mengatur ukuran gambar yang digunakan untuk pelacakan gambar datar, Anda perlu mencetak namecard.jpg di kertas A4, harus menjaga rasio gambar tidak meregang, tidak dipotong, sebisa mungkin memenuhi kertas (gambar di bawah). namecard

    • Ukur panjang pola kartu nama pada kertas setelah pencetakan selesai, berdasarkan hasil pengukuran, perlu mengatur Scale dari Image Target di scene Unity menjadi konsisten dengan ukuran fisik sebenarnya (satuan dalam meter). set-the-actual-size

    • Saat EasyAR fusi gerakan dibuka, hanya dapat melacak gambar di posisi tetap (tidak dapat dipindahkan). Jika fusi gerakan dinonaktifkan, gambar tidak dapat dilacak saat keluar dari bidang pandang.

    • Terkadang sudut pandang kacamata tidak dapat merepresentasikan ukuran gambar kamar dengan baik, jika tidak dapat dikenali coba dekatkan kamera kacamata ke gambar. Penggunaan aktual disarankan untuk melacak gambar yang lebih besar, misalnya ukuran 5m*5m.

Catatan

Pada headset, terlepas dari apakah fungsi EasyAR fusi gerakan aktif atau tidak, parameter Scale dari image target harus diatur ke ukuran fisik sebenarnya, jika tidak posisi tampilan akan salah.