Menggunakan alat verifikasi session

Artikel ini memperkenalkan cara menggunakan alat verifikasi session, untuk memvalidasi alur kerja session dengan cepat di editor dan menjalankan simulasi menggunakan file EIF.

Sebelum memulai

Simulasi menggunakan file EIF sebagai input, jadi sebelum memulai, Anda perlu merekam file EIF terlebih dahulu:

• Lihat Merekam file EIF untuk merekam file EIF

Anda juga perlu memahami:

• Konsep dasar Merekam file EIF dan menggunakannya untuk simulasi
• Konsep dasar, komposisi, dan alur kerja AR Session

Alat verifikasi session

Alat verifikasi session membantu pengembang memvalidasi alur kerja session dengan cepat di Unity editor dan menjalankan simulasi menggunakan file EIF.

Secara default, alat verifikasi session dapat dilihat di jendela Inspector objek AR Session (EasyAR), yang merupakan bagian dari editor DiagnosticsController:

Klik tombol ↗ di kanan atas alat untuk membukanya sebagai jendela terpisah, memudahkan melihat dan mengoperasikan. Saat jendela ditutup atau tombol ↘ ditekan, alat akan ditampilkan kembali di jendela Inspector.

Efek saat alat berjalan ditunjukkan dalam video berikut:

Video ini menunjukkan penggunaan alat verifikasi session, direkam dalam mode play Unity. Bagian atas video menunjukkan tampilan Hierarchy di kiri, Scene di tengah, dan Game di kanan. Bagian bawah adalah alat verifikasi session. Konten tampilan Game sama dengan yang dilihat pengguna di dunia nyata melalui ponsel.

Di kiri atas alat, bilah kemajuan pemutaran EIF ditampilkan, berubah seiring kemajuan pemutaran. Di kiri bawah alat, status session saat ini ditampilkan. Di kanan, komponen session dan mode pusat yang tersedia ditampilkan.

Di scene, tiga fungsi AR yang bekerja bersamaan dapat dilihat:

• Pelacakan gerakan: Disediakan oleh frame player, bola biru adalah XR Origin, kerucut biru mewakili posisi pengguna.
• Pemetaan ruang padat: Dapat dilihat mesh model semi-transparan terus dihasilkan seiring pergerakan sudut pandang.
• Pelacakan ruang renggang: Pohon Natal sedang dilacak dalam video, objek virtual yang ditumpangkan adalah point cloud biru muda.

Memulai alat

Klik tombol ▶ di atas alat untuk memulainya. Efek tombol ini sama dengan menekan tombol ▶ di Unity toolbar.

Jika alat sudah berjalan, tombol akan berubah menjadi ■, klik untuk menghentikan alat.

Saat alat ditampilkan sebagai jendela terpisah, kotak pilihan di kanan tombol ▶ memungkinkan memilih objek session yang digunakan alat. Jika jendela direset menyebabkan session hilang, Anda dapat memilih ulang dari sini.

Mengontrol pemutaran EIF

Untuk menggunakan fungsi pemutaran EIF alat, centang opsi Frame Player alat sebelum menjalankan. Saat ini, alat akan mengelola pemilihan frame source selama perakitan session. Terlepas dari nilai yang diatur di AssembleOptions.FrameSource, komponen frame player akan diaktifkan.

Oleh karena itu, saat runtime, pesan pop-up akan muncul, menunjukkan bahwa frame source yang digunakan session saat ini sedang dikelola oleh alat:

Catatan

Alat hanya akan mengelola pemilihan frame source selama perakitan di Unity editor. Opsi ini tidak berpengaruh saat aplikasi dibangun untuk dijalankan.

Saat berjalan normal, fungsi kontrol pemutaran EIF ditampilkan di bagian yang dilingkari di atas alat:

Tombol-tombol ini mengontrol pemutaran file EIF:

• ▶: Putar, melanjutkan pemutaran dari status jeda atau berhenti
• ▮▮: Jeda
• ■: Berhenti
• ▮◀: Lompat ke 5 detik sebelumnya (jika file mendukung)
• ◀◀: Kurangi kecepatan pemutaran (jika file mendukung)
• ▶▶: Tingkatkan kecepatan pemutaran (jika file mendukung)
• ▶▮: Lompat ke 5 detik berikutnya (jika file mendukung)
• ▲: Buka file
• Bilah kemajuan: Klik untuk melompat ke posisi pemutaran (jika file mendukung)

