获取网格扫描信息（C/C++）
本章节给出了关键开发步骤，完整代码可以参考示例代码。
约束与限制
获取网格扫描信息能力支持部分Phone、部分Tablet设备。请参考硬件要求判断设备是否支持运动跟踪及平面识别特性（ARENGINE_FEATURE_TYPE_MESH）。
接口说明
以下接口为AR网格扫描相关接口。详细接口和说明，请参考AR Engine API参考。
开发步骤
开发者可参考管理AR会话章节的引入AR Engine。
声明Native接口
开发者可参考AR物体摆放章节的声明Native接口。
创建UI界面
创建一个UI界面，使用XComponent组件用于显示相机预览画面，并定时触发每一帧绘制。
// 此代码可参考示例代码：ARSample/entry/src/main/ets/pages/ARMesh.ets。
import { deviceInfo } from '@kit.BasicServicesKit';
import { resourceManager } from '@kit.LocalizationKit';
import arEngineDemo from 'libentry.so';
@Builder
export function ARMeshBuilder() {
ARMesh();
}
@Component
struct ARMesh {
pageInfo: NavPathStack = new NavPathStack();
private interval: number = -1;
private xComponentId: string = 'ARMesh';
@State context: Context = this.getUIContext().getHostContext() as Context;
private resMgr: resourceManager.ResourceManager = this.context.resourceManager;
@State rotation: number = deviceInfo.deviceType === 'tablet' ? 3 : 0;
build(): void {
NavDestination() {
RelativeContainer() {
XComponent({ id: this.xComponentId, type: XComponentType.SURFACE, libraryname: 'entry' })
.width('100%')
.height('100%')
.alignRules({
center: { anchor: '__container__', align: VerticalAlign.Center },
middle: { anchor: '__container__', align: HorizontalAlign.Center }
})
.onLoad(() => {
console.info(`XComponent onLoad ${this.xComponentId}.`);
this.interval = setInterval(() => {
// 调用更新Native API来更新AR Engine每帧的计算结果
arEngineDemo.update(this.xComponentId);
}, 33) // 将帧速率设置为30fps（每33ms刷新一次帧）
})
.onDestroy(() => {
console.info(`XComponent onDestroy ${this.xComponentId}.`);
clearInterval(this.interval);
})
}
}
.onAppear(() => {
arEngineDemo.init(this.resMgr);
let config: Int32Array = new Int32Array([1, this.rotation]);
arEngineDemo.start(this.xComponentId, config);
})
.onWillDisappear(() => {
arEngineDemo.stop(this.xComponentId);
})
.onShown(() => {
arEngineDemo.show(this.xComponentId);
})
.onHidden(() => {
arEngineDemo.hide(this.xComponentId);
})
.onReady((context: NavDestinationContext) => {
this.pageInfo = context.pathStack;
})
.hideTitleBar(true)
.hideBackButton(true)
.hideToolBar(true)
}
}
引入AR Engine
开发者可参考AR物体摆放章节的引入AR Engine。
创建AR会话
创建AR会话并配置为开启mesh模式。
AREngine_ARSession *arSession = nullptr;
// 创建AR会话。
HMS_AREngine_ARSession_Create(nullptr, nullptr, &arSession);
AREngine_ARConfig *arConfig = nullptr;
// 创建AR会话配置器。
HMS_AREngine_ARConfig_Create(arSession, &arConfig);
// 设置mesh模式为开启状态。
HMS_AREngine_ARConfig_SetMeshMode(arSession, arConfig, ARENGINE_MESH_MODE_ENABLED);
// 配置器设置给AR会话。
HMS_AREngine_ARSession_Configure(arSession, arConfig);
获取当前环境中的mesh信息
调用HMS_AREngine_ARFrame_AcquireSceneMesh函数，获取当前环境中的mesh信息，并将结果存放在sceneMesh中。
AREngine_ARFrame *arFrame = nullptr;
// 创建AR单帧对象
HMS_AREngine_ARFrame_Create(arSession, &arFrame);
AREngine_ARSceneMesh *sceneMesh = nullptr;
// 获取当前帧的mesh信息
HMS_AREngine_ARFrame_AcquireSceneMesh(arSession, arFrame, &sceneMesh);
获取当前mesh信息对应的mesh顶点信息
-
调用HMS_AREngine_ARSceneMesh_AcquireVerticesSize函数，获取mesh顶点信息包含的浮点数数量，每三个浮点数组成一个mesh顶点，将结果存放在meshVerticesSize 中。
int32_t meshVerticesSize = 0;// 获取mesh顶点信息包含的浮点数数量HMS_AREngine_ARSceneMesh_AcquireVerticesSize(arSession, sceneMesh, &meshVerticesSize); -
调用HMS_AREngine_ARSceneMesh_AcquireVertexList函数，获取mesh顶点信息，并将结果保存在meshVertices中。
float *meshVertices = new float[meshVerticesSize];// 获取mesh顶点信息HMS_AREngine_ARSceneMesh_AcquireVertexList(arSession, sceneMesh, meshVertices, meshVerticesSize);// 获取mesh顶点个数int32_t mPointsNum = meshVerticesSize / 3;
获取当前mesh信息对应的mesh面片信息
-
调用HMS_AREngine_ARSceneMesh_AcquireIndexListSize函数，获取mesh面片信息对应顶点的索引个数，每三个顶点索引表示一个mesh面片，将结果存放在triangleIndicesSize 中。
int32_t triangleIndicesSize = 0;// 获取mesh面片信息对应顶点的索引个数HMS_AREngine_ARSceneMesh_AcquireIndexListSize(arSession, sceneMesh, &triangleIndicesSize); -
调用HMS_AREngine_ARSceneMesh_AcquireIndexList函数，获取mesh面片信息对应顶点的索引列表，并将结果保存在meshTriangleIndices中。
int32_t *meshTriangleIndices = new int32_t[triangleIndicesSize];// 获取mesh面片信息对应顶点的索引列表HMS_AREngine_ARSceneMesh_AcquireIndexList(arSession, sceneMesh, meshTriangleIndices, triangleIndicesSize);// 获取mesh面片个数int32_t mTrianglesNum = triangleIndicesSize / 3;
使用完毕后，销毁mesh信息
void HMS_AREngine_ARSceneMesh_Release(AREngine_ARSceneMesh *sceneMesh);