EasyARSettings.UnityXROptions Class¶

Description¶

与Unity XR Framework相关的配置项。

Classes¶

public class EasyARSettings.UnityXROptions.AutoSwitchOptions

自动切换Unity XR（比如AR Foundation）物体的选项。

Fields¶

ARFoundationSupport¶

C#: public bool ARFoundationSupport

EasyAR AR Foundation支持。建议常开否则使用ARFoundation时EasyAR可能无法正常工作。仅建议在未来AR Foundation更新产生不兼容且EasyAR暂未推出更新时关闭。

UnityXRAutoSwitch¶

C#: public EasyARSettings.UnityXROptions.AutoSwitchOptions UnityXRAutoSwitch

自动切换Unity XR（比如AR Foundation）物体。这个选项主要为移动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组件将在 ARSession.StartSession 时启用（未被EasyAR禁用的不会启用）。如果其他frame source被选择，则在 ARSession.StartSession 时会禁用所有Unity XR Core组件及AR Foundation的组件。

运行时，所有Unity XR Core组件及AR Foundation的组件会在 ARSession.StopSession 时禁用。

需要注意，XR Interaction Toolkit的组件不受该选项控制，但其在EasyAR中是否可用未经验证。理论上对于只使用XROrigin GameObject和其Camera的功能应该可以正常使用，但你可能需要设置 ARSession.CenterMode 为 ARSession.ARCenterMode.SessionOrigin 。如果功能不正常，你需要自己管理XR Interaction Toolkit的组件，在frame source不是继承自 ARFoundationFrameSource 时禁用相关组件。