Anda dapat menyesuaikan konten dan logika interaksi di scene sambil memutar, memungkinkan sebagian besar pekerjaan pengembangan dilakukan di komputer dan melihat efeknya secara visual.

Catatan

Saat memutar data baru atau melompat, data asli di scene tidak akan dibersihkan. Status komponen AR juga tidak akan diatur ulang, mereka akan berperilaku seolah-olah data kamera tiba-tiba melompat dari data frame sebelumnya ke data baru.

Meskipun ini tidak terlalu memengaruhi beberapa fungsi, untuk fungsi yang bergantung pada pelacakan gerakan (seperti peta ruang padat, Mega, dll.), ini dapat menyebabkan status fungsi tidak normal, memengaruhi efek operasi.

Mengontrol alur kerja session

Untuk menggunakan fungsi kontrol alur kerja session alat, centang opsi Session Workflow alat sebelum menjalankan. Opsi ini dicentang secara default.

Saat berjalan normal, fungsi kontrol alur kerja session ditampilkan di bagian yang dilingkari di bawah kontrol pemutaran:

Di atas seluruh area, dua informasi status ditampilkan: EasyARController.IsReady dan ARSession.State.

Di bawah seluruh area, tombol-tombol ini disediakan untuk mengontrol alur kerja session:

• Initialize: Menginisialisasi session, dapat memilih menggunakan license key yang dikonfigurasi di Project Settings atau memasukkan license key secara manual
• Assemble: Merakit tetapi tidak memulai session
• StartSession (Assembled): Memulai session yang sudah dirakit
• StartSession: Merakit dan memulai session
• StopSession: Menghentikan session
• StopSession (keep image): Menghentikan session, tetapi mempertahankan latar belakang gambar
• Deinitialize: Mendekinisialisasi session

Catatan

Karena fungsi kontrol ini secara langsung memanggil metode terkait di ARSession dan EasyARController, tombol-tombol ini dapat digunakan untuk memvalidasi dampak perubahan status session pada konten. Namun, perlu diperhatikan bahwa jika metode serupa juga dipanggil dalam skrip aplikasi, alur operasi aplikasi mungkin melampaui ekspektasi aplikasi itu sendiri.

Mengontrol komponen session

Untuk menggunakan fungsi kontrol komponen session alat, centang opsi Session Workflow alat sebelum menjalankan. Opsi ini dicentang secara default.

Saat berjalan normal, kontrol komponen session ditampilkan di bagian bawah atau kanan alat yang dilingkari, posisi pastinya bervariasi tergantung lebar jendela:

Konten area ini terkait dengan session tertentu. Misalnya, session yang digunakan pada gambar di atas mencakup tiga komponen fungsi: pelacakan gambar, pemetaan ruang padat, dan pelacakan ruang renggang. Jadi, alat menampilkan tiga kotak pilihan kontrol fungsi ini.

Secara umum, area ini menampilkan semua komponen fungsi AR yang tersedia di session, dan menyediakan kontrol aktif/nonaktif (enabled), termasuk:

• AR Session: Mengontrol aktif/nonaktif session itu sendiri
• Image Renderer: Mengontrol aktif/nonaktif rendering gambar kamera fisik
• Camera: Mengontrol aktif/nonaktif kamera virtual
• Frame Source: Mengontrol aktif/nonaktif frame source, hanya dapat dikontrol jika frame player tidak diaktifkan. Saat frame player diaktifkan, kontrol fungsi digantikan oleh bagian kontrol pemutaran EIF
• Frame Filter: Mengontrol aktif/nonaktif fungsi AR spesifik
• Frame Recorder: Mengontrol aktif/nonaktif komponen perekaman EIF, hanya terlihat jika frame player tidak diaktifkan. Saat frame player diaktifkan, komponen ini tidak akan dirakit ke dalam session

Area ini juga menampilkan mode pusat yang tersedia dan laporan session.

Catatan

Mode pusat yang tersedia dan laporan session yang ditampilkan di alat adalah hasil operasi di editor. Saat dijalankan di perangkat aktual, hasilnya akan berbeda.

Topik terkait

• Coba Menjalankan simulasi menggunakan file EIF, mengontrol pemutaran file EIF melalui skrip
• Coba Mengontrol eksekusi session dalam skrip
• Coba Mengakses komponen fungsi AR dalam skrip
• Coba Mendapatkan hasil operasi session dalam skrip
• Coba Inisialisasi dalam skrip
• Coba Mendapatkan laporan session dan menentukan dukungan perangkat dalam skrip