Table of Contents

Class EasyARSettings.UnityXROptions

Ruang Nama
easyar
Rakitan
EasyAR.Sense.dll

Opsi konfigurasi yang terkait dengan Unity XR Framework.

[Serializable]
public class EasyARSettings.UnityXROptions
Pewarisan
EasyARSettings.UnityXROptions

Bidang

ARFoundationSupport

Dukungan EasyAR AR Foundation. Disarankan untuk selalu mengaktifkannya; jika tidak, EasyAR mungkin tidak bekerja dengan benar saat ARFoundation digunakan. Menonaktifkannya hanya disarankan jika pembaruan AR Foundation di masa depan menyebabkan ketidakcocokan dan EasyAR belum merilis pembaruan.

[Tooltip("EasyAR AR Foundation Support. It is recommended to keep this enabled; otherwise, EasyAR may not work properly with AR Foundation. Disable only if a future AR Foundation update causes incompatibility and EasyAR has not yet provided an update.")]
public bool ARFoundationSupport

UnityXRAutoSwitch

Secara otomatis mengganti objek Unity XR, seperti objek AR Foundation. Opsi ini terutama dirancang untuk AR seluler, dan fitur ini dinonaktifkan secara default pada headset.

Jika Anda perlu mengontrol sendiri penggantian komponen ini, atau jika perilaku EasyAR mengganggu operasi normal komponen tertentu, pastikan opsi ini dinonaktifkan.

Jika Anda perlu mengganti AR Foundation secara otomatis saat runtime, Anda perlu membuat `ARSession` dan `XR Origin` AR Foundation di scene melalui menu klik kanan Unity dan menggunakan kamera AR Foundation.

Saat runtime, ARSession menonaktifkan semua komponen Unity XR Core dan komponen AR Foundation pada awake.

Saat runtime, jika frame source yang dipilih mewarisi ARFoundationFrameSource atau merupakan ExternalDeviceFrameSource yang mengimplementasikan origin XROrigin, komponen Unity XR Core dan AR Foundation yang dinonaktifkan akan diaktifkan selama StartSession() (komponen yang tidak dinonaktifkan oleh EasyAR tidak akan diaktifkan). Jika frame source lain dipilih, semua komponen Unity XR Core dan AR Foundation akan dinonaktifkan selama StartSession().

Saat runtime, semua komponen Unity XR Core dan komponen AR Foundation dinonaktifkan selama StopSession(bool).

Perlu diperhatikan bahwa komponen XR Interaction Toolkit tidak dikontrol oleh opsi ini, dan ketersediaannya di EasyAR belum diverifikasi. Secara teori, fitur yang hanya menggunakan XROrigin GameObject dan Camera-nya seharusnya dapat bekerja normal, tetapi Anda mungkin perlu mengatur CenterMode ke SessionOrigin. Jika fitur tidak bekerja dengan benar, Anda perlu mengelola sendiri komponen XR Interaction Toolkit dan menonaktifkan komponen terkait ketika frame source tidak mewarisi ARFoundationFrameSource.

[Tooltip("Auto switch Unity XR (like AR Foundation) objects. This option is primarily designed for mobile AR. On head-mounted devices, the feature will be disabled by default. If you need to manually control the switching of these components, or if EasyAR's behavior interferes with the normal operation of certain components, make sure to disable these options. Please read API documents for more details.")]
public EasyARSettings.UnityXROptions.AutoSwitchOptions UnityXRAutoSwitch