2022移動(dòng)設(shè)備增強(qiáng)現(xiàn)實(shí)系統(tǒng)應(yīng)用接口

移動(dòng)設(shè)備增強(qiáng)現(xiàn)實(shí)系統(tǒng)應(yīng)用接口目??次目??次 I前??言 III信息技術(shù)移動(dòng)設(shè)備增強(qiáng)現(xiàn)實(shí)系統(tǒng)應(yīng)用接口 1范圍 1規(guī)范性引用文件 1術(shù)語和定義 1縮略語 2應(yīng)用程序接口框架 2數(shù)據(jù)類型 3返回結(jié)果 3設(shè)備類型 4數(shù)據(jù)流模式 4節(jié)點(diǎn)類型 4算法類型 4算法模式 5可用性 5跟蹤狀態(tài) 5跟蹤運(yùn)行模式 5世界坐標(biāo)對(duì)齊模式 6頂點(diǎn)格式 6像素格式 6參數(shù) 7左右眼視角 7光照估計(jì)模式 7光照估計(jì)狀態(tài) 7求交查詢模式 7云錨點(diǎn)狀態(tài) 8平面類型 8手勢類型 8左右手類型 9手掌心朝向 9應(yīng)用程序接口 9功能地址 10能力檢測 107.3 位姿 117.4 配置 11增強(qiáng)現(xiàn)實(shí)會(huì)話 15增強(qiáng)現(xiàn)實(shí)世界地圖 21幀畫面 22相機(jī)模型 27I相機(jī)內(nèi)參 287.10 點(diǎn)云 29稠密重建 30光照計(jì)算 32錨點(diǎn)列表 337.14 錨點(diǎn) 337.15 節(jié)點(diǎn)列表 357.16 節(jié)點(diǎn) 35平面節(jié)點(diǎn) 37查詢結(jié)果列表 39查詢結(jié)果 39參考圖數(shù)據(jù)庫 41圖像節(jié)點(diǎn) 42手勢節(jié)點(diǎn) 43IIII1313信息技術(shù)移動(dòng)設(shè)備增強(qiáng)現(xiàn)實(shí)系統(tǒng)應(yīng)用接口范圍本文件規(guī)定了移動(dòng)設(shè)備增強(qiáng)現(xiàn)實(shí)系統(tǒng)開發(fā)的數(shù)據(jù)類型和應(yīng)用程序接口。本文件適用于移動(dòng)設(shè)備增強(qiáng)現(xiàn)實(shí)系統(tǒng)的設(shè)計(jì)、開發(fā)和應(yīng)用。規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對(duì)應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T38247-2019信息技術(shù)增強(qiáng)現(xiàn)實(shí)術(shù)語GB/TXXXXX-XXXX信息技術(shù)手持式移動(dòng)設(shè)備增強(qiáng)現(xiàn)實(shí)系統(tǒng)技術(shù)規(guī)范術(shù)語和定義GB/T38247-2019和GB/TXXXXX-XXXX界定的以及下列術(shù)語和定義適合于本文件。3.1移動(dòng)設(shè)備 mobiledevice具備攝像頭、顯示屏、網(wǎng)絡(luò)功能以及可檢測其方位和運(yùn)動(dòng)信息的元件的終端設(shè)備。注：包括具備六自由度定位功能的手機(jī)、平板電腦等手持式移動(dòng)設(shè)備以及頭盔顯示器、AR眼鏡等頭戴式移動(dòng)設(shè)備。3.2參考圖像referenceimage在環(huán)境中可被識(shí)別的二維圖像。[來源：GB/T38247-2019，2.2.18]3.3增強(qiáng)現(xiàn)實(shí)會(huì)話augmentedrealitysession負(fù)責(zé)管理增強(qiáng)現(xiàn)實(shí)系統(tǒng)的整個(gè)運(yùn)行過程，包括創(chuàng)建、啟動(dòng)、更新、關(guān)閉、銷毀等各個(gè)過程。3.4增強(qiáng)現(xiàn)實(shí)地圖augmentedrealitymap增強(qiáng)現(xiàn)實(shí)運(yùn)行過程中構(gòu)建的地圖結(jié)構(gòu)，包括檢測到的點(diǎn)云、平面節(jié)點(diǎn)、圖像節(jié)點(diǎn)等信息，以及用戶創(chuàng)建的錨點(diǎn)。3.5節(jié)點(diǎn)nodePAGEPAGE10PAGEPAGE3增強(qiáng)現(xiàn)實(shí)運(yùn)行過程中識(shí)別出的平面、圖像、手勢等具體對(duì)象信息。3.6點(diǎn)云pointcloud在增強(qiáng)現(xiàn)實(shí)應(yīng)用中，用于恢復(fù)三維場景而使用的場景物體表面的三維點(diǎn)數(shù)據(jù)集合。[來源：GB/T38247-2019，2.2.47]3.7稠密網(wǎng)格densemesh稠密三維重建過程中，恢復(fù)的場景三角形網(wǎng)格。縮略語下列縮略語適用于本文件。6DoF六自由度（SixDegreesofFreedom）AR 增強(qiáng)現(xiàn)實(shí)(AugmentedReality)API應(yīng)用程序接口（ApplicationProgrammingInterface）FPS每秒幀數(shù)（FramesPerSecond）IMU慣性測量單元（InertialMeasurementUnit）SLAM同步定位與地圖構(gòu)建（SimultaneousLocalizationAndMapping）應(yīng)用程序接口框架移動(dòng)設(shè)備增強(qiáng)現(xiàn)實(shí)系統(tǒng)應(yīng)用程序接口框架符合GB/TXXXXX-XXXX的規(guī)定。移動(dòng)設(shè)備增強(qiáng)現(xiàn)實(shí)系統(tǒng)模塊通過接口和結(jié)構(gòu)來完成相關(guān)的功能。實(shí)時(shí)跟蹤定位模塊利用移動(dòng)設(shè)備的輸入數(shù)據(jù)計(jì)算出相機(jī)模型(ARCamera)和相機(jī)內(nèi)參（ARCameraIntrinsics）；三維重建模塊利用尺度估計(jì)模塊計(jì)算的尺度信息和實(shí)時(shí)跟蹤定位模塊計(jì)算的6DoF位姿等信息，計(jì)算出平面節(jié)點(diǎn)（ARPlaneNode）、點(diǎn)云（ARPointCloud）（ARDenseMesh）ARIageodeARIlumnatonEtimt；如果移動(dòng)設(shè)備具備云計(jì)算服務(wù)，還支持將數(shù)據(jù)通過網(wǎng)絡(luò)傳輸?shù)皆品?wù)端實(shí)現(xiàn)更高效率的云端重定位、云端標(biāo)志物識(shí)別和云端三維重建，并將解算結(jié)果傳輸回移動(dòng)設(shè)備處理單元。移動(dòng)設(shè)備增強(qiáng)現(xiàn)實(shí)系統(tǒng)應(yīng)用程序接口框架見圖1。圖1移動(dòng)設(shè)備增強(qiáng)現(xiàn)實(shí)系統(tǒng)應(yīng)用程序接口框架數(shù)據(jù)類型返回結(jié)果返回結(jié)果數(shù)據(jù)類型命名為ARResult，其值定義見表1。表1返回結(jié)果數(shù)據(jù)類型ARResult定義ARResult值描述ARRESULT_SUCCESS=0成功或者正確ARRESULT_ERROR_INVALID_ARGUMENT=-1包含無效參數(shù)ARRESULT_ERROR_FATAL=-2嚴(yán)重錯(cuò)誤ARRESULT_ERROR_SESSION_PAUSED=-3當(dāng)前操作ARSession暫停狀態(tài)錯(cuò)誤ARRESULT_ERROR_SESSION_NOT_PAUSED=-4當(dāng)前操作ARSession未暫停狀態(tài)錯(cuò)誤ARRESULT_ERROR_NOT_TRACKING=-5目前不處于跟蹤狀態(tài)導(dǎo)致的錯(cuò)誤ARRESULT_ERROR_TEXTURE_NOT_SET=-6未設(shè)置紋理參數(shù)導(dǎo)致的錯(cuò)誤ARRESULT_ERROR_UNSUPPORTED_VIDEOFORMAT=-7指定的視頻格式不支持錯(cuò)誤ARRESULT_ERROR_CAMERA_NOT_AVAILABLE=-8攝像機(jī)服務(wù)不可用錯(cuò)誤ARRESULT_ERROR_CAMERA_PERMISSION_NOT_GRANTED=-9攝像機(jī)服務(wù)未授權(quán)導(dǎo)致的錯(cuò)誤ARRESULT_ERROR_UNSUPPORTED_CONFIG=-10設(shè)置的配置選項(xiàng)不支持導(dǎo)致的錯(cuò)誤ARRESULT_ERROR_RESOURCE_EXHAUSTED=-11沒有可用資源導(dǎo)致的錯(cuò)誤ARRESULT_ERROR_CLOUD_ANCHORS_NOT_CONFIGURED=-12沒有對(duì)云錨點(diǎn)模式進(jìn)行設(shè)置導(dǎo)致的錯(cuò)誤ARRESULT_ERROR_ANCHOR_NOT_SUPPORTED_FOR_HOSTING=-13該錨點(diǎn)不支持托管導(dǎo)致的錯(cuò)誤ARRESULT_ERROR_DEVICE_UNSUPPORT=-14移動(dòng)設(shè)備不支持增強(qiáng)現(xiàn)實(shí)導(dǎo)致的錯(cuò)誤ARRESULT_ERROR_ALGORITHM_UNSUPPORT=-15使用不支持的算法導(dǎo)致的錯(cuò)誤ARRESULT_ERROR_APPLICATION_AUTHORIZED=-16該應(yīng)用未授權(quán)使用增強(qiáng)現(xiàn)實(shí)功能導(dǎo)致的錯(cuò)誤設(shè)備類型設(shè)備類型數(shù)據(jù)類型命名為ARDeviceType,其值定義見表2。表2設(shè)備類型數(shù)據(jù)類型ARDeviceType定義ARDeviceType值描述ARDEVICE_TYPE_HANDHOLD=100手持式移動(dòng)設(shè)備ARDEVICE_TYPE_HEADMOUNTED=200頭戴式移動(dòng)設(shè)備數(shù)據(jù)流模式數(shù)據(jù)流模式數(shù)據(jù)類型命名為ARStreamMode，其值定義見表3。表3數(shù)據(jù)流模式數(shù)據(jù)類型ARStreamMode定義ARStreamMode值描述ARSTREAM_MODE_FRONT_RGB=100數(shù)據(jù)流采用前置RGB相機(jī)模式ARSTREAM_MODE_BACK_RGB=2000數(shù)據(jù)流采用后置RGB相機(jī)模式ARSTREAM_MODE_BACK_RGBD=2100數(shù)據(jù)流采用后置RGBD相機(jī)模式ARSTREAM_MODE_BACK_STEREO=2200數(shù)據(jù)流采用后置立體相機(jī)模式節(jié)點(diǎn)類型節(jié)點(diǎn)類型數(shù)據(jù)類型命名為ARNodeType，其值定義見表4。表4節(jié)點(diǎn)類型數(shù)據(jù)類型ARNodeType定義ARNodeType值描述ARNODE_TYPE_UNKNOWN=-1無效節(jié)點(diǎn)類型ARNODE_TYPE_PLANE=1平面節(jié)點(diǎn)類型ARNODE_TYPE_IMAGE=2圖像節(jié)點(diǎn)類型ARNODE_TYPE_HAND_GESTURE=3手勢節(jié)點(diǎn)類型算法類型算法類型數(shù)據(jù)類型命名為ARAlgorithmType，其值定義見表5。表5算法類型數(shù)據(jù)類型ARAlgorithmType定義ARAlgorithmType值描述ARALGORITHM_TYPE_UNKNOWN=-1無效算法類型ARALGORITHM_TYPE_SLAM=1SLAM算法類型ARALGORITHM_TYPE_HAND_GESTURE=2手勢算法類型ARALGORITHM_TYPE_DENSE_RECON=3稠密網(wǎng)格重建算法類型ARALGORITHM_TYPE_IMAGE_TRACKING=4圖像跟蹤算法類型ARALGORITHM_TYPE_PLANE_DETECTION=5平面檢測算法類型ARALGORITHM_TYPE_ILLUMINATION_ESTIMATION=6光照估計(jì)算法類型ARALGORITHM_TYPE_CLOUD_ANCHOR=7云錨點(diǎn)算法類型算法模式算法模式數(shù)據(jù)類型命名為ARAlgorithmMode，其值定義見表6。表6算法模式數(shù)據(jù)類型ARAlgorithmMode定義ARAlgorithmMode值描述ARALGORITHM_MODE_DISABLE=0算法關(guān)閉模式ARALGORITHM_MODE_ENABLE=1算法激活模式可用性可用性數(shù)據(jù)類型命名為ARAvailability，其值定義見表7。表7可用性數(shù)據(jù)類型ARAvailability定義ARAvailability值描述ARAVAILABILITY_SUPPORTED=1設(shè)備支持，并且可用ARAVAILABILITY_UNKNOWN_ERROR=-1未知錯(cuò)誤ARAVAILABILITY_UNSUPPORTED_DEVICE_NOT_CAPABLE=-100設(shè)備不支持ARARAVAILABILITY_SUPPORTED_NOT_INSTALLED=-201設(shè)備支持，模塊未安裝導(dǎo)致不可用ARAVAILABILITY_SUPPORTED_VERSION_TOO_OLD=-202設(shè)備支持，模塊版本太舊導(dǎo)致不可用跟蹤狀態(tài)跟蹤狀態(tài)數(shù)據(jù)類型命名為ARTrackingState，其值定義見表8。表8跟蹤狀態(tài)數(shù)據(jù)類型ARTrackingState定義ARTrackingState值描述ARTRACKING_STATE_SUCCESS=0正常跟蹤狀態(tài)ARTRACKING_STATE_LOST=1跟蹤丟失狀態(tài)ARTRACKING_STATE_STOPPED=2停止跟蹤狀態(tài)ARTRACKING_STATE_INITIALIZING=10跟蹤初始化中狀態(tài)跟蹤運(yùn)行模式跟蹤運(yùn)行模式數(shù)據(jù)類型命名為ARTrackingRunMode，其值定義見表9。表9跟蹤運(yùn)行模式數(shù)據(jù)類型ARTrackingRunMode定義ARTrackingRunMode值描述ARTRACKING_RUN_MODE_AUTO=0自動(dòng)跟蹤模式，增強(qiáng)現(xiàn)實(shí)會(huì)話恢復(fù)運(yùn)行后，算法自動(dòng)啟動(dòng)運(yùn)行ARTRACKING_RUN_MODE_MANUAL=1手動(dòng)跟蹤模式，增強(qiáng)現(xiàn)實(shí)會(huì)話恢復(fù)運(yùn)行后，算法默認(rèn)不啟動(dòng)，需要手動(dòng)啟動(dòng)運(yùn)行世界坐標(biāo)對(duì)齊模式世界坐標(biāo)對(duì)齊模式數(shù)據(jù)類型命名為ARWorldAlignmentMode，其值定義見表10。表10世界坐標(biāo)對(duì)齊模式數(shù)據(jù)類型ARWorldAlignmentMode定義ARWorldAlignmentMode值描述ARWORLD_ALIGNMENT_MODE_GRAVITY0=0根據(jù)初始化時(shí)候屏幕的朝向和重力方向構(gòu)建世界坐標(biāo)系A(chǔ)RWORLD_ALIGNMENT_MODE_GRAVITY_HEADING=1根據(jù)指南針和重力方向構(gòu)建世界坐標(biāo)系，y指向所在位置的朝南方向頂點(diǎn)格式頂點(diǎn)格式數(shù)據(jù)類型命名為ARVertexFormat，其值定義見表11。表11頂點(diǎn)格式數(shù)據(jù)類型ARVertexFormat定義ARVertexFormat值描述ARVERTEX_FORMAT_UNKNOWN=-1無效頂點(diǎn)數(shù)據(jù)ARVERTEX_FORMAT_3D_POSITION=0頂點(diǎn)數(shù)據(jù)包含3個(gè)float值，表示該點(diǎn)坐標(biāo)ARVERTEX_FORMAT_3D_POSITION_NORMAL=16float的平面法線向量ARVERTEX_FORMAT_3D_POSITION_NORMAL_COLOR=210float點(diǎn)的平面法線向量和該點(diǎn)的RGBA數(shù)據(jù)像素格式像素格式數(shù)據(jù)類型命名為ARPixelFormat，其值定義見表12。表12像素格式數(shù)據(jù)類型ARPixelFormat定義ARPixelFormat值描述ARPIXEL_FORMAT_UNKNOWN=-1無效圖像數(shù)據(jù)ARPIXEL_FORMAT_LUMINANCE8=0圖像數(shù)據(jù)采用LUMINANCE8格式ARPIXEL_FORMAT_RG16=1圖像數(shù)據(jù)采用RG16格式ARPIXEL_FORMAT_RGB24=2圖像數(shù)據(jù)采用RGB24格式ARPIXEL_FORMAT_RGBA32=3圖像數(shù)據(jù)采用RGBA32格式ARPIXEL_FORMAT_DEPTH16=4圖像數(shù)據(jù)采用Depth16格式ARPIXEL_FORMAT_YUV_NV21=1000圖像數(shù)據(jù)采用YUVNV21格式參數(shù)參數(shù)數(shù)據(jù)類型命名為ARParameterEnum，其值定義見表13。表13參數(shù)數(shù)據(jù)類型ARParameterEnum定義ARParameterEnum值描述ARPARAMETER_VIDEO_VERTICAL_FOV=50視頻垂直方向FOVARPARAMETER_ALGORITHM_SLAM_INFO=100SLAM算法運(yùn)行信息ARPRARMETER_ALGORITHM_SLAM_MAP_QUALITY=101SLAM地圖質(zhì)量ARPARAMETER_ALGORITHM_SLAM_DETAIL_STATE=102SLAM算法內(nèi)部詳細(xì)的運(yùn)行狀態(tài)ARPARAMETER_CAMERA_TEXTURE_TARGET=3000視頻流紋理ID左右眼視角左右眼視角數(shù)據(jù)類型命名為AREyeSide，其值定義見表14。表14左右眼視角數(shù)據(jù)類型AREyeSide定義AREyeSide值描述AREYE_LEFT=0左眼視角AREYE_RIGHT=1右眼視角光照估計(jì)模式光照估計(jì)模式數(shù)據(jù)類型命名為ARIlluminationEstimateMode，其值定義見表15。表15光照估計(jì)模式數(shù)據(jù)類型ARIlluminationEstimateMode定義ARIlluminationEstimateMode值描述ARILLUMINATION_ESTIMATE_MODE_AMBIENT_INTENSITY=1環(huán)境光亮度模式，包含單一亮度值光照估計(jì)狀態(tài)光照估計(jì)狀態(tài)數(shù)據(jù)類型命名為ARIlluminationEstimateState，其定義見表16。16ARIlluminationEstimateStateARIlluminationEstimateState值描述ARILLUMINATION_ESTIMATE_STATE_NOT_VALID=0光照估計(jì)結(jié)果暫時(shí)不可用ARILLUMINATION_ESTIMATE_STATE_VALID=1光照估計(jì)結(jié)果可用求交查詢模式求交查詢模式數(shù)據(jù)類型命名為ARQueryMode，其值定義見表17。表17求交查詢模式數(shù)據(jù)類型ARQueryMode定義ARQueryMode值描述ARQUERY_MODE_POLYGON_ONLY=0只能跟多邊形平面求交查詢ARQUERY_MODE_POLYGON_AND_HORIZONPLANE=1能跟多邊形平面以及水平多邊形所在整個(gè)無限平面求交查詢ARQUERY_MODE_POLYGON_PERSISTENCE=2能跟多邊形平面以及多邊形平面所在的無限平面求交查詢，多邊形平面優(yōu)先云錨點(diǎn)狀態(tài)云錨點(diǎn)狀態(tài)數(shù)據(jù)類型命名為ARCloudAnchorState，其值定義見表18。表18云錨點(diǎn)狀態(tài)數(shù)據(jù)類型ARCloudAnchorState定義ARCloudAnchorState值描述ARCLOUD_ANCHOR_STATE_NONE=0該錨點(diǎn)不是云錨點(diǎn)ARCLOUD_ANCHOR_STATE_TASK_IN_PROGRESS=1正在托管或是解析中ARCLOUD_ANCHOR_STATE_SUCCESS=2托管或解析成功ARCLOUD_ANCHOR_STATE_ERROR_INTERNAL=-1托管或解析發(fā)生內(nèi)部錯(cuò)誤ARCLOUD_ANCHOR_STATE_ERROR_NOT_AUTHORIZED=-2托管或解析沒有被授權(quán)ARCLOUD_ANCHOR_STATE_ERROR_SERVICE_UNAVAILABLE=-3當(dāng)前服務(wù)不可用ARCLOUD_ANCHOR_STATE_ERROR_RESOURCE_EXHAUSTED=-4資源已經(jīng)被用盡ARCLOUD_ANCHOR_STATE_ERROR_HOSTING_DATASET_PROCESSING_FAILED=-5云錨點(diǎn)數(shù)據(jù)錯(cuò)誤，不能托管ARCLOUD_ANCHOR_STATE_ERROR_CLOUD_ID_NOT_FOUND=-6該云錨點(diǎn)ID沒有被找到ARCLOUD_ANCHOR_STATE_ERROR_RESOLVING_LOCALIZATION_NO_MATCH=-7解析失敗，環(huán)境無法匹配ARCLOUD_ANCHOR_STATE_ERROR_RESOLVING_SDK_VERSION_TOO_OLD=-8解析錨點(diǎn)的SDK版本過舊ARCLOUD_ANCHOR_STATE_ERROR_RESOLVING_SDK_VERSION_TOO_NEW=-9解析錨點(diǎn)的SDK版本過新ARCLOUD_ANCHOR_STATE_ERROR_UNKNOWN=-11未知錯(cuò)誤平面類型平面類型數(shù)據(jù)類型命名為ARPlaneType，其值定義見表19。表19平面類型數(shù)據(jù)類型ARPlaneType定義ARPlaneType值描述ARPLANE_TYPE_UNKNOWN=-1無效平面類型ARPLANE_TYPE_UPWARD_FACING=0水平朝上平面類型ARPLANE_TYPE_DOWNWARD_FACING=1水平朝下平面類型ARPLANE_TYPE_VERTICAL=2垂直平面類型手勢類型手勢類型數(shù)據(jù)類型命名為ARHandGestureType，其值定義見表20。表20手勢類型數(shù)據(jù)類型ARHandGestureType定義ARHandGestureType值描述ARHAND_GESTURE_TYPE_UNKNOWN=-1無效手勢類型ARHAND_GESTURE_TYPE_OK=0OK手勢類型ARHAND_GESTURE_TYPE_SCISSORS=1剪刀手勢類型ARHAND_GESTURE_TYPE_THUMBS_UP=2豎起大拇指手勢類型ARHAND_GESTURE_TYPE_PAPER=3布手勢類型ARHAND_GESTURE_TYPE_GUN=4手槍手勢類型ARHAND_GESTURE_TYPE_ROCK=5石頭手勢類型ARHAND_GESTURE_TYPE_FINGER_HEART=6比心手勢類型ARHAND_GESTURE_TYPE_FINGERTIP=7指尖手勢類型ARHAND_GESTURE_TYPE_WELL_PLAYED=8做得好手勢類型ARHAND_GESTURE_TYPE_THREE_FINGERS=93個(gè)手指手勢類型ARHAND_GESTURE_TYPE_FOUR_FINGERS=104個(gè)手指手勢類型ARHAND_GESTURE_TYPE_I_LOVE_YOU=11我愛你手勢類型ARHAND_GESTURE_TYPE_INDEX_FINGER_AND_LITTLE_FINGER=12豎起食指與小拇指手勢類型ARHAND_GESTURE_TYPE_LITTLE_FINGER=13小拇指手勢類型左右手類型左右手類型數(shù)據(jù)類型命名為ARHandType，其值定義見表21。表21左右手類型數(shù)據(jù)類型ARHandType定義ARHandType值描述ARHAND_TYPE_UNKNOWN=-1無法區(qū)分左右手ARHAND_TYPE_RIGHT=0右手ARHAND_TYPE_LEFT=1左手手掌心朝向手掌心朝向數(shù)據(jù)類型命名為ARHandTowards，其值定義見表22。表22手掌心朝向數(shù)據(jù)類型ARHandTowards定義ARHandTowards值描述ARHAND_TOWARDS_UNKNOWN=-1無效的手朝向ARHAND_TOWARDS_PALM=0手心方向ARHAND_TOWARDS_THE_BACK_OF_HAND=1手背方向ARHAND_TOWARDS_SIDE_HAND=2側(cè)手方向應(yīng)用程序接口功能地址獲取擴(kuò)展函數(shù)地址接口定義：PFN_arVoidFunctionarGetProcAddress(constchar*name)功能描述：通過給定的字符串，獲取功能擴(kuò)展的函數(shù)指針。輸入?yún)?shù)：類型：constchar*，值：函數(shù)指針的名字。輸出參數(shù)：類型：PFN_arVoidFunction，值：typedefvoid(ARAPI_PTR*PFN_arVoidFunction)(void)，定義了函數(shù)指針的類型，ARAPI_PTR能力檢測檢測設(shè)備是否支持接口定義：voidarCapabilityCheckAvailability(void*env,void*context,ARAvailability*out_availability)功能描述：檢測設(shè)備是否支持運(yùn)行增強(qiáng)現(xiàn)實(shí)模塊。輸入?yún)?shù)：類型：void*，值：運(yùn)行環(huán)境。類型：void*，值：運(yùn)行上下文。輸出參數(shù)：類型：ARAvailability*7檢測是否支持算法接口定義：ARResultarCapabilityCheckAlgorithm(void*env,void*context,ARAlgorithmTypetype,ARStreamModemode)ARRESULT_SUCCESS輸入?yún)?shù)：類型：void*，值：運(yùn)行環(huán)境。類型：void*，值：運(yùn)行上下文。類型：ARAlgorithmType5類型：ARStreamMode3輸出參數(shù)：類型：ARResult1檢測是否授權(quán)ARRsultarapailiyChckAthoize(vod*env,voi*conext,costcha*appId)ARRESULT_SUCCESS輸入?yún)?shù)：類型：void*，值：運(yùn)行環(huán)境。類型：void*，值：運(yùn)行上下文。類型：constchar*，值：應(yīng)用程序授權(quán)字符串。輸出參數(shù)：x)類型：ARResult，值：返回值，見表1定義。位姿創(chuàng)建位姿接口定義：voidarPoseCreate(constfloat*pose_raw,ARPose**out_pose)6DF信息qx,q,qzqw,x,t,t。輸入?yún)?shù)：類型：constfloat*，值：6DoF類型：ARPose**，值：創(chuàng)建新的位姿結(jié)構(gòu)，結(jié)構(gòu)地址保存到*out_pose中。釋放位姿接口定義：voidarPoseDestroy(ARPose*pose)功能描述：銷毀位姿結(jié)構(gòu)。輸入?yún)?shù)：類型：ARPose*，值：位姿結(jié)構(gòu)指針。輸出參數(shù)：不作定義。6DoF接口定義：voidarPoseGetPoseRaw(constARPose*pose,float*out_pose_raw)6DoF信息（q,qyqz,w,t,tytz7。輸入?yún)?shù)：類型：constARPose*，值：位姿結(jié)構(gòu)指針。輸出參數(shù)：類型：float*，值：6DoF信息。獲取位姿結(jié)構(gòu)的矩陣接口定義：voidarPoseGetMatrix(constARPose*pose,float*out_matrix_col_major_4x4)功能描述：獲取位姿結(jié)構(gòu)對(duì)應(yīng)的4×4矩陣。輸入?yún)?shù)：類型：constARPose*，值：位姿結(jié)構(gòu)指針。輸出參數(shù)：類型：float*，值：矩陣，該矩陣為列矩陣形式。配置創(chuàng)建配置接口定義：voidarConfigCreate(ARConfig**out_config)功能描述：創(chuàng)建配置結(jié)構(gòu)。輸入?yún)?shù)：不做定義。輸出參數(shù)：類型：ARConfig**，值：創(chuàng)建新的配置結(jié)構(gòu)，結(jié)構(gòu)地址保存到*out_config中。銷毀配置接口定義：voidarConfigDestroy(ARConfig*config)功能描述：銷毀配置結(jié)構(gòu)。輸入?yún)?shù)：類型：ARConfig*，值：配置結(jié)構(gòu)指針。輸出參數(shù)：不做定義。獲取配置中的設(shè)備類型接口定義：voidarConfigGetDeviceType(constARConfig*config,ARDeviceType*out_device_type)功能描述：獲取配置結(jié)構(gòu)中的設(shè)備類型。輸入?yún)?shù)：類型：constARConfig*，值：配置結(jié)構(gòu)指針。輸出參數(shù)：類型：ARDeviceType*，值：設(shè)備類型指針，見表2定義。設(shè)置配置中的設(shè)備類型接口定義：voidarConfigSetDeviceType(ARConfig*config,ARDeviceTypedevice_type)功能描述：設(shè)置配置結(jié)構(gòu)中的設(shè)備類型。輸入?yún)?shù)：類型：ARConfig*，值：配置結(jié)構(gòu)指針。類型：ARDeviceType2獲取配置中的算法數(shù)據(jù)流模式接口定義：voidarConfigGetAlgorithmStreamMode(constARConfig*configARAlgorithmTypetype,ARStreamMode*out_stream_mode)功能描述：獲取配置結(jié)構(gòu)中指定算法類型的數(shù)據(jù)流模式。輸入?yún)?shù)：類型：constARConfig*，值：配置結(jié)構(gòu)指針。類型：ARAlgorithmType，值：算法類型，見表5定義。輸出參數(shù)：類型：ARStreamMode*，值：數(shù)據(jù)流模式指針，見表3定義。設(shè)置配置中的算法數(shù)據(jù)流模式接口定義：voidarConfigSetAlgorithmStreamMode(ARConfig*configARAlgorithmTypetype,ARStreamModestream_mode)功能描述：設(shè)置配置結(jié)構(gòu)中指定算法類型的數(shù)據(jù)流模式。輸入?yún)?shù)：類型：ARConfig*，值：配置結(jié)構(gòu)指針。類型：ARAlgorithmType，值：算法類型，見表5定義。類型：ARStreamMode，值：數(shù)據(jù)流模式，見表3定義。輸出參數(shù)：不做定義。獲取配置中的算法開關(guān)模式接口定義：voidarConfigGetAlgorithmMode(constARConfig*configARAlgorithmTypetype,ARAlgorithmMode*out_algorithm_mode)功能描述：獲取配置結(jié)構(gòu)中指定算法類型的算法開關(guān)模式。輸入?yún)?shù)：類型：constARConfig*，值：配置結(jié)構(gòu)指針。類型：ARAlgorithmType，值：算法類型，見表5定義。輸出參數(shù)：類型：ARAlgorithmMode*，值：算法開關(guān)模式指針，見表6定義。設(shè)置配置中的算法開關(guān)模式接口定義：voidarConfigSetAlgorithmMode(ARConfig*config,ARAlgorithmTypetype,ARAlgorithmModealgorithm_mode)功能描述：設(shè)置配置結(jié)構(gòu)中指定算法類型的算法開關(guān)模式。輸入?yún)?shù)：類型：ARConfig*，值：配置結(jié)構(gòu)指針。類型：ARAlgorithmType，值：算法類型，見表5定義。類型：ARAlgorithmMode6獲取配置中光照估計(jì)模式接口定義：voidarConfigGetIlluminationEstimateMode(constARConfig*config,ARIlluminationEstimateMode*out_mode)功能描述：獲取配置結(jié)構(gòu)中的光照估計(jì)模式。輸入?yún)?shù)：類型：constARConfig*，值：配置結(jié)構(gòu)指針。輸出參數(shù)：類型：ARIlluminationEstimateMode*，值：光照估計(jì)模式指針，見表15定義。設(shè)置配置中光照估計(jì)模式接口定義：void arConfigSetIlluminationEstimateMode(ARConfig* ARIlluminationEstimateModemode)功能描述：設(shè)置配置結(jié)構(gòu)中的光照估計(jì)模式。輸入?yún)?shù)：類型：ARConfig*，值：配置結(jié)構(gòu)指針。類型：ARIlluminationEstimateMode15獲取配置中的跟蹤運(yùn)行模式接口定義：voidarConfigGetTrackingRunMode(constARConfig*config,ARTrackingRunMode*tracking_run_mode)功能描述：獲取配置結(jié)構(gòu)中的跟蹤運(yùn)行模式。輸入?yún)?shù)：類型：constARConfig*，值：配置結(jié)構(gòu)指針。輸出參數(shù)：類型：ARTrackingRunMode*，值：跟蹤運(yùn)行模式指針，見表9定義。設(shè)置配置中的跟蹤運(yùn)行模式接口定義：voidarConfigSetTrackingRunMode(ARConfig*config,ARTrackingRunModetracking_run_mode)功能描述：設(shè)置配置結(jié)構(gòu)中的跟蹤運(yùn)行模式。輸入?yún)?shù)：類型：ARConfig*，值：配置結(jié)構(gòu)指針。類型：ARTrackingRunMode9獲取配置中的世界坐標(biāo)對(duì)齊模式接口定義：void arConfigGetWorldAlignmentMode(const ARConfig* ARWorldAlignmentMode*world_alignment_mode)功能描述：獲取配置結(jié)構(gòu)中的世界坐標(biāo)對(duì)齊模式。輸入?yún)?shù)：類型：constARConfig*，值：配置結(jié)構(gòu)指針。輸出參數(shù)：類型：ARWorldAlignmentMode*，值：世界坐標(biāo)對(duì)齊模式指針，見表10定義。設(shè)置配置中的世界坐標(biāo)對(duì)齊模式接口定義：voidarConfigSetWorldAlignmentMode(ARConfig*config,ARWorldAlignmentModeworld_alignment_mode)功能描述：設(shè)置配置結(jié)構(gòu)中的世界坐標(biāo)對(duì)齊模式。輸入?yún)?shù)：類型：ARConfig*，值：配置結(jié)構(gòu)指針。類型：ARWorldAlignmentMode10獲取配置中的參考圖像數(shù)據(jù)集接口定義：voidarConfigGetReferenceImageDatabase(const ARConfig* ARReferenceImageDatabase*out_image_database)功能描述：獲取配置結(jié)構(gòu)中的參考圖像數(shù)據(jù)集結(jié)構(gòu)。輸入?yún)?shù)：類型：constARConfig*，值：配置結(jié)構(gòu)指針。輸出參數(shù)：類型：ARReferenceImageDatabase*，值：參考圖像數(shù)據(jù)集結(jié)構(gòu)的指針。設(shè)置配置中的參考圖像數(shù)據(jù)集接口定義：voidarConfigSetReferenceImageDatabase(ARConfig* config,ARReferenceImageDatabase*image_database)功能描述：設(shè)置配置結(jié)構(gòu)中的參考圖像數(shù)據(jù)集結(jié)構(gòu)。輸入?yún)?shù)：類型：ARConfig*，值：配置結(jié)構(gòu)指針。類型：constARReferenceImageDatabase*，值：參考圖像數(shù)據(jù)集結(jié)構(gòu)指針。輸出參數(shù)：不做定義。增強(qiáng)現(xiàn)實(shí)會(huì)話創(chuàng)建增強(qiáng)現(xiàn)實(shí)會(huì)話接口定義：ARResultarSessionCreate(void*envvoid*contextARSession**out_session)ARRESULT_SUCCESS輸入?yún)?shù)：類型：void*，值：運(yùn)行環(huán)境。類型：void*輸出參數(shù)：類型：ARSession**，值：創(chuàng)建新的增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)，結(jié)構(gòu)地址保存在*out_session中，如果創(chuàng)建失敗，*out_session指向的值為空指針。類型：ARResult，值：返回值，見表1定義。銷毀增強(qiáng)現(xiàn)實(shí)會(huì)話接口定義：voidarSessionDestroy(ARSession*session)功能描述：銷毀增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)。輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)結(jié)構(gòu)話指針。輸出參數(shù)：不做定義。增強(qiáng)現(xiàn)實(shí)會(huì)話設(shè)置云服務(wù)密鑰arSessionSetKeyAndSecret(ARSession*sessionconstchar*keyconstchar*secret)功能描述：授權(quán)云服務(wù)。輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constchar*，值：Key類型：constchar*，值：Secret字符串。輸出參數(shù)：不做定義。增強(qiáng)現(xiàn)實(shí)會(huì)話獲取版本號(hào)接口定義：voidarSessionGetVersion(constARSession*session,char*version,intversionSize)功能描述：獲取版本號(hào)。輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：int，值：版本號(hào)字符串?dāng)?shù)組的長度。輸出參數(shù)：類型：char*，值：填充版本號(hào)的字符串。設(shè)置增強(qiáng)現(xiàn)實(shí)會(huì)話配置接口定義：ARResultarSessionConfigure(ARSession*session,constARConfig*config)功能描述：設(shè)置增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)的配置，返回ARRESULT_SUCCESS表示成功。輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARConfig*，值：配置指針。輸出參數(shù)：類型：ARResult，值：返回值，見表1定義。獲取增強(qiáng)現(xiàn)實(shí)會(huì)話配置接口定義：voidarSessionGetConfig(constARSession*session,ARConfig*out_config)功能描述：獲取增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)的配置。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。輸出參數(shù)：類型：ARConfig*，值：配置指針?；謴?fù)運(yùn)行增強(qiáng)現(xiàn)實(shí)會(huì)話接口定義：ARResultarSessionResume(ARSession*session)功能描述：恢復(fù)運(yùn)行增強(qiáng)現(xiàn)實(shí)會(huì)話，進(jìn)入運(yùn)行狀態(tài)，該狀態(tài)下才會(huì)對(duì)場景進(jìn)行跟蹤識(shí)別，返回ARRESULT_SUCCESS表示成功。輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。輸出參數(shù)：類型：ARResult，值：返回值，見表1定義。暫停運(yùn)行增強(qiáng)現(xiàn)實(shí)會(huì)話接口定義：ARResultarSessionPause(ARSession*session)功能描述：暫停運(yùn)行增強(qiáng)現(xiàn)實(shí)會(huì)話，進(jìn)入暫停狀態(tài)，該狀態(tài)下停止對(duì)物體場景的跟蹤識(shí)別，返回ARRESULT_SUCCESS表示成功。輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。輸出參數(shù)：類型：ARResult，值：返回值，見表1定義。更新增強(qiáng)現(xiàn)實(shí)會(huì)話接口定義：ARResultarSessionUpdate(ARSession*session,ARFrame*out_frame)該函數(shù)需要按照一定的頻率進(jìn)行調(diào)用，使增強(qiáng)現(xiàn)實(shí)會(huì)話內(nèi)部信息不斷更新，返回ARRESULT_SUCCESS表示成功。輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。輸出參數(shù)：類型：ARFrame*，值：幀畫面結(jié)構(gòu)指針，需要預(yù)先創(chuàng)建，該結(jié)構(gòu)內(nèi)容會(huì)被更新。類型：ARResult1定義。啟動(dòng)運(yùn)行增強(qiáng)現(xiàn)實(shí)會(huì)話算法接口定義：ARResultarSessionStartAlgorithm(ARSession*sessionARAlgorithmTypetype,intoption)ARRESULT_SUCCESS類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：ARAlgorithmType，值：算法類型，見表5定義。類型：int，值：啟動(dòng)算法選項(xiàng)。輸出參數(shù)：類型：ARResult1定義。停止運(yùn)行增強(qiáng)現(xiàn)實(shí)會(huì)話算法arSessionStopAlgorithm(ARSession*sessionARAlgorithmTypetypeintoption)ARRESULT_SUCCESS類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：ARAlgorithmType，值：算法類型，見表5定義。類型：int，值：停止算法選項(xiàng)。輸出參數(shù)：類型：ARResult1定義。設(shè)置增強(qiáng)現(xiàn)實(shí)會(huì)話顯示區(qū)域接口定義：voidarSessionSetDisplayGeometry(ARSession*sessionintrotationintwidth,intheight)功能描述：設(shè)置屏幕顯示參數(shù)。輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：int，值：界面朝向模式。類型：int，值：顯示區(qū)域?qū)挼南袼財(cái)?shù)量。類型：int，值：顯示區(qū)域高的像素?cái)?shù)量。輸出參數(shù)：不做定義。獲取增強(qiáng)現(xiàn)實(shí)會(huì)話地圖接口定義：ARResultarSessionAcquireWorldMap(ARSession*sessionARWorldMap**out_map)功能描述：獲取增強(qiáng)現(xiàn)實(shí)會(huì)話當(dāng)前的增強(qiáng)現(xiàn)實(shí)世界地圖結(jié)構(gòu)。輸入?yún)?shù)：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。輸出參數(shù)：類型：ARWorldMap***out_map1定義。獲取增強(qiáng)現(xiàn)實(shí)會(huì)話跟蹤狀態(tài)接口定義：voidarSessionGetTrackingState(ARSession*session,ARTrackingState*out_state)功能描述：獲取跟蹤狀態(tài)，不同狀態(tài)表示內(nèi)部的算法運(yùn)行情況，比如：初始化、正常跟蹤等。輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。輸出參數(shù)：類型：ARTrackingState*，值：跟蹤狀態(tài)指針，見表8定義。增強(qiáng)現(xiàn)實(shí)會(huì)話托管錨點(diǎn)接口定義：ARResultarSessionHostAnchor(ARSession*session,constARAnchor*anchor,ARAnchor**out_cloud_anchor)功能描述：將本地錨點(diǎn)托管至云端，創(chuàng)建對(duì)應(yīng)的云錨點(diǎn)結(jié)構(gòu)。輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：ARAnchor*，值：本地錨點(diǎn)。輸出參數(shù)：類型：ARAnchor**，值：創(chuàng)建新的云錨點(diǎn)結(jié)構(gòu)，結(jié)構(gòu)地址保存在*out_cloud_anchor。類型：ARResult1定義。增強(qiáng)現(xiàn)實(shí)會(huì)話解析錨點(diǎn)接口定義：ARResultarSessionResolveAnchor(ARSession*session,constchar*cloud_anchor_id,ARAnchor**out_cloud_anchor)ID類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constchar*id。輸出參數(shù)：id*out_cloud_anchor。類型：ARResult1定義。設(shè)置增強(qiáng)現(xiàn)實(shí)會(huì)話整型數(shù)據(jù)類型參數(shù)值接口定義：voidarSessionSetIntValue(ARSession*session,ARParameterEnumtype,int*value,intsize)功能描述：設(shè)置指定的整型數(shù)據(jù)類型參數(shù)的值。輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：ARParameterEnum13類型：int，值：整形數(shù)組長度。輸出參數(shù)：不做定義。設(shè)置增強(qiáng)現(xiàn)實(shí)會(huì)話浮點(diǎn)型數(shù)據(jù)類型參數(shù)值接口定義：voidarSessionSetFloatValue(ARSession*sessionARParameterEnumtypefloat*value,intsize)功能描述：設(shè)置指定的浮點(diǎn)型數(shù)據(jù)類型參數(shù)的值。輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：ARParameterEnum13類型：int，值：浮點(diǎn)數(shù)組長度。輸出參數(shù)：不做定義。設(shè)置增強(qiáng)現(xiàn)實(shí)會(huì)話字符串?dāng)?shù)據(jù)類型參數(shù)值接口定義：voidarSessionSetStringValue(ARSession*sessionARParameterEnumtypechar*value,intsize)功能描述：設(shè)置指定的字符數(shù)據(jù)類型參數(shù)的值。輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：ARParameterEnum13類型：int，值：字符串?dāng)?shù)組長度。輸出參數(shù)：不做定義。獲取增強(qiáng)現(xiàn)實(shí)會(huì)話整型數(shù)據(jù)類型參數(shù)值接口定義：voidarSessionGetIntValue(constARSession*session,ARParameterEnumtype,int*out_value,intsize)功能描述：獲取指定的整型數(shù)據(jù)類型參數(shù)的值。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：ARParameterEnum13輸出參數(shù)：類型：int*，值：保存獲取結(jié)果的整形數(shù)組。獲取增強(qiáng)現(xiàn)實(shí)會(huì)話獲取浮點(diǎn)型數(shù)據(jù)類型參數(shù)值接口定義：voidarSessionGetFloatValue(constARSession*sessionARParameterEnumtype,float*out_value,intsize)功能描述：獲取指定的浮點(diǎn)型數(shù)據(jù)類型參數(shù)的值。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：ARParameterEnum13輸出參數(shù)：類型：float*，值：保存獲取結(jié)果的浮點(diǎn)數(shù)組。獲取增強(qiáng)現(xiàn)實(shí)會(huì)話字符串?dāng)?shù)據(jù)類型參數(shù)值接口定義：voidarSessionGetStringValue(constARSession*sessionARParameterEnumtype,char*out_value,int*out_length,intsize)功能描述：獲取指定的字符數(shù)據(jù)類型參數(shù)的值。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：ARParameterEnum13輸出參數(shù)：類型：char*，值：保存獲取結(jié)果的字符串?dāng)?shù)組。類型：int*，值：字符串?dāng)?shù)組被填充的長度。開始增強(qiáng)現(xiàn)實(shí)會(huì)話頭戴式設(shè)備左右眼視角繪制接口定義：ARResultarSessionRenderBeginEye(ARSession*session,AREyeSideeye)功能描述：開始頭戴式設(shè)備左右眼視角繪制流程狀態(tài)。輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：AREyeSide14類型：ARResult，值：返回值，見表1定義。結(jié)束增強(qiáng)現(xiàn)實(shí)會(huì)話頭戴式設(shè)備左右眼視角繪制接口定義：ARResultarSessionEndEye(ARSession*session,AREyeSideeye)功能描述：結(jié)束頭戴式設(shè)備左右眼視角繪制流程狀態(tài)。輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：AREyeSide14類型：ARResult，值：返回值，見表1定義。提交增強(qiáng)現(xiàn)實(shí)會(huì)話頭戴式設(shè)備左右眼視角繪制結(jié)果接口定義：ARResultarSessionRenderSubmitFrame(ARSession*session,constintleftEyeTextureId,constintrightEyeTextureId)功能描述：提交左右眼視角繪制結(jié)果給增強(qiáng)現(xiàn)實(shí)會(huì)話，實(shí)現(xiàn)異步時(shí)間扭曲（ATW）繪制。輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constint，值：左眼離屏繪制結(jié)果紋理參數(shù)。類型：constint，值：右眼離屏繪制結(jié)果紋理參數(shù)。輸出參數(shù)：類型：ARResult，值：返回值，見表1定義。設(shè)置增強(qiáng)現(xiàn)實(shí)會(huì)話頭戴式設(shè)備繪制窗口環(huán)境接口定義：ARResultarSessionRenderSetWindow(ARSession*sessionvoid*window)功能描述：設(shè)置窗口環(huán)境，使異步時(shí)間扭曲（ATW）繪制框架能創(chuàng)建所需的繪制環(huán)境。輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：void*，值：異步時(shí)間扭曲（ATW）繪制所需的窗口環(huán)境。輸出參數(shù)：類型：ARResult，值：返回值，見表1定義。增強(qiáng)現(xiàn)實(shí)世界地圖獲取增強(qiáng)現(xiàn)實(shí)世界地圖中新錨點(diǎn)接口定義：ARResultarWorldMapAcquireNewAnchor(ARSession*sessionARWorldMap*ar_map,constARPose*pose,ARAnchor**out_anchor)功能描述：使用指定的位姿來創(chuàng)建錨點(diǎn)。輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：ARWorldMap*，值：增強(qiáng)現(xiàn)實(shí)世界地圖結(jié)構(gòu)指針。類型：constARPose*，值：姿態(tài)信息。輸出參數(shù)：類型：ARAnchor**，值：創(chuàng)建新的錨點(diǎn)結(jié)構(gòu)，結(jié)構(gòu)地址保存在*out_anchor。類型：ARResult1定義。獲取增強(qiáng)現(xiàn)實(shí)世界地圖中所有錨點(diǎn)接口定義：voidarWorldMapGetAllAnchors(constARSession*session,constARWorldMap*ar_map,ARAnchorList*out_anchor_list)功能描述：獲取增強(qiáng)現(xiàn)實(shí)世界地圖結(jié)構(gòu)中所有錨點(diǎn)。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARWorldMap*，值：增強(qiáng)現(xiàn)實(shí)世界地圖結(jié)構(gòu)指針。輸出參數(shù)：類型：ARAnchorList*，值：錨點(diǎn)列表，需要預(yù)先創(chuàng)建錨點(diǎn)列表結(jié)構(gòu)。獲得增強(qiáng)現(xiàn)實(shí)世界地圖中節(jié)點(diǎn)接口定義：voidarWorldMapGetAllNodes(constARSession*sessionconstARWorldMap*ar_map,ARNodeTypefilter_type,ARNodeList*out_node_list)ARNodeType輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARWorldMap*，值：增強(qiáng)現(xiàn)實(shí)世界地圖結(jié)構(gòu)指針。類型：ARNodeType，值：指定獲取節(jié)點(diǎn)的類型，見表4定義。輸出參數(shù)：類型：ARNodeList*，值：節(jié)點(diǎn)列表，需要預(yù)先創(chuàng)建節(jié)點(diǎn)列表結(jié)構(gòu)。釋放增強(qiáng)現(xiàn)實(shí)世界地圖接口定義：voidarWorldMapRelease(ARWorldMap*ar_map)功能描述：釋放增強(qiáng)現(xiàn)實(shí)世界地圖。輸入?yún)?shù)：類型：ARWorldMap*，值：增強(qiáng)現(xiàn)實(shí)世界地圖結(jié)構(gòu)指針。輸出參數(shù)：不做定義。幀畫面創(chuàng)建幀畫面接口定義：voidarFrameCreate(ARSession*session,ARFrame**out_frame)功能描述：創(chuàng)建幀畫面結(jié)構(gòu)。輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。輸出參數(shù)：類型：ARFrame**，值：創(chuàng)建新的幀畫面結(jié)構(gòu)，結(jié)構(gòu)地址保存在*out_frame中。銷毀幀畫面接口定義：voidarFrameDestroy(ARFrame*out_frame)功能描述：銷毀幀畫面結(jié)構(gòu)。輸入?yún)?shù)：類型：ARFrame*，值：幀畫面結(jié)構(gòu)指針。輸出參數(shù)：不做定義。判斷顯示區(qū)域是否發(fā)生變化接口定義：voidarFrameGetDisplayGeometryChanged(constARSession*session,constARFrame*frame,int*ut_geometry_changed)功能描述：判斷顯示區(qū)域是否發(fā)生了變化。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARFrame*，值：幀畫面結(jié)構(gòu)指針。輸出參數(shù)：類型：int*，值：內(nèi)容是否發(fā)生變化，0表示沒有發(fā)生變化，非0為發(fā)生了變化。根據(jù)設(shè)備旋轉(zhuǎn)模式轉(zhuǎn)化紋理坐標(biāo)arFrameTransformDisplayUvCoords(constARSession*sessionconstARFrame*frame,intnum_elements,constfloat*uvs_in,float*uvs_out);功能描述：根據(jù)設(shè)備旋轉(zhuǎn)模式，將紋理坐標(biāo)轉(zhuǎn)化為對(duì)應(yīng)旋轉(zhuǎn)模式下正確的紋理坐標(biāo)。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARFrame*，值：幀畫面結(jié)構(gòu)指針。類型：int，值：需要轉(zhuǎn)化的浮點(diǎn)數(shù)數(shù)量。類型：constfloat*，值：需要轉(zhuǎn)化的紋理坐標(biāo)數(shù)組。輸出參數(shù)：類型：float*，值：輸出轉(zhuǎn)化后的紋理坐標(biāo)信息。設(shè)置點(diǎn)求交查詢模式接口定義：voidarFrameSetPointQueryMode(constARSession*sessionconstARFrame*frame,ARQueryModemode)功能描述：設(shè)置求交查詢模式。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARFrame*，值：幀畫面結(jié)構(gòu)指針。類型：ARQueryMode17獲取點(diǎn)求交查詢結(jié)果列表接口定義：voidarFramePointQuery(constARSession*sessionconstARFrame*framefloatpixel_x,floatpixel_y,ARQueryResultList*query_result_list)功能描述：從視點(diǎn)到屏幕交點(diǎn)投射光線，同節(jié)點(diǎn)求交，獲得求交查詢結(jié)果列表。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARFrame*，值：幀畫面結(jié)構(gòu)指針。類型：floatXY輸出參數(shù)：類型：ARQueryResultList*，值：求交獲得的查詢結(jié)果列表，需要預(yù)先創(chuàng)建該結(jié)構(gòu)。獲取線求交查詢結(jié)果列表接口定義：voidarFrameRayQuery(constARSession*session,constARFrame*frame,constfloat*ray_origin_3,constfloat*ray_direction_3,ARQueryResultList*hit_result_list)功能描述：發(fā)射任意一條射線，同節(jié)點(diǎn)求交，獲得求交查詢結(jié)果列表。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARFrame*，值：幀畫面結(jié)構(gòu)指針。類型：constfloat*3float*3輸出參數(shù)：類型：ARQueryResultList*，值：求交獲得的查詢結(jié)果列表，需要預(yù)先創(chuàng)建該結(jié)構(gòu)。獲取當(dāng)前幀的光照估計(jì)接口定義：voidarFrameGetIlluminationEstimate(constARSession*sessionconstARFrame*frame,ARIlluminationEstimate*out_light_estimate)功能描述：獲取當(dāng)前幀的光照估計(jì)結(jié)構(gòu)。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARFrame*，值：幀畫面結(jié)構(gòu)指針。輸出參數(shù)：類型：ARIlluminationEstimate*，值：光照估計(jì)結(jié)構(gòu)指針，需要預(yù)先創(chuàng)建該結(jié)構(gòu)。獲取當(dāng)前幀的稀疏點(diǎn)云接口定義：ARResultarFrameAcquirePointCloud(constARSession*session,constARFrame*frame,ARPointCloud**out_point_cloud)功能描述：創(chuàng)建當(dāng)前幀新的稀疏點(diǎn)云結(jié)構(gòu)。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARFrame*，值：幀畫面結(jié)構(gòu)指針。輸出參數(shù)：*out_point_cloud1定義。獲取當(dāng)前幀的新相機(jī)接口定義：voidarFrameAcquireCamera(constARSession*session,constARFrame*frame,ARCamera**out_camera)功能描述：創(chuàng)建當(dāng)前幀新的相機(jī)結(jié)構(gòu)。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARFrame*，值：幀畫面結(jié)構(gòu)指針。輸出參數(shù)：類型：ARCamera**，值：創(chuàng)建新的相機(jī)結(jié)構(gòu)，結(jié)構(gòu)地址保存在*out_camera中。獲取當(dāng)前幀的稠密網(wǎng)格接口定義：ARResultarFrameAcquireDenseMesh(constARSession*session,constARFrame*frame,ARDenseMesh**out_dense_mesh)功能描述：創(chuàng)建當(dāng)前幀新的稠密網(wǎng)格結(jié)構(gòu)。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARFrame*，值：幀畫面結(jié)構(gòu)指針。輸出參數(shù)：類型：ARDenseMesh**，值：創(chuàng)建新的稠密網(wǎng)格結(jié)構(gòu)，結(jié)構(gòu)地址保存在*out_desh_mesh中。獲取更新的錨點(diǎn)列表接口定義：voidarFrameGetUpdatedAnchors(constARSession*sessionconstARFrame*frame,ARAnchorList*out_anchor_list)功能描述：獲得更新的錨點(diǎn)列表，增強(qiáng)現(xiàn)實(shí)會(huì)話更新過程中，部分錨點(diǎn)位置等信息會(huì)發(fā)生變化。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARFrame*，值：幀畫面結(jié)構(gòu)指針。輸出參數(shù)：類型：ARAnchorList*，值：錨點(diǎn)列表，該結(jié)構(gòu)預(yù)先創(chuàng)建。獲取更新的節(jié)點(diǎn)列表接口定義：voidarFrameGetUpdatedNodes(constARSession*sessionconstARFrame*frame,ARNodeTypefilter_type,ARNodeList*out_node_list);功能描述：獲得更新的節(jié)點(diǎn)列表，增強(qiáng)現(xiàn)實(shí)會(huì)話更新過程中，部分節(jié)點(diǎn)位置等信息會(huì)發(fā)生變化，通過設(shè)置節(jié)點(diǎn)類型，可以返回指定類型的節(jié)點(diǎn)。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARFrame*，值：幀畫面結(jié)構(gòu)指針。類型：ARNodeType4輸出參數(shù)：類型：ARNodeList*，值：返回節(jié)點(diǎn)列表，該結(jié)構(gòu)預(yù)先創(chuàng)建。判斷當(dāng)前幀圖像是否更新接口定義：voidarFrameIsImageUpdated(constARSession*session,constARFrame*frame,int*data_updated)功能描述：當(dāng)前圖像是否更新。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARFrame*，值：幀畫面結(jié)構(gòu)指針。類型：ARNodeType4類型：int*，值：數(shù)據(jù)內(nèi)容是否更新過，非零表示更新過，0為未更新。獲取當(dāng)前幀圖像格式接口定義：voidarFrameGetImageFormat(constARSession*session,constARFrame*frame,ARPixelFormat*video_image_format)功能描述：獲取當(dāng)前幀圖像格式。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARFrame*，值：幀畫面結(jié)構(gòu)指針。輸出參數(shù)：類型：ARPixelFormat*，值：畫面的像素格式指針，見表12定義。獲取當(dāng)前幀圖像分辨率接口定義：ARResultarFrameGetImageResolution(constARSession*sessionconstARFrame*frame,int*outwidth,int*outheight)功能描述：獲取當(dāng)前幀圖像分辨率。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARFrame*，值：幀畫面結(jié)構(gòu)指針。輸出參數(shù)：類型：int*，值：畫面寬像素?cái)?shù)量。類型：int*，值：畫面高像素?cái)?shù)量。類型：ARResult，值：返回值，見表1定義。獲取當(dāng)前幀圖像數(shù)據(jù)接口定義：ARResultarFrameGetImageData(constARSession*sessionconstARFrame*frame,unsignedchar*out_data1,unsignedchar*out_data2,unsignedchar*out_data3)YUVYout_data2UV輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARFrame*，值：幀畫面結(jié)構(gòu)指針。輸出參數(shù)：類型：unsignedchar*，值：YUVYchar*，值：YUVUVchar*，值：預(yù)留未使用。類型：ARResult，值：返回值，見表1定義。判斷當(dāng)前幀深度圖像是否可用接口定義：ARResultarFrameIsDepthImageAvaliable(constARSession*session,constARFrame*frame)功能描述：判斷當(dāng)前深度圖像是否可用。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARFrame*，值：幀畫面結(jié)構(gòu)指針。輸出參數(shù)：類型：ARResult，值：返回值，見表1定義。獲取當(dāng)前幀深度圖像格式接口定義：voidarFrameGetDepthImageFormat(constARSession*session,constARFrame*frame,ARPixelFormat*out_format)功能描述：獲取當(dāng)前幀深度圖像格式。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARFrame*，值：幀畫面結(jié)構(gòu)指針。輸出參數(shù)：類型：ARPixelFormat*，值：深度圖像格式，見表12定義。獲取當(dāng)前幀深度圖像分辨率接口定義：ARResultarFrameGetDepthImageResolution(constARSession*session,constARFrame*frame,int*out_width,int*out_height)功能描述：獲取當(dāng)前幀深度圖像分辨率。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARFrame*，值：幀畫面結(jié)構(gòu)指針。輸出參數(shù)：類型：int*，值：返回深度畫面寬像素?cái)?shù)量。類型：int*，值：返回深度畫面高像素?cái)?shù)量。類型：ARResult1定義。獲取當(dāng)前幀深度圖像數(shù)據(jù)接口定義：ARResultarFrameGetDepthImageData(constARSession*session,constARFrame*frame,unsignedchar*out_depth_image_data)功能描述：獲取當(dāng)前幀圖像數(shù)據(jù)。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARFrame*，值：幀畫面結(jié)構(gòu)指針。輸出參數(shù)：類型：unsignedchar*，值：深度圖像數(shù)據(jù)。類型：ARResult，值：返回值，見表1定義。相機(jī)模型獲取相機(jī)位姿arCameraGetPose(constARSession*sessionconstARCamera*cameraARPose*out_pose)功能描述：獲取相機(jī)結(jié)構(gòu)的位姿信息。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARCamera*，值：相機(jī)結(jié)構(gòu)指針。輸出參數(shù)：類型：ARPose*，值：位姿結(jié)構(gòu)指針。獲取相機(jī)視圖矩陣接口定義：voidarCameraGetViewMatrix(constARSession*sessionconstARCamera*camera,float*out_col_major_4x4)功能描述：獲取相機(jī)結(jié)構(gòu)的視圖矩陣信息。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARCamera*，值：相機(jī)結(jié)構(gòu)指針。輸出參數(shù)：類型：float*，值：輸出相機(jī)矩陣數(shù)組，是由16個(gè)單精度浮點(diǎn)數(shù)組成的一維數(shù)組。獲取相機(jī)跟蹤狀態(tài)接口定義：voidarCameraGetTrackingState(constARSession*session,constARCamera*camera,ARTrackingState*out_tracking_state)功能描述：獲取相機(jī)結(jié)構(gòu)的跟蹤狀態(tài)信息。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARCamera*，值：相機(jī)結(jié)構(gòu)指針。輸出參數(shù)：類型：ARTrackingState*，值：相機(jī)跟蹤狀態(tài)指針，見表8定義。獲取相機(jī)投影矩陣接口定義：voidarCameraGetProjectionMatrix(constARSession*session,constARCamera*camera,floatnear,floatfar,float*dest_col_major_4x4)功能描述：獲取相機(jī)結(jié)構(gòu)的投影矩陣信息。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARCamera*，值：相機(jī)結(jié)構(gòu)指針。類型：float，值：相機(jī)近平面距離。類型：float，值：相機(jī)遠(yuǎn)平面距離。輸出參數(shù)：類型：float*，值：輸出投影矩陣數(shù)組，是由16個(gè)單精度浮點(diǎn)數(shù)組成的列矩陣數(shù)據(jù)。獲取相機(jī)算法圖像內(nèi)參接口定義：voidarCameraGetImageIntrinsics(constARSession*session,constARCamera*camera,ARCameraIntrinsics*out_camera_intrinsics)功能描述：獲取相機(jī)結(jié)構(gòu)的圖像內(nèi)參信息。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARCamera*，值：相機(jī)結(jié)構(gòu)指針。輸出參數(shù)：類型：ARCameraIntrinsics*，值：相機(jī)圖像內(nèi)參參數(shù)。獲取相機(jī)紋理圖像內(nèi)參接口定義：voidarCameraGetTextureIntrinsics(constARSession*session,constARCamera*camera,,ARCameraIntrinsics*out_camera_intrinsics);功能描述：獲取相機(jī)結(jié)構(gòu)的紋理內(nèi)參信息。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARCamera*，值：相機(jī)結(jié)構(gòu)指針。輸出參數(shù)：類型：ARCameraI