Table of Contents

Class EasyARSettings.UnityXROptions

Ruang Nama
easyar
Rakitan
EasyAR.Sense.dll

Item konfigurasi terkait Unity XR Framework.

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

Bidang

ARFoundationSupport

Dukungan EasyAR AR Foundation. Disarankan untuk selalu diaktifkan, jika tidak EasyAR mungkin tidak berfungsi dengan baik saat menggunakan ARFoundation. Disarankan untuk dinonaktifkan hanya 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

Beralih otomatis objek Unity XR (seperti AR Foundation). Opsi ini terutama dirancang untuk AR seluler, dan fungsinya akan dinonaktifkan secara default pada headset.

Jika Anda perlu mengontrol peralihan komponen ini sendiri, atau perilaku EasyAR mengganggu kerja beberapa komponen, pastikan untuk menonaktifkan opsi ini.

Jika Anda perlu beralih ke 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 akan menonaktifkan semua komponen inti Unity XR dan komponen AR Foundation saat awake.

Saat runtime, jika sumber frame yang dipilih mewarisi dari ARFoundationFrameSource atau mengimplementasikan ExternalDeviceFrameSource dengan titik asal XROrigin, maka komponen inti Unity XR dan komponen AR Foundation yang dinonaktifkan akan diaktifkan saat StartSession() (yang tidak dinonaktifkan oleh EasyAR tidak akan diaktifkan). Jika sumber frame lain dipilih, semua komponen inti Unity XR dan komponen AR Foundation akan dinonaktifkan saat StartSession().

Saat runtime, semua komponen inti Unity XR dan komponen AR Foundation akan dinonaktifkan saat StopSession(bool).

Perhatikan bahwa komponen XR Interaction Toolkit tidak dikendalikan oleh opsi ini, tetapi fungsionalitasnya dengan EasyAR belum diverifikasi. Secara teori, fitur yang hanya menggunakan GameObject XROrigin dan Kameranya seharusnya berfungsi normal, tetapi Anda mungkin perlu mengatur CenterMode ke SessionOrigin. Jika tidak berfungsi dengan baik, Anda perlu mengelola komponen XR Interaction Toolkit sendiri, menonaktifkan komponen terkait saat sumber frame bukan berasal dari 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