本章节介绍如何通过AR Engine进行平面检测。通过学习本章节,您可以检测当前环境中的平面,并在您的应用中处理这些平面。
创建ARSession
您可以参考管理AR会话创建ARSession。
创建平面对象列表
- 创建一个平面对象列表planeList,用于存放AR Engine运行过程中检测到的所有平面。
- AREngine_ARTrackableList *planeList = nullptr;
- HMS_AREngine_ARTrackableList_Create(arSession, &planeList);
- 设置可跟踪对象类型为ARENGINE_TRACKABLE_PLANE。
- AREngine_ARTrackableType planeTrackedType = ARENGINE_TRACKABLE_PLANE;
识别当前环境中的平面
调用HMS_AREngine_ARSession_GetAllTrackables函数,检测当前环境中的所有平面,并将结果存放在planeList中。
- HMS_AREngine_ARSession_GetAllTrackables(arSession, planeTrackedType, planeList);
获取平面数量
调用HMS_AREngine_ARTrackableList_GetSize函数获取平面数量,结果存放在planeListSize中。
- int32_t planeListSize = 0;
- HMS_AREngine_ARTrackableList_GetSize(arSession, planeList, &planeListSize);
在您的应用环境中,可能存在0个、1个或多个平面。
当planeListSize等于0时,表示当前环境中不存在平面。
当planeListSize等于1时,表示当前环境中仅存在1个平面。
当planeListSize大于1时,表示当前环境中存在多个平面。
获取平面实例
当存在1个或多个平面时,您可以依次遍历planeList获取所有平面对象。
- for (int i = 0; i < planeListSize; ++i) {
- // 遍历所有平面对象,根据您的应用进行处理。
- }
对于第i个平面,创建并获取可跟踪对象,并将其转化为平面对象AREngine_ARPlane。
- AREngine_ARTrackable *arTrackable = nullptr;
- HMS_AREngine_ARTrackableList_AcquireItem(arSession, planeList, i, &arTrackable);
- AREngine_ARPlane *arPlane = reinterpret_cast<AREngine_ARPlane*>(arTrackable);
说明
AR Engine中,任何物体都被定义为可跟踪对象AREngine_ARTrackable。平面也是一种可跟踪对象,您可以通过类型转换reinterpret_cast将可跟踪对象AREngine_ARTrackable转化为平面对象AREngine_ARPlane。
销毁平面对象列表
- HMS_AREngine_ARTrackableList_Destroy(planeList);