AR Manager

Cocos CreatorXR的AR模块提供了一个全局管理器，用于收集当前项目使用到的AR特性并进行管理，特性管理器中每个特性的属性都是全局属性，调整参数会修改设备相关的或者项目全局的功能。cc.ARManager默认挂载在XR Agent节点上，当您创建AR自动化行为节点时，ARManager会收集此节点到其对应的特性列表中，方便后续管理和维护所有特性节点。

当前版本针对以支持的AR特性提供了对应的全局功能属性：

平面追踪特性

当您在场景中创建一个或多个Plane Tracking节点，AR Manager中的Configuration会新增Plane Feature属性。您可以调整特性下的各项参数，或定位到对应的特性节点。

Direction Type汇集了当前场景所有平面代理需要识别的平面朝向。

Tracking Visualizer给所有平面代理创建默认的可视化模型。

Tracking Quality Condition表示当前可追踪的平面代理的最差质量，当稳定性质量小于此值时，平面不被可视化。

Use Plane Shape开启后可视化效果会根据现实环境中平面的真实物理性状使用多边形绘制，关闭后则使用四边形绘制代替。

Unsupported Event会在设备不支持平面追踪时触发，用户可以根据需求添加事件。

图像追踪特性

当您在场景中创建一个或多个Image Tracking节点，AR Manager中的Configuration会新增Image Feature属性。您可以调整特性下的各项参数，或定位到对应的特性节点。

Max Tracking Number表示当前镜头内可同时追踪图片的最大数量，可以根据需要动态修改此值。

注：Max Tracking Number 的上限根据设备平台会有差异，目前已知

● ARCore 平台可同时追踪最多 20 张图，单图像库存最多 1000 张。

● ARKit 平台可同时追踪最多 4 张图，单图像库最多 100张。

● AREngine 平台可同时追踪最多1张图。

Unsupported Event会在设备不支持图像追踪时触发，用户可以根据需求添加事件。

网格化特性（实验性）

当您在场景中创建一个或多个Meshing 节点，AR Manager中的Configuration会新增Meshing Feature属性。由于Meshing功能处于实验性阶段且支持环境重构的设备硬件要求较高，暂不支持对此做特性做参数控制。

Meshing Feature

Normals默认开启，可以根据Mesh信息获取法线向量。

AR Manager还提供了控制特性开关以及特性可视化开关的接口：

public enableFeatureTracking (type: ARTrackingType, enable: boolean) {
        this.configuration.setFeatureEnable(type, enable);

        if (this._systemsMap.has(type)) {
            const system = this._systemsMap.get(type)!;
            system.enableFeature(enable);
        }
}

public showAllVisualizer (type: ARTrackingType) {
    if (this._systemsMap.has(type)) {
        const system = this._systemsMap.get(type);
        (system as any as IExtraDisplay)?.showAllVisualizer();
    }
}

public hideAllVisualizer (type: ARTrackingType) {
    if (this._systemsMap.has(type)) {
        const system = this._systemsMap.get(type);
        (system as any as IExtraDisplay)?.hideAllVisualizer();
    }
}