(高清版)GB∕T 44247-2024 信息技术 增强现实 软件构件接口

国家市场监督管理总局国家标准化管理委员会GB/T44247—2024 Ⅲ 12规范性引用文件 1 1 25.1接口分类 25.2接口调用流程 26.1会话接口 26.2配置接口 66.3相机接口 7帧数据类接口 7.1帧画面接口 7.2图像接口 7.3图像元数据接口 8可跟踪物体类接口 8.1锚点接口 8.2点接口 8.3点云接口 8.4平面接口 8.5可跟踪接口 8.6图像增强接口 8.7图像数据库接口 8.8稀疏空间地图接口 8.9面部增强接口 9碰撞检测类接口 9.1检测实体管理接口 9.2测量接口 9.3检测结果引用接口 10.1光照估计接口 附录A(规范性)特殊数据类型定义 附录B(规范性)枚举数据类型定义 参考文献 IⅢ1GB/T44247—2024信息技术增强现实软件构件接口1范围本文件规定了用于增强现实的软件构件接口，包括会话类接口、帧数据类接口、可追踪物体类接口、碰撞检测类接口和环境理解类接口。本文件适用于增强现实软件构件接口的表示与应用。2规范性引用文件本文件没有规范性引用文件。3术语和定义下列术语和定义适用于本文件。3.1署的可组装软件实体。软件构件对外交流和交互的唯一通道。3.3采用以计算机为核心的现代高科技手段生成的附加信息对使用者感知到的真实世界进行增强的环境，生成的附加信息以融合的方式叠加至真实场景中。增强现实会话augmentedrealitysession增强现实中管理各部分运行的消息机制。3.5面部增强augmentedface4缩略语下列缩略语适用于本文件。AR:增强现实(AugmentedReality)CPU:中央处理器(CentralProcessingUnit)GPU:圆形处理器(GraphicsProcessingUnit)HDR:高动态范围(HighDynamicRange)2ID:唯一编码(IdentityDocument)5构件接口接口。各类接口间的关系见图1。些数据是AR应用中进行环境理解和物体跟踪的基础数据。可跟踪物体类接口是AR应用中用于识别和跟踪用户环境中的特定物体或标记的接口，与会话类用户体验。同时碰撞检测类接口需与会话类接口和环境理解类接口是AR应用中用于理解和分析用户环境的接口，包括对环境的光照估计等。环境碰撞检测类接口实时处理帧数据类接口提供的环境理解类接口实时分析可跟踪物体类和碰撞检测类接口，感知用户的环境并提供相应的AR各类接口中涉及的数据类型应符合附录A和附录B。6.1会话接口参考接口定义：ArStatusArSessioncreate(void*env,void*context,ArSessio3参数名类型说明void*表示运行环境的指针contextvoid*表示运行上下文的指针out_session_pointerArSession**指向ArSession指针的指针，以接收新分配的会话的地址SessionFeature*features,ArSession**out_session_pointer)。参数名类型说明表示运行环境的指针context表示运行上下文的指针ArSessionFeature*指向请求的功能列表的指针ArSession**指向ArSession指针的指针，以接收新分配的会话的地址参数名类型说明ArSession*增强现实会话指针表4设置增强现实会话配置参数说明参数名类型说明ArSession*增强现实会话指针configArConfig*增强现实会话的新配置设置指针4参数名类型说明sessionArSession*增强现实会话指针out_configArConfig*增强现实会话的新配置设置指针参数名类型说明ArSession*增强现实会话指针参数名类型说明ArSession*增强现实会话指针参考接口定义：ArStatusArSession_hostAndAcquireNewCloudAnchor(ArSession*session,constArAnchor*anchor,ArAnchor**outcloudanchor)。参数名类型说明sessionArSession*增强现实会话指针anchorArAnchor*锚点指针outcloudanchorArAnchor**指向ArAnchor指针的指针，以接收新分配的云锚点地址5anchor_list)。参数名类型说明ArSession*增强现实会话指针outanchorlistArAnchorList*所有的锚点列表指针char*cloud_anchor_id,ArAnchor**out_cloud_anchor)。表10解析锚的位姿参数说明参数名类型说明ArSession*增强现实会话指针云锚点的ID指针ArAnchor**指向ArAnchor指针的指针，以接收新分配的云锚点的地址filter_type,ArTrackableList*out_trackable_list)。表11获取所有可跟踪的对象参数说明参数名类型说明sessionArSession*增强现实会话指针filtertypeArTrackableType可跟踪对象类型outtrackablelistArTrackableList*指向符合类型的可跟踪对象列表的指针pose,ArAnchor**out_anchor)。6参数名类型说明sessionArSession*增强现实会话指针poseArPose*位姿指针outanchorArAnchor**指向ArAnchor指针的指针，以接收新分配锚点地址表13创建配置参数说明参数名类型说明sessionArSession*增强现实会话指针out_configArConfig**指向ArConfig指针的指针，以接收新分配的配置指针表14销毁配置参数说明参数名类型说明ArConfig*配置指针参数名类型说明ArSession*增强现实会话指针ArConfig*配置指针focusmodeArFocusMode×对焦模式指针7config,ArAugmentedFaceModeaugmented_face_mode)。参数名类型说明ArSession*增强现实会话指针ArConfig*配置指针augmentedfacemodeArAugmentedFaceMode面部增强模式Config*config,ArAugmentedFaceMode*augmented_face_mode)。参数名类型说明sessionArSession*增强现实会话指针configArConfig*配置指针augmentedfacemodeArAugmentedFaceMode*面部增强模式指针config,constArAugmentedImageDatabase*augmented_image_database)。表18设置图像数据库参数说明参数名类型说明ArSession*增强现实会话指针ArConfig*配置指针augmentedimagedatabArAugmentedImageDatabase*图像数据库指针config,ArCloudAnchorMode*out_cloud_anchor_mode)。8表19获取云锚点模式参数说明参数名类型说明ArSession*增强现实会话指针ArConfig*配置指针ArCloudAnchorMode*云锚点模式指针config,ArCloudAnchorModecloud_anchor_mode)。表20设置云锚点模式参数说明参数名类型说明sessionArSession*增强现实会话指针configArConfig*配置指针cloudanchormodeArCloudAnchorMode云锚点模式config,ArDepthMode*out_depth_mode)。表21获取深度模式参数说明参数名类型说明ArSession*增强现实会话指针ArConfig*配置指针ArDepthMode*深度模式指针Modemode)。9表22设置深度模式参数说明参数名类型说明sessionArSession*增强现实会话指针configArConfig*配置指针modeArDepthMode深度模式表23获取相机对焦模式参数说明参数名类型说明ArSession*增强现实会话指针ArConfig*配置指针ArFocusMode*相机对焦模式指针ArFocusModefocus_mode)。参数名类型说明sessionArSession*增强现实会话指针configArConfig*配置指针focusmodeArFocusMode相机对焦模式Config*config,ArLightEstimationMode*light_estimation_mode)。表25获取光照模式参数说明参数名类型说明sessionArSession*增强现实会话指针configArConfig*配置指针lightestimationmodeArLightEstimationMode*光照模式指针config,ArLightEstimationModelight_estimation_mode)。表26设置光照模式参数说明参数名类型说明sessionArSession*增强现实会话指针configArConfig*配置指针lightestimationmodeArLightEstimationMode光照模式类型config,ArPlaneFindingMode*plane_finding_mode)。参数名类型说明ArSession*增强现实会话指针configArConfig*配置指针planefindingmodeArPlaneFindingMode*平面模式类型指针config,ArPlaneFindingModeplane_finding_mode)。表28设置平面模式参数说明参数名类型说明ArSession*增强现实会话指针configArConfig*配置指针planefindingmodeArPlaneFindingMode平面模式类型6.3相机接口6.3.1相机内参6.3.1.1创建相机内参out_camera_intrinsics)。功能描述：创建相机内参对象。参数说明见表29。表29创建相机内参参数说明参数名类型说明ArSession*增强现实会话指针ArCameraIntrinsics**指向ArCameraIntrinsics指针的指针，以接收新创建的相机内参对象的地址功能描述：释放提供给相机内参对象使用的内参。参数说明见表30。表30销毁相机内参参数说明参数名类型说明cameraintrinsicsArCameraIntrinsics*相机内参指针参考接口定义：voidArCameraIntrinsicsgetFocalLength(constArSession*session,con功能描述：返回以像素为单位的相机焦距。参数说明见表31。表31获取相机焦距参数说明参数名类型说明sessionArSession*增强现实会话指针intrinsicsArCameraIntrinsics*相机内参指针float*相机的X轴上的焦距指针float*相机的Y轴上的焦距指针ArCameraIntrinsics*intrinsics,int32_t*out_width,int32_t*out_height)。表32获取图像尺寸参数说明参数名类型说明sessionArSession*增强现实会话指针intrinsicsArCameraIntrinsics*相机内参指针outwidth图的宽度指针outheight图的高度指针CameraIntrinsics*intrinsics,float*out_cx,float*表33获取相机主点参数说明参数名类型说明sessionArSession*增强现实会话指针intrinsicsArCameraIntrinsics*相机内参指针outcxfloat*相机主点的X轴坐标指针outcyfloat*相机主点的Y轴坐标指针Camera*camera,ArPose*out_pose)。见表34。参数名类型说明ArSession*增强现实会话指针ArCamera*相机指针out_poseArPose*已经定义了的位姿对象指针camera,ArCameraIntrinsics*out_camera_intrinsics)。参数名类型说明ArSession*增强现实会话指针ArCamera*相机指针ArCameraIntrinsics*相机内参对象指针参考接口定义：voidArCamera_getPose(constArSession*session,constArCamera*camera,ArPose*out_pose)。表36获取相机位姿参数说明参数名类型说明ArSession*增强现实会话指针ArCamera*相机指针out_poseArPose*已经定义了的位姿对象指针camera,floatnear,floatfar,float*dest_col_major_4×4)。参数名类型说明sessionArSession*增强现实会话指针cameraArCamera*相机指针nearfloat指定近相机平面float指定远相机平面destcolmajor4×4float*4×4的投影矩阵指针camera,ArCameraIntrinsics*out_camera_intrinsics)。表38获取纹理流内部参数说明参数名类型说明ArSession*增强现实会话指针ArCamera*相机指针outcameraintrinsicsArCameraIntrinsics*相机内参对象指针Camera*camera,ArTrackingFailureReason*out_tracking_failure_reason)。参数名类型说明ArSession*增强现实会话指针ArCamera*相机指针outtrackingfailurereasonArTrackingFailureReason*相机跟踪失败原因指针camera,ArTrackingState*out_tracking_state)。参数名类型说明sessionArSession*增强现实会话指针ArCamera*相机指针outtrackingstateArTrackingState×相机的跟踪状态指针camera,float*out_col_major_4×4)。参数名类型说明ArSession*增强现实会话指针ArCamera*相机指针4×4的视图矩阵指针表42销毁相机参数说明参数名类型说明ArCamera*相机指针depth_mode,int32_t*out_is_supported)。参数名类型说明ArSession*增强现实会话指针depthmodeArDepthMode需要检查的深度模式如果当前设备支持深度模式，则返回非零值out_camera_config)。表44创建相机配置参数说明参数名类型说明ArSession*增强现实会话指针out_camera_configArCameraConfig**指向ArCameraConfig指针的指针，以接收新创建的相机配置对象的地址out_camera_config)。参数名类型说明ArSession*增强现实会话指针out_camera_configArCameraConfig*相机配置指针表46销毁相机配置参数说明参数名类型说明cameraconfigArCameraConfig*相机配置指针表47创建相机配置列表参数说明参数名类型说明ArSession*增强现实会话指针ArCameraConfigList**指向ArCameraConfigList指针的指针，以接收新创建的相机创建列表对象的地址session,constArCameraConfigFilter×filter,ArCameraConfigList*list)。参数名类型说明ArSession*增强现实会话指针ArCameraConfigFilter*相机配置过滤器指针ArCameraConfigList*指向支持的相机配置列表的指针Config*camera_config,int32_tindex,ArCameraConfig*out_camera_config)。参数名类型说明ArSession*增强现实会话指针ArCameraConfig*相机配置指针索引值out_camera_configArCameraConfig*相机配置对象指针Config*camera_config,int32_t*out_size)。表50获取相机配置数量参数说明参数名类型说明sessionArSession*增强现实会话指针cameraconfigArCameraConfig*相机配置指针相机配置的数量指针6.3.3.8销毁相机配置列表表51。表51销毁相机配置列表参数说明参数名类型说明ArCameraConfigList*相机配置列表指针6.3.3.9获取深度传感器使用配置ArCameraConfig*camera_config,uint32_t*out_depth_sensor_usage)。功能描述：获取深度传感器所使用的配置。参数说明见表52。表52获取深度传感器使用配置参数说明参数名类型说明sessionArSession*增强现实会话指针cameraconfigArCameraConfig*相机配置指针outdepthsensorusageuint32t*深度传感器的使用配置信息指针6.3.3.10获取相机朝向CameraConfig*cameraconfig,ArCameraConfigFacingDirection*outf功能描述：获取当前相机配置所选择的相机的朝向。参数说明见表53。表53获取相机朝向参数说明参数名类型说明ArSession*增强现实会话指针ArCameraConfig*相机配置指针out_facingArCameraConfigFacingDirection*相机朝向分类指针Config*camera_config,int32_t*out_min_fps,int32_t*out_max_fps)。参数名类型说明ArSession*增强现实会话指针ArCameraConfig*相机配置指针最小捕获率指针最大捕获率指针CameraConfig*camera_config,int32_t*out_width,int32_t*out_height)。参数名类型说明sessionArSession*增强现实会话指针cameraconfigArCameraConfig*相机配置指针outwidthCPU图像的宽度指针outheightCPU图像的高度指针ArCameraConfig*camera_config,int32_t*out_width,int32_t*out_height)。参数名类型说明ArSession*增强现实会话指针cameraconfigArCameraConfig*相机配置指针outwidthGPU纹理的宽度指针outheightGPU纹理的高度指针GB/T44247—2024参数名类型说明sessionArSession*增强现实会话指针outfilterArCameraConfigFilter*指向ArCameraConfigFilter指针的指针，以接收新创建的相机配置过滤器对象的地址表58销毁相机配置过滤器参数说明参数名类型说明filterArCameraConfigFilter*相机配置过滤器指针eraConfigFilter*filter,uint32_t*out_depth_sensor_usage)。参数名类型说明ArSession*增强现实会话指针ArCameraConfigFilter*相机配置过滤器指针uint32t*深度传感器使用状态指针eraConfigFilter*filter,uint32tdepthsensorusagefilters)。表60设置所需的深度传感器使用参数说明参数名类型说明ArSession*增强现实会话指针ArCameraConfigFilter*相机配置过滤器指针depthsensorusagefiltersuint32t深度传感器使用状态参考接口定义：voidArCameraConfigFilter_getTargetFps(constArSessiConfigFilter*filter,uint32_t*out_fps_filters表61获取所需的捕获帧率参数说明参数名类型说明ArSession*增强现实会话指针ArCameraConfigFilter*相机配置过滤器指针uint32t*目标相机捕获帧率状态指针参考接口定义：voidArCaConfigFilter*filter,constuint32_tfps_filters)。表62设置所需的捕获帧率参数说明参数名类型说明ArSession*增强现实会话指针ArCameraConfigFilter*相机配置过滤器指针uint32t目标相机捕获帧率状态7帧数据类接口22表63创建帧参数说明参数名类型说明ArSession*增强现实会话指针outframeArFrame**指向ArFrame指针的指针，以接收新创建的帧对象的地址表64销毁帧参数说明参数名类型说明ArFrame*需要销毁的帧指针frame,ArCamera**out_camera)。表65获取相机参数说明参数名类型说明ArSession*增强现实会话指针ArFrame*帧指针ArCamera**指向ArCamera指针的指针，以接收相机的地址ArImage**out_image)。参数名类型说明ArSession*增强现实会话指针ArFrame*帧指针指向ArImage指针的指针，以接收图像的地址23参考接口定义：ArStatusArFrame_acquireDepthImage(constArSession*session,constArFrame*frame,ArImage**out_depth_image)。表67获取深度图像参数说明参数名类型说明ArSession*增强现实会话指针ArFrame*帧指针ArImage**指向ArImage指针的指针，以接收深度图像的地址参考接口定义：ArStatusArFrame_acquireCameraImage(ArSesframe,ArImage**outimage)。表68获取相机图像参数说明参数名类型说明ArSession*增强现实会话指针ArFrame*帧指针ArImage**指向ArImage指针的指针，以接收图像的地址参考接口定义：ArStatusArFrame_acquireDepthImage(constArSession*session,constArFrame*frame,ArImage**out_depth_image)。表69获取深度图像参数说明参数名类型说明ArSession*增强现实会话指针ArFrame*帧指针ArImage**指向ArImage*指针的指针，以接收深度图像的地址参考接口定义：ArStatusArFrame_acquireImageMetadata(constArSe24ArFrame*frame,ArImageMetadata**out_metadata)。表70获取图像元数据参数说明参数名类型说明ArSession*增强现实会话指针ArFrame*帧指针ArImageMetadata**指向ArImageMetadata指针的指针，以接收图像元数据的地址参考接口定义：ArStatusArFrame_acquirePointCloud(constArSession*session,constArFrame*frame,ArPointCloud**out_point_cloud)。表71获取点云参数说明参数名类型说明ArSession*增强现实会话指针ArFrame*帧指针ArPointCloud**指向ArPointCloud指针的指针，以接收点云的地址frame,ArPose*out_pose)。参数名类型说明sessionArSession*增强现实会话指针frameArFrame*帧指针out_poseArPose*当前帧中的Andriod传感器的位姿指针参考接口定义：voidArFrame_getCameraTextureName(constArSession*session,constArFrame*frame,uint32t*outtextureid)。25参数名类型说明ArSession*增强现实会话指针ArFrame*帧指针uint32t*纹理名称(ID)指针frame,ArLightEstimate*out_light_estimate)。表74获取光照估计参数说明参数名类型说明sessionArSession*增强现实会话指针frameArFrame*帧指针outlightestimateArLightEstimate*当前整画面所使用的光照估计模型指针frame,int64_t*out_timestamp_ns)。表75获取时间戳参数说明参数名类型说明sessionArSession*增强现实会话指针frameArFrame*帧指针outtimestampns时间戳指针，并将其存储在*outtimestampns所指向的内存空间26参数名类型说明sessionArSession*增强现实会话指针frameArFrame*帧指针outanchorlistArAnchorList*锚点列表指针frame,ArTrackableTypefilter_type,ArTrackableList*out_trackable_list)。参数名类型说明sessionArSession*增强现实会话指针frameArFrame*帧指针filtertypeArTrackableType要可跟踪对象的类型outtrackablelistArTrackableList*满足过滤条件的可跟踪对象列表指针pixel_x,floatpixel_y,ArHitResultList*hit_result_list)。表78发射屏幕射线参数说明参数名类型说明sessionArSession*增强现实会话指针frameArFrame*帧指针pixelxfloat在视图中的逻辑X的位置pixelyfloat在视图中的逻辑Y的位置hitresultlistArHitResultList*指向接收射线的存储位置的指针参考接口定义：voidArFrame_hitTestRay(constArSession*session,constArFrame×frame,constfloat*ray_origin_3,constfloat*ray_direction_3,ArHitResultList*hit_result_list)。表79发射任意射线参数说明参数名类型说明sessionArSession*增强现实会话指针frameArFrame*帧指针rayorigin3float*指向float[]数组的指针，该数组包含世界空间坐标中的射线原点raydirection3float*指向float[]数组的指针，该数组包含世界空间坐标中的射线方向hitresultlistArHitResultList*指向接收射线的存储位置的指针参考接口定义：voidArFrame_transformCoordinates2d(constArSession*session,constArFrame×frame,ArCoordinates2dTypeinput_coordinates,int32_tnumber_of_vertices,constfloat*vertices_2d,ArCoordinates2dTypeoutput_coordinates,float*out_vertices_2d)。功能描述：将二维坐标列表从二维坐标系转换到另二维坐标系。参数说明见表80。表80转换二维坐标系参数说明参数名类型说明ArSession*增强现实会话指针ArFrame*帧指针ArCoordinates2dType当前使用的二维坐标系numberofvertices要转换的二维顶点数vertices2d输入二维顶点进行变换outputcoordinatesArCoordinates2dType要转换的二维坐标系outvertices2d变换后的二维坐标点指针ageFormat*out_format)。表81获取图像格式参数说明参数名类型说明ArSession*增强现实会话指针ArImage*图像指针ArImageFormat图像格式指针参考接口定义：voidArImage_getHeight(constArSession*session,constArImage*image,int32_t*out_height)。表82获取图像高度参数说明参数名类型说明sessionArSession*增强现实会话指针ArImage*图像指针outheight以像素为单位，输出图像的高度指针image,int32_t*out_num_planes)。表83获取图像平面数参数说明参数名类型说明sessionArSession*增强现实会话指针ArImage*图像指针out_num_planes图像中的平面数指针参考接口定义：voidArImage_getPlaneData(constArSession*session,constArImage*image,int32_tplane_index,constuint8_t**out_data,int32_t*out_data_length)。功能描述：获取当前提供的图像中能够直接应用的数据点。参数说明见表84。表84获取图像平面数据参数说明参数名类型说明sessionArSession*增强现实会话指针ArImage*图像指针planeindex平面索引outdatauint8t**指向图像数据指针的指针outdatalength以字节为单位，输出数据长度指针29image,int32_tplane_index,int32_t*out_pixel_stride)。参数名类型说明sessionArSession*增强现实会话指针ArImage*图像指针planeindex平面索引outpixelstride以字节为单位，输出图像的平面步长指针image,int32_tplane_index,int32_t*out_row_stride)。参数名类型说明sessionArSession*增强现实会话指针ArImag*图像指针planeindex平面索引outrowstride以字节为单位，输出图像的行跨度指针int64_t*out_timestamp_ns)。表87获取时间戳参数说明参数名类型说明sessionArSession*增强现实会话指针ArImage*图像指针outtimestampns以纳秒为单位，输出时间戳指针参数名类型说明sessionArSession*增强现实会话指针ArImage*图像指针outwidth以像素为单位，输出图像的宽度指针表89销毁图像参数说明参数名类型说明ArImage*图像指针参考接口定义：voidArImageMetadata_getAllKeys(constArSession*session,constageMetadata*image_metadata,int32_t*out_number_of_tags,constuint32_t**out_tags)。参数名类型说明sessionArSession*增强现实会话指针imagemetadataArImageMetadata*图像元数据指针outnumberoftags元数据列表中的元数据标签个数指针outtagsuint32t**指向元数据标签列表指针的指针，以接收元数据标签所存储的数组的地址ArImageMetadata*image_metadata,uint32_ttag,ArImageMetadata_const_entry*out_metadata_表91获取图像元数据参数说明参数名类型说明sessionArSession*增强现实会话指针imagemetadataArImageMetadata*图像元数据指针uint32t标签outmetadataentryArImageMetadataconstentry*图像元数据指针chor_list)。表92创建锚点列表参数说明参数名类型说明ArSession*增强现实会话指针outanchorlistArAnchorList**指向ArAnchorList指针的指针，以接收新创建的锚点列表的地址参数名类型说明anchorlistArAnchorList*锚点列表指针anchor_list,int32_tindex,ArAnchor**out_anchor)。表94获取锚点引用参数说明参数名类型说明sessionArSession*增强现实会话指针anchorlistArAnchorList*锚点列表指针指定的索引值outanchorArAnchor**指向指定索引值的锚点指针的指针，以接收锚点的存储地址参数名类型说明ArSession*增强现实会话指针ArAnchorList*锚点列表指针锚点总个数指针参考接口定义：voidArAnchor_acquireCloudAnchorId(ArSession*session,ArAnchor×anchor,char**outcloudanchor表96获取云锚点ID参数说明参数名类型说明sessionArSession*增强现实会话指针anchorArAnchor*锚点指针outcloudanchorid指向锚点的云锚点ID指针的指针，以接收云锚点ID的存储地址表97停止跟踪锚点参数说明参数名类型说明ArSession*增强现实会话指针ArAnchor*参考接口定义：voidArAnchor_getCloudAnchorState(constArSession*session,constArAnchor*anchor,ArCloudAnchorState*outstate)。表98获取云锚点状态参数说明参数名类型说明ArSession*增强现实会话指针anchorArAnchor*锚点指针ArCloudAnchorState*云锚点的状态分类指针参考接口定义：voidArAnchor_getPose(constArSession*session,constArAnchor*anchor,ArPose*out_p表99获取锚点位姿参数说明参数名类型说明ArSession*增强现实会话指针anchorArAnchor*锚点指针out_poseArPose*位姿指针anchor,ArTrackingState*out_tracking_state)。参数名类型说明ArSession*增强现实会话指针ArAnchor*锚点指针ArTrackingState*锚点的跟踪状态指针表101销毁锚点引用参数说明参数名类型说明anchorArAnchor*锚点指针point,ArPointOrientationMode*out_orientation_mode)。表102获取点方向参数说明参数名类型说明ArSession*增强现实会话指针pointArPoint*节点指针outorientationmodeArPointOrientationMode*点的方向模式指针out_pose)。参数名类型说明ArSession*增强现实会话指针ArPoint*节点指针ArPose*当前节点的位姿指针point_cloud,constfloat**out_point_cloud_data)。表104获取点云数据参数说明参数名类型说明ArSession*增强现实会话指针ArPointCloud*点云指针指向点云数据指针的指针，以接收点云数据的存储地址参考接口定义：voidArPointCloud_getNumberOfPoints(constArSession*session,constArPointCloud*point_cloud,int32_t*out_number_of_points)。表105获取点云数量参数说明参数名类型说明sessionArSession*增强现实会话指针pointcloudArPointCloud*点云指针out_number_of_points点云数据中所包含的点数指针point_cloud,constint32_t**out_point_ids)。表106获取点云ID参数说明参数名类型说明ArSession*增强现实会话指针ArPointCloud*点云指针指向点云ID指针的指针，以接收点云ID的位置point_cloud,int64_t*out_timestamp_ns)。功能描述：获取观察到此点云的时间戳(以纳秒为单位)。参数说明见表107。表107获取时间戳参数说明参数名类型说明ArSession*增强现实会话指针pointcloudArPointCloud*点云指针outtimestampns时间戳指针表108销毁点云引用参数说明参数名类型说明pointcloudArPointCloud*指向点云数据的指针8.4平面接口plane,ArPlane**out_subsumed_by)。表109获取平面引用参数说明参数名类型说明sessionArSession*增强现实会话指针planeArPlane*平面指针outsubsumedbyArPlane**指向平面引用指针的指针，以接收获取到的引用的存储地址参考接口定义：voidArPlane_getCenterPose(constArSession*session,constArPlane*plane,ArPose*outpose)。参数名类型说明sessionArSession*增强现实会话指针planeArPlane*平面指针out_poseArPose*位姿信息指针参数名类型说明ArSession*增强现实会话指针planeArPlane×平面指针边界长度指针float*out_extent_z)。表112获取Z轴上边界长度参数说明参数名类型说明ArSession*增强现实会话指针planeArPlane*平面指针边界长度指针表113参数说明参数名类型说明ArSession*增强现实会话指针ArPlane*平面指针将二维坐标信息存储进float[2]的数据中参考接口定义：voidArPlane_getPolygonSize(constplane,int32_t*out_polygon_size)。表114获取平面多边形中非顶点元素个数参数说明参数名类型说明ArSession*增强现实会话指针planeArPlane*平面指针元素个数指针参考接口定义：voidArPlane_getType(constArSession*session,constArPlane*plane,ArPlaneType*out_plane_type)。参数名类型说明ArSession*增强现实会话指针planeArPlane*平面指针ArPlaneType*平面类型指针plane,constArPose*pose,int32_t*out_pose_in_extents)。表116判断位姿是否在平面内参数说明参数名类型说明ArSession*增强现实会话指针ArPlane*平面指针位姿指针判断结果指针，如果在平面内部则返回非零值参考接口定义：voidArPlane_isPoseInPolygon(constArSession*sessionplane,constArPose*pose,int32_t*out_pose_in_polygon)。功能描述：判断位姿是否在当前平面的近似凸多边形内部。参数说明见表117。表117判断位姿是否在平面多边形内参数说明参数名类型说明sessionArSession*增强现实会话指针planeArPlane*平面指针poseArPose*位姿指针out_pose_in_polygon判断结果指针，如果在近似凸多边形内部则返回非零值trackablelist)。表118创建可跟踪列表参数说明参数名类型说明sessionArSession*增强现实会话指针ArTrackableList**指向ArTrackableList指针的指针，以接收新创建的可跟踪列表对象的地址40表119销毁可跟踪列表参数说明参数名类型说明trackablelistArTrackableList*可跟踪列表对象指针ableList*trackablelist,int32tindex,ArTrackable**outtrackable)。表120获取可跟踪列表中的引用参数说明参数名类型说明ArSession*增强现实会话指针ArTrackableList*可跟踪列表对象指针索引值ArTrackable×*指向ArTrackable指针的指针，以接收可跟踪对象的地址trackable_list,int32_t*out_size)。参数名类型说明ArSession*增强现实会话指针ArTrackableList*可跟踪列表对象指针元素数量指针Trackable*trackable,constArPose*pose,ArAnchor**out_anchor)。41表122创建可跟踪锚点参数说明参数名类型说明ArSession*增强现实会话指针trackableArTrackable*可跟踪对象指针poseArPose*位姿指针ArAnchor**指向ArAnchor指针的指针，以接收新创建锚点对象的地址trackable,ArAnchorList*outanchorlist)。参数名类型说明sessionArSession*增强现实会话指针trackableArTrackable*可跟踪对象指针outanchorlistArAnchorList*锚点集合指针参考接口定义：voidArTrackable_getTrackingState(constArSession*session,constArTrackable*trackable,ArTrackingSta表124获取跟踪状态参数说明参数名类型说明ArSession*增强现实会话指针trackableArTrackable*可跟踪对象指针ArTrackingState*可跟踪对象的状态指针参考接口定义：voidArTrackable_gtrackable,ArTrackableType*out_trackable_type)。42参数名类型说明sessionArSession*增强现实会话指针trackableArTrackable*可跟踪对象指针outtrackabletypeArTrackableType*可跟踪对象的类型指针参数名类型说明trackableArTrackable*指向可跟踪对象的指针mentedImage*augmented_image,char**out_augmented_image_name)。表127获取增强图像名称参数说明参数名类型说明sessionArSession*增强现实会话指针augmentedimageArAugmentedImage*增强图像指针outaugmentedimagename指向ArAugmentedImage指针的指针，以接收存储增强图像名称的地址参考接口定义：voidArAugmentedImage_getCenterPose(constArSession*session,constArAugmentedImage*augmented_image,ArPose*out_pose)。表128获取增强图像中心位姿参数说明参数名类型说明ArSession*增强现实会话指针ArAugmentedImage*增强图像指针out_poseArPose*位姿信息指针mentedImage*augmented_image,float*out_extent_x)。参数名类型说明sessionArSession*增强现实会话指针augmentedimageArAugmentedImage*增强图像指针outextentxfloat*以米为单位的宽度值指针mentedImage*augmented_image,float*out_extent_z)。参数名类型说明ArSession*增强现实会话指针ArAugmentedImage*增强图像指针以米为单位的高度值指针参考接口定义：voidArAugmentedImage_getIndex(constArSession*session,constmentedImage*augmented_image,int32_t*out_index)。4344表131获取增强图像索引参数说明参数名类型说明sessionArSession*增强现实会话指针augmentedimageArAugmentedImage*增强图像指针索引值指针ArAugmentedImage*image,ArAugmentedImageTrackingMethod*out_tracking_method)。表132获取增强图像跟踪方式参数说明参数名类型说明sessionArSession*增强现实会话指针ArAugmentedImage*增强图像指针outtrackingmethodArAugmentedImageTrackingMethod跟踪方式指针参考接口定义：voidArAugmentedImageDatabamentedImageDatabase**out_augmented_image_database)。表133创建图像数据库参数说明参数名类型说明ArSession*增强现实会话指针outaugmentedimagedatabaseArAugmentedImageDatabase**指向ArAugmentedImageDatabase指针的指针，以接收新创建的图像数据库的地址mentedimage_database)。45表134销毁图像数据库参数说明参数名类型说明ArAugmentedImageDatabase*参考接口定义：ArStatusArAugmentedImageDatabase_addImage(constArSession*session,ArAugmentedImageDatabase*augmented_image_database,constchar*image_name,constuint8_t×image_grayscale_pixels,int32_timage_width_in_pixels,int32_timage_height_in_pixels,int32_timage_stride_in_pixels,int32_t*out_index)。参数名类型说明ArSession*增强现实会话指针augmentedimagedatabaseArAugmentedImageDatabase*图像数据库指针图像名称指针image_grayscale_pixelsuint8t*图像灰度像素值指针image_width_in_pixels图像宽度像素值image_height_in_pixels图像高度像素值image_stride_in_pixels图像步长像素值插入成功生成的图像索引指针参考接口定义：ArStatusArAugmentedImageDatabase_addImageWithPhysicalSize(constArSession*session,ArAugmentedImageDatabase*augmented_image_database,constchar*image_name,constuint8_t*image_grayscale_pixels,int32_timage_width_in_pixels,int32_timage_height_功能描述：向图像数据库中添加带有物理高度的图像。参数说明见表136。表136添加有宽度的图像于数据库参数说明参数名类型说明sessionArSession*增强现实会话指针augmentedimagedatabaseArAugmentedImageDatabase*图像数据库指针imagenamechar*图像名称指针image_grayscale_pixelsuint8t*图像灰度像素值指针46参数名类型说明image_width_in_pixels图像宽度像素值image_height_in_pixels图像高度像素值image_stride_in_pixels图像步长像素值imagewidthinmetersfloat图像物理宽度，以米为单位插入成功生成的图像索引指针session,constArAugmentedImageDatabase*augmented_image_database,int32_t*out_number_of_表137获取图像数据库中的图像数参数说明参数名类型说明ArSession*增强现实会话指针augmentedimagedatabArAugmentedImageDatabase*图像数据库指针图像个数指针out_sparse_spatial_map)。表138创建稀疏空间地图参数说明参数名类型说明ArSession*增强现实会话指针out_sparse_spatial_mapArSparseSpatialMap**指向ArSparseSpatialMap指针的指针，以接收新创建的稀疏空间地图对象的地址47表139销毁稀疏空间地图参数说明参数名类型说明sparse_spatial_mapArSparseSpatialMap*稠密重建指针Map*sparse_spatial_map)。参数名类型说明sessionArSession*增强现实会话指针sparse_spatial_mapArSparseSpatialMap*稀疏空间地图对象指针参考接口定义：voidArSparseSpatialMap_getPointCloud(constArSession*session,constArSparseSpatialMap*sparse_spatial_map,constfloat**out_points,int32_t*out_number_of_points)。参数名类型说明ArSession*增强现实会话指针ArSparseSpatialMap*稀疏空间地图指针out_pointsfloat**指向存储点云坐标位置的指针的指针out_number_of_points稀疏空间地图点云的顶点个数的指针mentedFace*face,ArPose*ou48表142获取面部中心位姿参数说明参数名类型说明sessionArSession*增强现实会话指针faceArAugmentedFace*面部增强指针out_poseArPose*位姿信息指针参考接口定义：voidArAugmentedFace_getMeshNormals(constArSession*session,constArAugmentedFace×face,constfloat**out_normals,int32_t*out_number_of_normals)。参数名类型说明sessionArSession*增强现实会话指针faceArAugmentedFace*面部增强指针outnormalsfloat**指向三维法向量坐标的指针的指针，以接收存储法向量坐标点的地址outnumberofnormals当前面部网格中的法向量个数指针参考接口定义：voidArAugmentedFace_getMeshTextureCoordinates(constArSession×session,constArAugmentedFace*face,constfloat**out_texture_coordinates,int32_t*out_num-ber_of_texture_coordinates)。参数名类型说明sessionArSession*增强现实会话指针faceArAugmentedFace*面部增强指针outtexturecoordinatesfloat**指向(u,v)包装的UV纹理坐标数组指针的指针，以接收数组的地址outnumberoftexturecoordinates网格中的纹理坐标个数指针ArAugmentedFace*face,constuint16_t**out_triangle_indices,int32_t*out_number_of_triangles)。49表145获取面部三角网格索引参数说明参数名类型说明sessionArSession*增强现实会话指针faceArAugmentedFace*面部增强指针outtriangleindicesuint16t**指向三角面片的索引信息的指针的指针，以接收三角面片索引信息存储的地址outnumberoftriangles面部网格中的三角形数指针参考接口定义：voidArAugmentedFace_getMeshVertices(constArSession*session,constArAugmentedFace×face,constfloat**out_vertices,int32_t*out_number_of_vertices)。表146获取面部顶点参数说明参数名类型说明sessionArSession*增强现实会话指针ArAugmentedFace*面部增强指针outverticesfloat**指向存储顶点坐标位置指针的指针outnumberofvertices面部网格的顶点个数指针参考接口定义：voidArAugmentedFace_getRegionPose(constArSession*session,constArAugmentedFace*face,constArAugmentedFaceRegionTyperegion_type,ArPose*out_pose)。参数名类型说明sessionArSession*增强现实会话指针faceArAugmentedFace*面部增强指针regiontypeArAugmentedFaceRegionType面部增强区域类别out_poseArPose*位姿信息指针表148创建碰撞检测参数说明参数名类型说明ArSession*增强现实会话指针outhitresultArHitResult**指向ArHitResult指针的指针，以接收新创建的碰撞检测对象的地址表149销毁碰撞检测参数说明参数名类型说明hitresultArHitResult*可跟踪对象指针_hit_result_list)。表150创建碰撞检测列表参数说明参数名类型说明ArSession*增强现实会话指针ArHitResultList**指向ArHitResultList指针的指针，以接收新创建的碰撞检测列表对象的地址参数名类型说明hitresultlistArHitResultList*碰撞检测列表对象的指针hit_result,float*out_distance)。表152获取碰撞距离参数说明参数名类型说明ArSession*增强现实会话指针hitresultArHitResult*碰撞检测对象指针距离指针hit_result,ArPose*out_pose)。参数名类型说明ArSession*增强现实会话指针ArHitResult*碰撞检测对象指针位姿信息指针hitresultlist,int32tindex,ArHitResult*outhitresult)。GB/T44247—2024表154获取碰撞检测列表中的引用参数说明参数名类型说明ArSession*增强现实会话指针ArHitResultList*碰撞检测列表对象指针索引值outhitresultArHitResult*索引处的碰撞检测对象指针hit_result_list,int32_t*out_size)。参数名类型说明ArSession*增强现实会话指针ArHitResultList*碰撞检测列表对象指针碰撞检测列表中的元素个数指针out_light_estimate)。参数名类型说明sessionArSession*增强现实会话指针outlightestimateArLightEstimate**指向ArLightEstimate的指针的指针，以接收新创建的光照估计对象的地址表157销毁光照估计参数说明参数名类型说明ArLightEstimate*光照估计指针LightEstimate*light_estimate,float*out_color_correction_4)。表158获取颜色校正值参数说明参数名类型说明sessionArSession*增强现实会话指针lightestimateArLightEstimate*光照估计对象指针outcolorcorre