## 概要

从5.0.0(12)开始，AR Engine支持检测环境中的平面能力。

本章节介绍如何通过AR Engine进行平面检测。通过学习本章节，开发者可以检测当前环境中的平面，并在应用中处理这些平面。

## 引入AR Engine

开发者可参考管理AR会话章节的[引入AR Engine](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arengine-c-arsession#section1410827131110)。

## 创建ARSession

开发者可以参考[管理AR会话](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arengine-c-arsession)创建ARSession。

## 创建平面对象列表

1. 创建一个平面对象列表planeList，用于存放AR Engine运行过程中检测到的所有平面。

   收起

   自动换行

   深色代码主题

   复制

   ```
   1. AREngine_ARTrackableList *planeList = nullptr;
   2. HMS_AREngine_ARTrackableList_Create(arSession, &planeList);
   ```
2. 设置可跟踪对象类型为ARENGINE\_TRACKABLE\_PLANE。

   收起

   自动换行

   深色代码主题

   复制

   ```
   1. AREngine_ARTrackableType planeTrackedType = ARENGINE_TRACKABLE_PLANE;
   ```

## 识别当前环境中的平面

调用[HMS\_AREngine\_ARSession\_GetAllTrackables](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arengine-capi-arengine#gac5b39338f95317671d8de6d4f409cf9c)函数，检测当前环境中的所有平面，并将结果存放在planeList中。

收起

自动换行

深色代码主题

复制

```
1. HMS_AREngine_ARSession_GetAllTrackables(arSession, planeTrackedType, planeList);
```

## 获取平面数量

调用[HMS\_AREngine\_ARTrackableList\_GetSize](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arengine-capi-arengine#gad9729d4436f3d969286f31b33d07513e)函数获取平面数量，结果存放在planeListSize中。

收起

自动换行

深色代码主题

复制

```
1. int32_t planeListSize = 0;
2. HMS_AREngine_ARTrackableList_GetSize(arSession, planeList, &planeListSize);
```

在应用环境中，可能存在0个、1个或多个平面。

当planeListSize等于0时，表示当前环境中不存在平面。

当planeListSize等于1时，表示当前环境中仅存在1个平面。

当planeListSize大于1时，表示当前环境中存在多个平面。

## 获取平面实例

当存在1个或多个平面时，可以依次遍历planeList获取所有平面对象。

收起

自动换行

深色代码主题

复制

```
1. for (int i = 0; i < planeListSize; ++i) {
2. // 遍历所有平面对象，根据您的应用进行处理。
3. }
```

对于第i个平面，创建并获取可跟踪对象，并将其转化为平面对象[AREngine\_ARPlane](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arengine-capi-arengine#ga76f9bdb23634312b8488fcbaff4aa9b5)。

收起

自动换行

深色代码主题

复制

```
1. AREngine_ARTrackable *arTrackable = nullptr;
2. HMS_AREngine_ARTrackableList_AcquireItem(arSession, planeList, i, &arTrackable);
3. AREngine_ARPlane *arPlane = reinterpret_cast<AREngine_ARPlane*>(arTrackable);
```

说明

AR Engine中，任何物体都被定义为可跟踪对象[AREngine\_ARTrackable](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arengine-capi-arengine#ga54808ebd1a6ed026494acdd945c4f970)。平面也是一种可跟踪对象，开发者可以通过类型转换reinterpret\_cast将可跟踪对象[AREngine\_ARTrackable](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arengine-capi-arengine#ga54808ebd1a6ed026494acdd945c4f970)转化为平面对象[AREngine\_ARPlane](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arengine-capi-arengine#ga76f9bdb23634312b8488fcbaff4aa9b5)。

## 销毁平面对象列表

收起

自动换行

深色代码主题

复制

```
1. HMS_AREngine_ARTrackableList_Destroy(planeList);
```