AR Engine简介
===========

AR Engine（AR引擎服务）是一个用于在HarmonyOS上构建增强现实应用的引擎，提供了运动跟踪、环境跟踪等空间计算能力。

#### 能力介绍

AR Engine主要包含运动跟踪与平面识别特性、平面语义及物体语义特性、环境Mesh识别特性、深度估计特性、图像跟踪特性、高精几何重建特性、人脸识别与跟踪特性、人体骨骼点识别与跟踪特性、手势和手部骨骼点识别与跟踪特性。

通过这些能力，应用可以实现虚拟世界与现实世界的融合，给用户提供全新的视觉体验和交互方式。

#### \[h2\]环境识别与运动跟踪能力

*   [运动跟踪](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arengine-get-pose-conversion)：实时获取设备位置和姿态
*   [平面识别](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arengine-get-plane-conversion)：识别环境中的平面
*   [命中检测](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arengine-arworld-conversion)：获取碰撞检测结果后可以在识别的平面上放置虚拟物体
*   [平面语义](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arengine-get-semantics-conversion)：识别环境中的平面类型
*   [物体语义](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arengine-get-plane-shape-conversion)：识别平面上的物体形状
*   [环境Mesh识别](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arengine-get-mesh-conversion)：获取环境Mesh数据
*   [深度估计](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arengine-get-depth-conversion)：获取环境的深度信息
*   [高精几何重建](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arengine-get-volume-measurement-conversion)：输出环境中的稠密点云，识别立方体、嵌入式立方体空间

#### \[h2\]人体骨骼识别与跟踪能力

*   [人体骨骼点识别与跟踪](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arengine-body-conversion)：识别环境中的人体骨骼点信息

#### \[h2\]人脸识别与跟踪能力

*   [人脸识别与跟踪](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arengine-face-conversion)：识别环境中的人脸信息

#### \[h2\]图像识别与跟踪能力

*   [图像跟踪](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arengine-get-image-track-conversion)：识别环境中已预置在AR Engine中的图像并输出图像位置和姿态

#### 坐标系说明

#### \[h2\]AR Engine重力对齐世界坐标系

*   以相机启动时相机中心为坐标原点；
    
*   重力方向为Y轴，向上+Y，向下-Y；
    
*   设备水平前后移动为X轴，由近及远+X，由远及近-X；
    
*   设备水平左右移动为Z轴，向右+Z，向左-Z。
    

**图12** 重力对齐世界坐标系示意图

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/fc/v3/YMrq0ZXnQn6MP4S-PT9glQ/zh-cn_image_0000002625188263.png?HW-CC-KV=V1&HW-CC-Date=20260612T073530Z&HW-CC-Expire=86400&HW-CC-Sign=EA4FC95C5D386D7F4C539755196C682780E9BEBCF55357F2AE415881A560F1DA)

#### \[h2\]AR Engine重力对齐北向坐标系

*   以相机启动时相机中心为坐标原点；
    
*   重力方向为Y轴，向上+Y，向下-Y；
    
*   指南针北向为+X轴，南向为-X轴；
    
*   指南针东向为+Z轴，西向为-Z轴；
    
*   重力对齐北向坐标系为固定坐标系，不受设备位姿变化影响。
    

**图13** 重力对齐北向坐标系示意图

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/81/v3/5Ylgb106QvOHdM4q6rrASQ/zh-cn_image_0000002625108407.png?HW-CC-KV=V1&HW-CC-Date=20260612T073530Z&HW-CC-Expire=86400&HW-CC-Sign=1790789C2F00C09E27AC3ACDF5F05ECF950E46B98DC0D4610537604E1CFD2148)

#### \[h2\]AGP世界坐标系

*   以相机启动时相机中心为坐标原点；
    
*   设备垂直方向为Y轴，向上+Y，向下-Y；
    
*   设备水平前后移动为Z轴，向前+Z，向后-Z；
    
*   设备水平左右移动为X轴，向左+X，向右-X。
    

**图14** AGP世界坐标系示意图

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/1c/v3/ZLRlkSAZT7yeVcWs5IaXeQ/zh-cn_image_0000002625188263.png?HW-CC-KV=V1&HW-CC-Date=20260612T073530Z&HW-CC-Expire=86400&HW-CC-Sign=9E9B41CA469DDCDC8B8FE001CAB832876668B4CD6931D2DBE84B70D2BD2B5653)

#### 约束与限制

*   在调用AR Engine能力前，需要先通过[canIUse](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/syscap#使用caniuse判断syscap是否可调用)查询您的目标设备是否支持SystemCapability.AREngine.Core系统能力。
    
*   支持的设备类型：Phone、Tablet。从6.1.0(23)版本开始，新增支持TV。
    
*   不同设备支持的特性范围有所差异，可以通过以下方式查询设备是否支持对应的特性：
    
    *   对于C API，使用[HMS\_AREngine\_CheckSupported](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arengine-capi-arengine#hms_arengine_checksupported)拓展特性查询接口进行查询。
    *   对于ArkTS API，使用[arViewController.isARTypeSupported](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arengine-api-arviewcontroller#arviewcontrollerisartypesupported)拓展特性查询接口进行查询。
    
    两种方式均返回对应的特性是否支持，具体使用方式参考各个特性的示例代码。
    
*   支持机型的产品型号也可以参考[社区问答贴](https://developer.huawei.com/consumer/cn/forum/topic/0204192741933553355?fid=0104164651529951067)。
    

#### 支持的国家/地区

本Kit当前仅支持在中国境内（香港特别行政区、澳门特别行政区、中国台湾除外）接入使用。

#### 模拟器支持情况

本Kit暂不支持模拟器。