(高清版)GB∕T 44247-2024 信息技術 增強現(xiàn)實 軟件構(gòu)件接口

國家市場監(jiān)督管理總局國家標準化管理委員會GB/T44247—2024 Ⅲ 12規(guī)范性引用文件 1 1 25.1接口分類 25.2接口調(diào)用流程 26.1會話接口 26.2配置接口 66.3相機接口 7幀數(shù)據(jù)類接口 7.1幀畫面接口 7.2圖像接口 7.3圖像元數(shù)據(jù)接口 8可跟蹤物體類接口 8.1錨點接口 8.2點接口 8.3點云接口 8.4平面接口 8.5可跟蹤接口 8.6圖像增強接口 8.7圖像數(shù)據(jù)庫接口 8.8稀疏空間地圖接口 8.9面部增強接口 9碰撞檢測類接口 9.1檢測實體管理接口 9.2測量接口 9.3檢測結(jié)果引用接口 10.1光照估計接口 附錄A(規(guī)范性)特殊數(shù)據(jù)類型定義 附錄B(規(guī)范性)枚舉數(shù)據(jù)類型定義 參考文獻 IⅢ1GB/T44247—2024信息技術增強現(xiàn)實軟件構(gòu)件接口1范圍本文件規(guī)定了用于增強現(xiàn)實的軟件構(gòu)件接口，包括會話類接口、幀數(shù)據(jù)類接口、可追蹤物體類接口、碰撞檢測類接口和環(huán)境理解類接口。本文件適用于增強現(xiàn)實軟件構(gòu)件接口的表示與應用。2規(guī)范性引用文件本文件沒有規(guī)范性引用文件。3術語和定義下列術語和定義適用于本文件。3.1署的可組裝軟件實體。軟件構(gòu)件對外交流和交互的唯一通道。3.3采用以計算機為核心的現(xiàn)代高科技手段生成的附加信息對使用者感知到的真實世界進行增強的環(huán)境，生成的附加信息以融合的方式疊加至真實場景中。增強現(xiàn)實會話augmentedrealitysession增強現(xiàn)實中管理各部分運行的消息機制。3.5面部增強augmentedface4縮略語下列縮略語適用于本文件。AR:增強現(xiàn)實(AugmentedReality)CPU:中央處理器(CentralProcessingUnit)GPU:圓形處理器(GraphicsProcessingUnit)HDR:高動態(tài)范圍(HighDynamicRange)2ID:唯一編碼(IdentityDocument)5構(gòu)件接口接口。各類接口間的關系見圖1。些數(shù)據(jù)是AR應用中進行環(huán)境理解和物體跟蹤的基礎數(shù)據(jù)。可跟蹤物體類接口是AR應用中用于識別和跟蹤用戶環(huán)境中的特定物體或標記的接口，與會話類用戶體驗。同時碰撞檢測類接口需與會話類接口和環(huán)境理解類接口是AR應用中用于理解和分析用戶環(huán)境的接口，包括對環(huán)境的光照估計等。環(huán)境碰撞檢測類接口實時處理幀數(shù)據(jù)類接口提供的環(huán)境理解類接口實時分析可跟蹤物體類和碰撞檢測類接口，感知用戶的環(huán)境并提供相應的AR各類接口中涉及的數(shù)據(jù)類型應符合附錄A和附錄B。6.1會話接口參考接口定義：ArStatusArSessioncreate(void*env,void*context,ArSessio3參數(shù)名類型說明void*表示運行環(huán)境的指針contextvoid*表示運行上下文的指針out_session_pointerArSession**指向ArSession指針的指針，以接收新分配的會話的地址SessionFeature*features,ArSession**out_session_pointer)。參數(shù)名類型說明表示運行環(huán)境的指針context表示運行上下文的指針ArSessionFeature*指向請求的功能列表的指針ArSession**指向ArSession指針的指針，以接收新分配的會話的地址參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針表4設置增強現(xiàn)實會話配置參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針configArConfig*增強現(xiàn)實會話的新配置設置指針4參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針out_configArConfig*增強現(xiàn)實會話的新配置設置指針參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針參考接口定義：ArStatusArSession_hostAndAcquireNewCloudAnchor(ArSession*session,constArAnchor*anchor,ArAnchor**outcloudanchor)。參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針anchorArAnchor*錨點指針outcloudanchorArAnchor**指向ArAnchor指針的指針，以接收新分配的云錨點地址5anchor_list)。參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針outanchorlistArAnchorList*所有的錨點列表指針char*cloud_anchor_id,ArAnchor**out_cloud_anchor)。表10解析錨的位姿參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針云錨點的ID指針ArAnchor**指向ArAnchor指針的指針，以接收新分配的云錨點的地址filter_type,ArTrackableList*out_trackable_list)。表11獲取所有可跟蹤的對象參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針filtertypeArTrackableType可跟蹤對象類型outtrackablelistArTrackableList*指向符合類型的可跟蹤對象列表的指針pose,ArAnchor**out_anchor)。6參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針poseArPose*位姿指針outanchorArAnchor**指向ArAnchor指針的指針，以接收新分配錨點地址表13創(chuàng)建配置參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針out_configArConfig**指向ArConfig指針的指針，以接收新分配的配置指針表14銷毀配置參數(shù)說明參數(shù)名類型說明ArConfig*配置指針參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArConfig*配置指針focusmodeArFocusMode×對焦模式指針7config,ArAugmentedFaceModeaugmented_face_mode)。參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArConfig*配置指針augmentedfacemodeArAugmentedFaceMode面部增強模式Config*config,ArAugmentedFaceMode*augmented_face_mode)。參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針configArConfig*配置指針augmentedfacemodeArAugmentedFaceMode*面部增強模式指針config,constArAugmentedImageDatabase*augmented_image_database)。表18設置圖像數(shù)據(jù)庫參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArConfig*配置指針augmentedimagedatabArAugmentedImageDatabase*圖像數(shù)據(jù)庫指針config,ArCloudAnchorMode*out_cloud_anchor_mode)。8表19獲取云錨點模式參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArConfig*配置指針ArCloudAnchorMode*云錨點模式指針config,ArCloudAnchorModecloud_anchor_mode)。表20設置云錨點模式參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針configArConfig*配置指針cloudanchormodeArCloudAnchorMode云錨點模式config,ArDepthMode*out_depth_mode)。表21獲取深度模式參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArConfig*配置指針ArDepthMode*深度模式指針Modemode)。9表22設置深度模式參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針configArConfig*配置指針modeArDepthMode深度模式表23獲取相機對焦模式參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArConfig*配置指針ArFocusMode*相機對焦模式指針ArFocusModefocus_mode)。參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針configArConfig*配置指針focusmodeArFocusMode相機對焦模式Config*config,ArLightEstimationMode*light_estimation_mode)。表25獲取光照模式參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針configArConfig*配置指針lightestimationmodeArLightEstimationMode*光照模式指針config,ArLightEstimationModelight_estimation_mode)。表26設置光照模式參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針configArConfig*配置指針lightestimationmodeArLightEstimationMode光照模式類型config,ArPlaneFindingMode*plane_finding_mode)。參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針configArConfig*配置指針planefindingmodeArPlaneFindingMode*平面模式類型指針config,ArPlaneFindingModeplane_finding_mode)。表28設置平面模式參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針configArConfig*配置指針planefindingmodeArPlaneFindingMode平面模式類型6.3相機接口6.3.1相機內(nèi)參6.3.1.1創(chuàng)建相機內(nèi)參out_camera_intrinsics)。功能描述：創(chuàng)建相機內(nèi)參對象。參數(shù)說明見表29。表29創(chuàng)建相機內(nèi)參參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArCameraIntrinsics**指向ArCameraIntrinsics指針的指針，以接收新創(chuàng)建的相機內(nèi)參對象的地址功能描述：釋放提供給相機內(nèi)參對象使用的內(nèi)參。參數(shù)說明見表30。表30銷毀相機內(nèi)參參數(shù)說明參數(shù)名類型說明cameraintrinsicsArCameraIntrinsics*相機內(nèi)參指針參考接口定義：voidArCameraIntrinsicsgetFocalLength(constArSession*session,con功能描述：返回以像素為單位的相機焦距。參數(shù)說明見表31。表31獲取相機焦距參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針intrinsicsArCameraIntrinsics*相機內(nèi)參指針float*相機的X軸上的焦距指針float*相機的Y軸上的焦距指針ArCameraIntrinsics*intrinsics,int32_t*out_width,int32_t*out_height)。表32獲取圖像尺寸參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針intrinsicsArCameraIntrinsics*相機內(nèi)參指針outwidth圖的寬度指針outheight圖的高度指針CameraIntrinsics*intrinsics,float*out_cx,float*表33獲取相機主點參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針intrinsicsArCameraIntrinsics*相機內(nèi)參指針outcxfloat*相機主點的X軸坐標指針outcyfloat*相機主點的Y軸坐標指針Camera*camera,ArPose*out_pose)。見表34。參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArCamera*相機指針out_poseArPose*已經(jīng)定義了的位姿對象指針camera,ArCameraIntrinsics*out_camera_intrinsics)。參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArCamera*相機指針ArCameraIntrinsics*相機內(nèi)參對象指針參考接口定義：voidArCamera_getPose(constArSession*session,constArCamera*camera,ArPose*out_pose)。表36獲取相機位姿參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArCamera*相機指針out_poseArPose*已經(jīng)定義了的位姿對象指針camera,floatnear,floatfar,float*dest_col_major_4×4)。參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針cameraArCamera*相機指針nearfloat指定近相機平面float指定遠相機平面destcolmajor4×4float*4×4的投影矩陣指針camera,ArCameraIntrinsics*out_camera_intrinsics)。表38獲取紋理流內(nèi)部參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArCamera*相機指針outcameraintrinsicsArCameraIntrinsics*相機內(nèi)參對象指針Camera*camera,ArTrackingFailureReason*out_tracking_failure_reason)。參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArCamera*相機指針outtrackingfailurereasonArTrackingFailureReason*相機跟蹤失敗原因指針camera,ArTrackingState*out_tracking_state)。參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針ArCamera*相機指針outtrackingstateArTrackingState×相機的跟蹤狀態(tài)指針camera,float*out_col_major_4×4)。參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArCamera*相機指針4×4的視圖矩陣指針表42銷毀相機參數(shù)說明參數(shù)名類型說明ArCamera*相機指針depth_mode,int32_t*out_is_supported)。參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針depthmodeArDepthMode需要檢查的深度模式如果當前設備支持深度模式，則返回非零值out_camera_config)。表44創(chuàng)建相機配置參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針out_camera_configArCameraConfig**指向ArCameraConfig指針的指針，以接收新創(chuàng)建的相機配置對象的地址out_camera_config)。參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針out_camera_configArCameraConfig*相機配置指針表46銷毀相機配置參數(shù)說明參數(shù)名類型說明cameraconfigArCameraConfig*相機配置指針表47創(chuàng)建相機配置列表參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArCameraConfigList**指向ArCameraConfigList指針的指針，以接收新創(chuàng)建的相機創(chuàng)建列表對象的地址session,constArCameraConfigFilter×filter,ArCameraConfigList*list)。參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArCameraConfigFilter*相機配置過濾器指針ArCameraConfigList*指向支持的相機配置列表的指針Config*camera_config,int32_tindex,ArCameraConfig*out_camera_config)。參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArCameraConfig*相機配置指針索引值out_camera_configArCameraConfig*相機配置對象指針Config*camera_config,int32_t*out_size)。表50獲取相機配置數(shù)量參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針cameraconfigArCameraConfig*相機配置指針相機配置的數(shù)量指針6.3.3.8銷毀相機配置列表表51。表51銷毀相機配置列表參數(shù)說明參數(shù)名類型說明ArCameraConfigList*相機配置列表指針6.3.3.9獲取深度傳感器使用配置ArCameraConfig*camera_config,uint32_t*out_depth_sensor_usage)。功能描述：獲取深度傳感器所使用的配置。參數(shù)說明見表52。表52獲取深度傳感器使用配置參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針cameraconfigArCameraConfig*相機配置指針outdepthsensorusageuint32t*深度傳感器的使用配置信息指針6.3.3.10獲取相機朝向CameraConfig*cameraconfig,ArCameraConfigFacingDirection*outf功能描述：獲取當前相機配置所選擇的相機的朝向。參數(shù)說明見表53。表53獲取相機朝向參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArCameraConfig*相機配置指針out_facingArCameraConfigFacingDirection*相機朝向分類指針Config*camera_config,int32_t*out_min_fps,int32_t*out_max_fps)。參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArCameraConfig*相機配置指針最小捕獲率指針最大捕獲率指針CameraConfig*camera_config,int32_t*out_width,int32_t*out_height)。參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針cameraconfigArCameraConfig*相機配置指針outwidthCPU圖像的寬度指針outheightCPU圖像的高度指針ArCameraConfig*camera_config,int32_t*out_width,int32_t*out_height)。參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針cameraconfigArCameraConfig*相機配置指針outwidthGPU紋理的寬度指針outheightGPU紋理的高度指針GB/T44247—2024參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針outfilterArCameraConfigFilter*指向ArCameraConfigFilter指針的指針，以接收新創(chuàng)建的相機配置過濾器對象的地址表58銷毀相機配置過濾器參數(shù)說明參數(shù)名類型說明filterArCameraConfigFilter*相機配置過濾器指針eraConfigFilter*filter,uint32_t*out_depth_sensor_usage)。參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArCameraConfigFilter*相機配置過濾器指針uint32t*深度傳感器使用狀態(tài)指針eraConfigFilter*filter,uint32tdepthsensorusagefilters)。表60設置所需的深度傳感器使用參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArCameraConfigFilter*相機配置過濾器指針depthsensorusagefiltersuint32t深度傳感器使用狀態(tài)參考接口定義：voidArCameraConfigFilter_getTargetFps(constArSessiConfigFilter*filter,uint32_t*out_fps_filters表61獲取所需的捕獲幀率參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArCameraConfigFilter*相機配置過濾器指針uint32t*目標相機捕獲幀率狀態(tài)指針參考接口定義：voidArCaConfigFilter*filter,constuint32_tfps_filters)。表62設置所需的捕獲幀率參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArCameraConfigFilter*相機配置過濾器指針uint32t目標相機捕獲幀率狀態(tài)7幀數(shù)據(jù)類接口22表63創(chuàng)建幀參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針outframeArFrame**指向ArFrame指針的指針，以接收新創(chuàng)建的幀對象的地址表64銷毀幀參數(shù)說明參數(shù)名類型說明ArFrame*需要銷毀的幀指針frame,ArCamera**out_camera)。表65獲取相機參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArFrame*幀指針ArCamera**指向ArCamera指針的指針，以接收相機的地址ArImage**out_image)。參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArFrame*幀指針指向ArImage指針的指針，以接收圖像的地址23參考接口定義：ArStatusArFrame_acquireDepthImage(constArSession*session,constArFrame*frame,ArImage**out_depth_image)。表67獲取深度圖像參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArFrame*幀指針ArImage**指向ArImage指針的指針，以接收深度圖像的地址參考接口定義：ArStatusArFrame_acquireCameraImage(ArSesframe,ArImage**outimage)。表68獲取相機圖像參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArFrame*幀指針ArImage**指向ArImage指針的指針，以接收圖像的地址參考接口定義：ArStatusArFrame_acquireDepthImage(constArSession*session,constArFrame*frame,ArImage**out_depth_image)。表69獲取深度圖像參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArFrame*幀指針ArImage**指向ArImage*指針的指針，以接收深度圖像的地址參考接口定義：ArStatusArFrame_acquireImageMetadata(constArSe24ArFrame*frame,ArImageMetadata**out_metadata)。表70獲取圖像元數(shù)據(jù)參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArFrame*幀指針ArImageMetadata**指向ArImageMetadata指針的指針，以接收圖像元數(shù)據(jù)的地址參考接口定義：ArStatusArFrame_acquirePointCloud(constArSession*session,constArFrame*frame,ArPointCloud**out_point_cloud)。表71獲取點云參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArFrame*幀指針ArPointCloud**指向ArPointCloud指針的指針，以接收點云的地址frame,ArPose*out_pose)。參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針frameArFrame*幀指針out_poseArPose*當前幀中的Andriod傳感器的位姿指針參考接口定義：voidArFrame_getCameraTextureName(constArSession*session,constArFrame*frame,uint32t*outtextureid)。25參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArFrame*幀指針uint32t*紋理名稱(ID)指針frame,ArLightEstimate*out_light_estimate)。表74獲取光照估計參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針frameArFrame*幀指針outlightestimateArLightEstimate*當前整畫面所使用的光照估計模型指針frame,int64_t*out_timestamp_ns)。表75獲取時間戳參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針frameArFrame*幀指針outtimestampns時間戳指針，并將其存儲在*outtimestampns所指向的內(nèi)存空間26參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針frameArFrame*幀指針outanchorlistArAnchorList*錨點列表指針frame,ArTrackableTypefilter_type,ArTrackableList*out_trackable_list)。參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針frameArFrame*幀指針filtertypeArTrackableType要可跟蹤對象的類型outtrackablelistArTrackableList*滿足過濾條件的可跟蹤對象列表指針pixel_x,floatpixel_y,ArHitResultList*hit_result_list)。表78發(fā)射屏幕射線參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針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發(fā)射任意射線參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針frameArFrame*幀指針rayorigin3float*指向float[]數(shù)組的指針，該數(shù)組包含世界空間坐標中的射線原點raydirection3float*指向float[]數(shù)組的指針，該數(shù)組包含世界空間坐標中的射線方向hitresultlistArHitResultList*指向接收射線的存儲位置的指針參考接口定義：voidArFrame_transformCoordinates2d(constArSession*session,constArFrame×frame,ArCoordinates2dTypeinput_coordinates,int32_tnumber_of_vertices,constfloat*vertices_2d,ArCoordinates2dTypeoutput_coordinates,float*out_vertices_2d)。功能描述：將二維坐標列表從二維坐標系轉(zhuǎn)換到另二維坐標系。參數(shù)說明見表80。表80轉(zhuǎn)換二維坐標系參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArFrame*幀指針ArCoordinates2dType當前使用的二維坐標系numberofvertices要轉(zhuǎn)換的二維頂點數(shù)vertices2d輸入二維頂點進行變換outputcoordinatesArCoordinates2dType要轉(zhuǎn)換的二維坐標系outvertices2d變換后的二維坐標點指針ageFormat*out_format)。表81獲取圖像格式參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArImage*圖像指針ArImageFormat圖像格式指針參考接口定義：voidArImage_getHeight(constArSession*session,constArImage*image,int32_t*out_height)。表82獲取圖像高度參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針ArImage*圖像指針outheight以像素為單位，輸出圖像的高度指針image,int32_t*out_num_planes)。表83獲取圖像平面數(shù)參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針ArImage*圖像指針out_num_planes圖像中的平面數(shù)指針參考接口定義：voidArImage_getPlaneData(constArSession*session,constArImage*image,int32_tplane_index,constuint8_t**out_data,int32_t*out_data_length)。功能描述：獲取當前提供的圖像中能夠直接應用的數(shù)據(jù)點。參數(shù)說明見表84。表84獲取圖像平面數(shù)據(jù)參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針ArImage*圖像指針planeindex平面索引outdatauint8t**指向圖像數(shù)據(jù)指針的指針outdatalength以字節(jié)為單位，輸出數(shù)據(jù)長度指針29image,int32_tplane_index,int32_t*out_pixel_stride)。參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針ArImage*圖像指針planeindex平面索引outpixelstride以字節(jié)為單位，輸出圖像的平面步長指針image,int32_tplane_index,int32_t*out_row_stride)。參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針ArImag*圖像指針planeindex平面索引outrowstride以字節(jié)為單位，輸出圖像的行跨度指針int64_t*out_timestamp_ns)。表87獲取時間戳參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針ArImage*圖像指針outtimestampns以納秒為單位，輸出時間戳指針參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針ArImage*圖像指針outwidth以像素為單位，輸出圖像的寬度指針表89銷毀圖像參數(shù)說明參數(shù)名類型說明ArImage*圖像指針參考接口定義：voidArImageMetadata_getAllKeys(constArSession*session,constageMetadata*image_metadata,int32_t*out_number_of_tags,constuint32_t**out_tags)。參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針imagemetadataArImageMetadata*圖像元數(shù)據(jù)指針outnumberoftags元數(shù)據(jù)列表中的元數(shù)據(jù)標簽個數(shù)指針outtagsuint32t**指向元數(shù)據(jù)標簽列表指針的指針，以接收元數(shù)據(jù)標簽所存儲的數(shù)組的地址ArImageMetadata*image_metadata,uint32_ttag,ArImageMetadata_const_entry*out_metadata_表91獲取圖像元數(shù)據(jù)參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針imagemetadataArImageMetadata*圖像元數(shù)據(jù)指針uint32t標簽outmetadataentryArImageMetadataconstentry*圖像元數(shù)據(jù)指針chor_list)。表92創(chuàng)建錨點列表參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針outanchorlistArAnchorList**指向ArAnchorList指針的指針，以接收新創(chuàng)建的錨點列表的地址參數(shù)名類型說明anchorlistArAnchorList*錨點列表指針anchor_list,int32_tindex,ArAnchor**out_anchor)。表94獲取錨點引用參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針anchorlistArAnchorList*錨點列表指針指定的索引值outanchorArAnchor**指向指定索引值的錨點指針的指針，以接收錨點的存儲地址參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArAnchorList*錨點列表指針錨點總個數(shù)指針參考接口定義：voidArAnchor_acquireCloudAnchorId(ArSession*session,ArAnchor×anchor,char**outcloudanchor表96獲取云錨點ID參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針anchorArAnchor*錨點指針outcloudanchorid指向錨點的云錨點ID指針的指針，以接收云錨點ID的存儲地址表97停止跟蹤錨點參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArAnchor*參考接口定義：voidArAnchor_getCloudAnchorState(constArSession*session,constArAnchor*anchor,ArCloudAnchorState*outstate)。表98獲取云錨點狀態(tài)參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針anchorArAnchor*錨點指針ArCloudAnchorState*云錨點的狀態(tài)分類指針參考接口定義：voidArAnchor_getPose(constArSession*session,constArAnchor*anchor,ArPose*out_p表99獲取錨點位姿參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針anchorArAnchor*錨點指針out_poseArPose*位姿指針anchor,ArTrackingState*out_tracking_state)。參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArAnchor*錨點指針ArTrackingState*錨點的跟蹤狀態(tài)指針表101銷毀錨點引用參數(shù)說明參數(shù)名類型說明anchorArAnchor*錨點指針point,ArPointOrientationMode*out_orientation_mode)。表102獲取點方向參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針pointArPoint*節(jié)點指針outorientationmodeArPointOrientationMode*點的方向模式指針out_pose)。參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArPoint*節(jié)點指針ArPose*當前節(jié)點的位姿指針point_cloud,constfloat**out_point_cloud_data)。表104獲取點云數(shù)據(jù)參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArPointCloud*點云指針指向點云數(shù)據(jù)指針的指針，以接收點云數(shù)據(jù)的存儲地址參考接口定義：voidArPointCloud_getNumberOfPoints(constArSession*session,constArPointCloud*point_cloud,int32_t*out_number_of_points)。表105獲取點云數(shù)量參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針pointcloudArPointCloud*點云指針out_number_of_points點云數(shù)據(jù)中所包含的點數(shù)指針point_cloud,constint32_t**out_point_ids)。表106獲取點云ID參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArPointCloud*點云指針指向點云ID指針的指針，以接收點云ID的位置point_cloud,int64_t*out_timestamp_ns)。功能描述：獲取觀察到此點云的時間戳(以納秒為單位)。參數(shù)說明見表107。表107獲取時間戳參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針pointcloudArPointCloud*點云指針outtimestampns時間戳指針表108銷毀點云引用參數(shù)說明參數(shù)名類型說明pointcloudArPointCloud*指向點云數(shù)據(jù)的指針8.4平面接口plane,ArPlane**out_subsumed_by)。表109獲取平面引用參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針planeArPlane*平面指針outsubsumedbyArPlane**指向平面引用指針的指針，以接收獲取到的引用的存儲地址參考接口定義：voidArPlane_getCenterPose(constArSession*session,constArPlane*plane,ArPose*outpose)。參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針planeArPlane*平面指針out_poseArPose*位姿信息指針參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針planeArPlane×平面指針邊界長度指針float*out_extent_z)。表112獲取Z軸上邊界長度參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針planeArPlane*平面指針邊界長度指針表113參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArPlane*平面指針將二維坐標信息存儲進float[2]的數(shù)據(jù)中參考接口定義：voidArPlane_getPolygonSize(constplane,int32_t*out_polygon_size)。表114獲取平面多邊形中非頂點元素個數(shù)參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針planeArPlane*平面指針元素個數(shù)指針參考接口定義：voidArPlane_getType(constArSession*session,constArPlane*plane,ArPlaneType*out_plane_type)。參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針planeArPlane*平面指針ArPlaneType*平面類型指針plane,constArPose*pose,int32_t*out_pose_in_extents)。表116判斷位姿是否在平面內(nèi)參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArPlane*平面指針位姿指針判斷結(jié)果指針，如果在平面內(nèi)部則返回非零值參考接口定義：voidArPlane_isPoseInPolygon(constArSession*sessionplane,constArPose*pose,int32_t*out_pose_in_polygon)。功能描述：判斷位姿是否在當前平面的近似凸多邊形內(nèi)部。參數(shù)說明見表117。表117判斷位姿是否在平面多邊形內(nèi)參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針planeArPlane*平面指針poseArPose*位姿指針out_pose_in_polygon判斷結(jié)果指針，如果在近似凸多邊形內(nèi)部則返回非零值trackablelist)。表118創(chuàng)建可跟蹤列表參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針ArTrackableList**指向ArTrackableList指針的指針，以接收新創(chuàng)建的可跟蹤列表對象的地址40表119銷毀可跟蹤列表參數(shù)說明參數(shù)名類型說明trackablelistArTrackableList*可跟蹤列表對象指針ableList*trackablelist,int32tindex,ArTrackable**outtrackable)。表120獲取可跟蹤列表中的引用參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArTrackableList*可跟蹤列表對象指針索引值ArTrackable×*指向ArTrackable指針的指針，以接收可跟蹤對象的地址trackable_list,int32_t*out_size)。參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArTrackableList*可跟蹤列表對象指針元素數(shù)量指針Trackable*trackable,constArPose*pose,ArAnchor**out_anchor)。41表122創(chuàng)建可跟蹤錨點參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針trackableArTrackable*可跟蹤對象指針poseArPose*位姿指針ArAnchor**指向ArAnchor指針的指針，以接收新創(chuàng)建錨點對象的地址trackable,ArAnchorList*outanchorlist)。參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針trackableArTrackable*可跟蹤對象指針outanchorlistArAnchorList*錨點集合指針參考接口定義：voidArTrackable_getTrackingState(constArSession*session,constArTrackable*trackable,ArTrackingSta表124獲取跟蹤狀態(tài)參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針trackableArTrackable*可跟蹤對象指針ArTrackingState*可跟蹤對象的狀態(tài)指針參考接口定義：voidArTrackable_gtrackable,ArTrackableType*out_trackable_type)。42參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針trackableArTrackable*可跟蹤對象指針outtrackabletypeArTrackableType*可跟蹤對象的類型指針參數(shù)名類型說明trackableArTrackable*指向可跟蹤對象的指針mentedImage*augmented_image,char**out_augmented_image_name)。表127獲取增強圖像名稱參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針augmentedimageArAugmentedImage*增強圖像指針outaugmentedimagename指向ArAugmentedImage指針的指針，以接收存儲增強圖像名稱的地址參考接口定義：voidArAugmentedImage_getCenterPose(constArSession*session,constArAugmentedImage*augmented_image,ArPose*out_pose)。表128獲取增強圖像中心位姿參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArAugmentedImage*增強圖像指針out_poseArPose*位姿信息指針mentedImage*augmented_image,float*out_extent_x)。參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針augmentedimageArAugmentedImage*增強圖像指針outextentxfloat*以米為單位的寬度值指針mentedImage*augmented_image,float*out_extent_z)。參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArAugmentedImage*增強圖像指針以米為單位的高度值指針參考接口定義：voidArAugmentedImage_getIndex(constArSession*session,constmentedImage*augmented_image,int32_t*out_index)。4344表131獲取增強圖像索引參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針augmentedimageArAugmentedImage*增強圖像指針索引值指針ArAugmentedImage*image,ArAugmentedImageTrackingMethod*out_tracking_method)。表132獲取增強圖像跟蹤方式參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針ArAugmentedImage*增強圖像指針outtrackingmethodArAugmentedImageTrackingMethod跟蹤方式指針參考接口定義：voidArAugmentedImageDatabamentedImageDatabase**out_augmented_image_database)。表133創(chuàng)建圖像數(shù)據(jù)庫參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針outaugmentedimagedatabaseArAugmentedImageDatabase**指向ArAugmentedImageDatabase指針的指針，以接收新創(chuàng)建的圖像數(shù)據(jù)庫的地址mentedimage_database)。45表134銷毀圖像數(shù)據(jù)庫參數(shù)說明參數(shù)名類型說明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)。參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針augmentedimagedatabaseArAugmentedImageDatabase*圖像數(shù)據(jù)庫指針圖像名稱指針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_功能描述：向圖像數(shù)據(jù)庫中添加帶有物理高度的圖像。參數(shù)說明見表136。表136添加有寬度的圖像于數(shù)據(jù)庫參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針augmentedimagedatabaseArAugmentedImageDatabase*圖像數(shù)據(jù)庫指針imagenamechar*圖像名稱指針image_grayscale_pixelsuint8t*圖像灰度像素值指針46參數(shù)名類型說明image_width_in_pixels圖像寬度像素值image_height_in_pixels圖像高度像素值image_stride_in_pixels圖像步長像素值imagewidthinmetersfloat圖像物理寬度，以米為單位插入成功生成的圖像索引指針session,constArAugmentedImageDatabase*augmented_image_database,int32_t*out_number_of_表137獲取圖像數(shù)據(jù)庫中的圖像數(shù)參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針augmentedimagedatabArAugmentedImageDatabase*圖像數(shù)據(jù)庫指針圖像個數(shù)指針out_sparse_spatial_map)。表138創(chuàng)建稀疏空間地圖參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針out_sparse_spatial_mapArSparseSpatialMap**指向ArSparseSpatialMap指針的指針，以接收新創(chuàng)建的稀疏空間地圖對象的地址47表139銷毀稀疏空間地圖參數(shù)說明參數(shù)名類型說明sparse_spatial_mapArSparseSpatialMap*稠密重建指針Map*sparse_spatial_map)。參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針sparse_spatial_mapArSparseSpatialMap*稀疏空間地圖對象指針參考接口定義：voidArSparseSpatialMap_getPointCloud(constArSession*session,constArSparseSpatialMap*sparse_spatial_map,constfloat**out_points,int32_t*out_number_of_points)。參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArSparseSpatialMap*稀疏空間地圖指針out_pointsfloat**指向存儲點云坐標位置的指針的指針out_number_of_points稀疏空間地圖點云的頂點個數(shù)的指針mentedFace*face,ArPose*ou48表142獲取面部中心位姿參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針faceArAugmentedFace*面部增強指針out_poseArPose*位姿信息指針參考接口定義：voidArAugmentedFace_getMeshNormals(constArSession*session,constArAugmentedFace×face,constfloat**out_normals,int32_t*out_number_of_normals)。參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針faceArAugmentedFace*面部增強指針outnormalsfloat**指向三維法向量坐標的指針的指針，以接收存儲法向量坐標點的地址outnumberofnormals當前面部網(wǎng)格中的法向量個數(shù)指針參考接口定義：voidArAugmentedFace_getMeshTextureCoordinates(constArSession×session,constArAugmentedFace*face,constfloat**out_texture_coordinates,int32_t*out_num-ber_of_texture_coordinates)。參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針faceArAugmentedFace*面部增強指針outtexturecoordinatesfloat**指向(u,v)包裝的UV紋理坐標數(shù)組指針的指針，以接收數(shù)組的地址outnumberoftexturecoordinates網(wǎng)格中的紋理坐標個數(shù)指針ArAugmentedFace*face,constuint16_t**out_triangle_indices,int32_t*out_number_of_triangles)。49表145獲取面部三角網(wǎng)格索引參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針faceArAugmentedFace*面部增強指針outtriangleindicesuint16t**指向三角面片的索引信息的指針的指針，以接收三角面片索引信息存儲的地址outnumberoftriangles面部網(wǎng)格中的三角形數(shù)指針參考接口定義：voidArAugmentedFace_getMeshVertices(constArSession*session,constArAugmentedFace×face,constfloat**out_vertices,int32_t*out_number_of_vertices)。表146獲取面部頂點參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針ArAugmentedFace*面部增強指針outverticesfloat**指向存儲頂點坐標位置指針的指針outnumberofvertices面部網(wǎng)格的頂點個數(shù)指針參考接口定義：voidArAugmentedFace_getRegionPose(constArSession*session,constArAugmentedFace*face,constArAugmentedFaceRegionTyperegion_type,ArPose*out_pose)。參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針faceArAugmentedFace*面部增強指針regiontypeArAugmentedFaceRegionType面部增強區(qū)域類別out_poseArPose*位姿信息指針表148創(chuàng)建碰撞檢測參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針outhitresultArHitResult**指向ArHitResult指針的指針，以接收新創(chuàng)建的碰撞檢測對象的地址表149銷毀碰撞檢測參數(shù)說明參數(shù)名類型說明hitresultArHitResult*可跟蹤對象指針_hit_result_list)。表150創(chuàng)建碰撞檢測列表參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArHitResultList**指向ArHitResultList指針的指針，以接收新創(chuàng)建的碰撞檢測列表對象的地址參數(shù)名類型說明hitresultlistArHitResultList*碰撞檢測列表對象的指針hit_result,float*out_distance)。表152獲取碰撞距離參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針hitresultArHitResult*碰撞檢測對象指針距離指針hit_result,ArPose*out_pose)。參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArHitResult*碰撞檢測對象指針位姿信息指針hitresultlist,int32tindex,ArHitResult*outhitresult)。GB/T44247—2024表154獲取碰撞檢測列表中的引用參數(shù)說明參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArHitResultList*碰撞檢測列表對象指針索引值outhitresultArHitResult*索引處的碰撞檢測對象指針hit_result_list,int32_t*out_size)。參數(shù)名類型說明ArSession*增強現(xiàn)實會話指針ArHitResultList*碰撞檢測列表對象指針碰撞檢測列表中的元素個數(shù)指針out_light_estimate)。參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針outlightestimateArLightEstimate**指向ArLightEstimate的指針的指針，以接收新創(chuàng)建的光照估計對象的地址表157銷毀光照估計參數(shù)說明參數(shù)名類型說明ArLightEstimate*光照估計指針LightEstimate*light_estimate,float*out_color_correction_4)。表158獲取顏色校正值參數(shù)說明參數(shù)名類型說明sessionArSession*增強現(xiàn)實會話指針lightestimateArLightEstimate*光照估計對象指針outcolorcorre