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

AR Foundation オブジェクトなどの Unity XR オブジェクトを自動的に切り替えます。このオプションは主にモバイル AR 向けに設計されており、ヘッドセットではデフォルト設定で機能が無効になります。

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

実行時に AR Foundation を自動的に切り替える必要がある場合は、Unity の右クリックメニューからシーンに AR Foundation の `ARSession` と `XR Origin` を作成し、AR Foundation のカメラを使用する必要があります。

実行時、ARSession は awake で Unity XR Core コンポーネントおよび AR Foundation コンポーネントをすべて無効にします。

実行時、選択された frame source が ARFoundationFrameSource を継承しているか、XROrigin 原点を実装した ExternalDeviceFrameSource である場合、無効化された Unity XR Core コンポーネントおよび AR Foundation コンポーネントは StartSession() 時に有効化されます（EasyAR によって無効化されていないものは有効化されません）。他の frame source が選択されている場合、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 のコンポーネントを自分で管理し、frame source が 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