Menambahkan grup sumber data frame
Sebuah AR Session dapat berisi beberapa komponen sumber data frame, yang disebut grup sumber data frame (frame source group). Saat runtime, session akan memilih sumber data frame yang paling sesuai dari grup sumber data frame berdasarkan perangkat saat ini dan fitur AR yang diaktifkan. Artikel ini menjelaskan cara menggunakan dan mengelola grup sumber data frame.
Sebelum memulai
- Pahami konsep dasar, jenis, dan metode pemilihan saat runtime sumber data frame.
Menggunakan grup sumber data frame dari sesi AR yang telah ditentukan
Session yang dibuat dengan konfigurasi default dilengkapi dengan grup sumber data frame bawaan, yang umumnya cukup saat menggunakan satu fitur AR.
Sesi yang telah ditentukan berbeda mengandung sumber data frame yang berbeda.
Menggunakan preset ARSessionFactory.ARSessionPreset.ImageTracking atau menu
AR Session (Image Tracking Preset)untuk membuat session yang hanya berisi satu sumber data frame:
Menggunakan preset ARSessionFactory.ARSessionPreset.MegaBlock_MotionTracking_Inertial atau menu
AR Session (Mega Block Default Preset)untuk membuat session yang berisi beberapa struktur hierarki komponen sumber data frame:
Jika adegan awalnya menggunakan preset untuk membuat session, saat menambahkan fitur lain selama iterasi, tidak hanya perlu menambahkan komponen frame filter yang sesuai, tetapi juga menambahkan komponen sumber data frame yang sesuai sesuai kebutuhan.
Penting
Setelah peningkatan dari versi 4.7 atau lebih rendah, perlu menghapus seluruh session dan membuat ulang session melalui menu atau ARSessionFactory untuk dapat menggunakan grup sumber data frame preset.
Berikut adalah komponen sumber data bingkai untuk semua konfigurasi prasetel fitur AR default. Perhatikan bahwa urutan dalam daftar ini sama dengan urutan komponen sumber data bingkai di dalam adegan:
| Prasetel | Komponen sumber data bingkai |
|---|---|
Catatan
Pengurutan komponen yang dibuat menggunakan preset memastikan penggunaan sumber data frame optimal pada semua perangkat yang didukung sumber data frame bawaan.
Menggunakan konfigurasi sumber data frame default
Saat menggunakan parameter default, konfigurasi sumber data frame akan disesuaikan secara otomatis berdasarkan perangkat dan fitur AR yang diaktifkan saat runtime.
Jika parameter sumber data frame diubah secara manual, saat fitur AR dalam session berubah (misalnya menambahkan fitur pelacakan gerak ke session yang awalnya hanya berisi pelacakan gambar), mungkin perlu menyesuaikan parameter sumber data frame secara manual untuk memenuhi kebutuhan fitur baru, agar semua fitur AR dapat berjalan dengan efek terbaik.
Penting
Setelah peningkatan dari versi 4.7 atau lebih rendah, perlu menghapus seluruh session dan membuat ulang session melalui menu atau ARSessionFactory untuk dapat menggunakan parameter default yang benar.
Menambahkan grup sumber data frame
Dalam tampilan Hierarchy, pilih AR Session (EasyAR), klik kanan, dan melalui menu EasyAR Sense > [ Fitur AR ] > Frame Source : * dapat menambahkan komponen frame source yang cocok untuk fitur tersebut. Juga dapat melalui menu EasyAR Sense > Frame Source by Transform Type > * Dof > Frame Source : * untuk menambahkan komponen frame source yang dibutuhkan.
Dalam skrip, dapat menggunakan ARSessionFactory.AddFrameSource<Source>(GameObject, bool) untuk menambahkan komponen frame source.
Misalnya, melalui menu EasyAR Sense > Frame Source by Transform Type > 3 Dof Rot-Only > Frame Source : Three Dof Camera Device dapat menambahkan ThreeDofCameraDeviceFrameSource ke session yang saat ini dipilih.
Kode skrip yang sesuai adalah:
ARSessionFactory.AddFrameSource<ThreeDofCameraDeviceFrameSource>(session);
Pengurutan sumber data frame
Selama proses perakitan session, hanya satu sumber data frame dalam grup sumber data frame yang akan dipilih dan dirakit ke session, aturan pemilihannya bergantung pada nilai properti AssembleOptions.FrameSourceSelection. Dalam konfigurasi default, pengurutan komponen dalam grup sumber data frame dapat disesuaikan untuk memengaruhi sumber data frame yang akhirnya dipilih.
Umumnya dapat menggunakan metode mengurutkan objek dalam adegan dalam tampilan Hierarchy untuk langsung memindahkan objek frame source untuk mengurutkannya.
Dalam skrip, dapat menggunakan Transform.SetSiblingIndex(int) untuk menyesuaikan urutan objek.
Misalnya, untuk menempatkan MotionTrackerFrameSource di depan sumber data frame lain, dapat memilih objek Motion Tracker dalam tampilan Hierarchy dan menariknya ke posisi paling atas.
Efek yang sama juga dapat dicapai dengan kode skrip berikut:
motionTrackerFrameSource.transform.SetSiblingIndex(0);
Selain itu, ada beberapa metode pengurutan yang telah ditentukan yang dapat digunakan. Dalam tampilan Hierarchy, pilih AR Session (EasyAR), klik kanan, dan melalui menu EasyAR Sense > Utility > Sort Frame Source : * > * untuk mengurutkan beberapa komponen sumber data frame tertentu.
Dalam skrip, dapat menggunakan ARSessionFactory.SortFrameSource(GameObject, ARSessionFactory.FrameSourceSortMethod) untuk mencapai efek yang sama.
Misalnya, melalui menu EasyAR Sense > Utility > Sort Frame Source : Motion Tracker > System SLAM dapat menempatkan MotionTrackerFrameSource di depan ARCoreFrameSource, ARCoreARFoundationFrameSource, ARKitFrameSource, ARKitARFoundationFrameSource, dan AREngineFrameSource.
Kode skrip yang sesuai adalah:
ARSessionFactory.SortFrameSource(session, new ARSessionFactory.FrameSourceSortMethod { MotionTracker = ARSessionFactory.FrameSourceSortMethod.MotionTrackerSortMethod.PreferEasyAR });
Setelah pengurutan di atas, struktur hierarki adegan menjadi:
