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

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