Table of Contents

Class EasyARSettings.UnityXROptions

名前空間
easyar
アセンブリ
EasyAR.Sense.dll

Unity XR Frameworkに関連する設定項目。

[Serializable]
public class EasyARSettings.UnityXROptions
継承
EasyARSettings.UnityXROptions

フィールド

ARFoundationSupport

EasyAR AR Foundationサポート。常にオンにすることを推奨。無効にするとARFoundation使用時にEasyARが正常に動作しない可能性があります。無効にするのは、将来のAR Foundationアップデートによる非互換性が発生し、かつEasyARがまだアップデートを提供していない場合のみ推奨されます。

[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

Unity XR（例：AR Foundation）オブジェクトの自動切り替え。このオプションは主にモバイルAR向けに設計されており、ヘッドマウントディスプレイではデフォルト設定で機能が無効化されます。

これらのコンポーネントの切り替えを自身で制御する必要がある場合、またはEasyARの動作が特定のコンポーネントの正常な動作を妨げている場合は、これらのオプションを無効にしてください。

ランタイムでAR Foundationを自動切り替えする必要がある場合は、Unityの右クリックメニューからシーン内にAR Foundationの`ARSession`および`XR Origin`を作成し、AR Foundationのカメラを使用する必要があります。

ランタイム中、ARSessionはawake時にすべてのUnity XR CoreコンポーネントおよびAR Foundationコンポーネントを無効化します。

ランタイム中、選択されたフレームソースがARFoundationFrameSourceから継承されているか、XROrigin原点を実装したExternalDeviceFrameSourceである場合、無効化されたUnity XR CoreコンポーネントおよびAR FoundationコンポーネントはStartSession()時に有効化されます（EasyARによって無効化されていないものは有効化されません）。他のフレームソースが選択された場合、StartSession()時にすべてのUnity XR CoreコンポーネントおよびAR Foundationコンポーネントが無効化されます。

ランタイム中、すべてのUnity XR CoreコンポーネントおよびAR FoundationコンポーネントはStopSession(bool)時に無効化されます。

注意点：XR Interaction Toolkitのコンポーネントはこのオプションの制御対象外ですが、EasyAR内での動作保証はありません。理論的には、XROrigin GameObjectとそのCameraのみを使用する機能は正常に動作するはずですが、CenterModeをSessionOriginに設定する必要がある場合があります。正常に動作しない場合は、自身でXR Interaction Toolkitコンポーネントを管理し、フレームソースが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