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

1信息技術(shù)移動(dòng)設(shè)備增強(qiáng)現(xiàn)實(shí)系統(tǒng)應(yīng)用接口本文件規(guī)定了移動(dòng)設(shè)備增強(qiáng)現(xiàn)實(shí)系統(tǒng)應(yīng)用開(kāi)發(fā)的數(shù)據(jù)類型和接口。本文件適用于移動(dòng)設(shè)備增強(qiáng)現(xiàn)實(shí)系統(tǒng)的設(shè)計(jì)、開(kāi)發(fā)和應(yīng)用。2規(guī)范性引用文件下列文件中的內(nèi)容通過(guò)文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對(duì)應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T38247-2019信息技術(shù)增強(qiáng)現(xiàn)實(shí)術(shù)語(yǔ)T/CESAXXXXX信息技術(shù)移動(dòng)設(shè)備增強(qiáng)現(xiàn)實(shí)系統(tǒng)技術(shù)規(guī)范3術(shù)語(yǔ)和定義GB/T38247-2019和T/CESAXXXXX界定的以及下列術(shù)語(yǔ)和定義適合于本文件。為了便于使用，以下重復(fù)列出了GB/T38247—2019中的某些術(shù)語(yǔ)和定義。3.1參考圖像referenceimage在環(huán)境中可被識(shí)別的二維圖像。[來(lái)源：GB/T38247-2019，2.2.18]3.2增強(qiáng)現(xiàn)實(shí)會(huì)話augmentedrealitysession負(fù)責(zé)管理增強(qiáng)現(xiàn)實(shí)系統(tǒng)的整個(gè)運(yùn)行過(guò)程，包括創(chuàng)建、啟動(dòng)、更新、關(guān)閉、銷毀等各個(gè)過(guò)程。3.3增強(qiáng)現(xiàn)實(shí)地圖augmentedrealitymap增強(qiáng)現(xiàn)實(shí)運(yùn)行過(guò)程中構(gòu)建的地圖結(jié)構(gòu)，包括檢測(cè)到的點(diǎn)云、平面節(jié)點(diǎn)、圖像節(jié)點(diǎn)等信息，以及用戶創(chuàng)建的錨點(diǎn)。3.4節(jié)點(diǎn)node增強(qiáng)現(xiàn)實(shí)運(yùn)行過(guò)程中識(shí)別出的平面、圖像、手勢(shì)等具體對(duì)象信息。3.52點(diǎn)云pointcloud在增強(qiáng)現(xiàn)實(shí)應(yīng)用中，用于恢復(fù)三維場(chǎng)景而使用的場(chǎng)景物體表面的三維點(diǎn)數(shù)據(jù)集合。[來(lái)源：GB/T38247-2019，2.2.47]3.6稠密網(wǎng)格densemesh稠密三維重建過(guò)程中，恢復(fù)的場(chǎng)景三角形網(wǎng)格。4縮略語(yǔ)下列縮略語(yǔ)適用于本文件。6DoF：六自由度（SixDegreesofFreedom）AR：增強(qiáng)現(xiàn)實(shí)(AugmentedReality)API：應(yīng)用程序編程接口（ApplicationProgrammingInterface）FPS：每秒幀數(shù)（FramesPerSecond）IMU：慣性測(cè)量單元（InertialMeasurementUnit）SLAM：同步定位與地圖構(gòu)建（SimultaneousLocalizationAndMapping）5總體結(jié)構(gòu)增強(qiáng)現(xiàn)實(shí)系統(tǒng)總體結(jié)構(gòu)如圖1所示。圖1增強(qiáng)現(xiàn)實(shí)系統(tǒng)總體結(jié)構(gòu)36數(shù)據(jù)類型6.1結(jié)果結(jié)果數(shù)據(jù)類型命名為ARResult，其值定義如表1所示。表1結(jié)果數(shù)據(jù)類型ARResult定義ARResult值描述ARRESULT_SUCCESS=0成功或者正確。ARRESULT_ERROR_INVALID_ARGUMENT=1包含無(wú)效參數(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沒(méi)有可用資源導(dǎo)致的錯(cuò)誤。ARRESULT_ERROR_CLOUD_ANCHORS_NOT_CONFIGURED=12沒(méi)有對(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ò)誤。6.2設(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è)備。6.3數(shù)據(jù)流模式數(shù)據(jù)流模式數(shù)據(jù)類型命名為ARStreamMode，其值定義如表3所示。4表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ī)模式。6.4節(jié)點(diǎn)節(jié)點(diǎn)數(shù)據(jù)類型命名為ARNodeType，其值定義如表4所示。表4節(jié)點(diǎn)數(shù)據(jù)類型ARNodeType定義ARNodeType值描述ARNODE_TYPE_NOT_VALID=0節(jié)點(diǎn)類型無(wú)效。ARNODE_TYPE_PLANE=1平面節(jié)點(diǎn)類型。ARNODE_TYPE_IMAGE=2圖像節(jié)點(diǎn)類型。ARNODE_TYPE_HAND_GESTURE=3手勢(shì)節(jié)點(diǎn)類型。6.5算法算法數(shù)據(jù)類型命名為ARAlgorithmType，其值定義如表5所示。表5算法數(shù)據(jù)類型ARAlgorithmType定義ARAlgorithmType值描述ARALGORITHM_TYPE_UNDEFINED=0非法算法類型。ARALGORITHM_TYPE_SLAM=1SLAM算法類型。ARALGORITHM_TYPE_HAND_GESTURE=2手勢(shì)算法類型。ARALGORITHM_TYPE_DENSE_RECON=3稠密網(wǎng)格重建算法類型。ARALGORITHM_TYPE_IMAGE_TRACKING=4圖像跟蹤算法類型。ARALGORITHM_TYPE_PLANE_DETECTION=5平面檢測(cè)算法類型。ARALGORITHM_TYPE_ILLUMINATION_ESTIMATION=6光照估計(jì)算法類型。ARALGORITHM_TYPE_CLOUD_ANCHOR=7云錨點(diǎn)算法類型。6.6算法模式算法模式數(shù)據(jù)類型命名為ARAlgorithmMode，其值定義如表6所示。表6算法模式數(shù)據(jù)類型ARAlgorithmMode定義ARAlgorithmMode值描述ARALGORITHM_MODE_DISABLE=0算法關(guān)閉模式。ARALGORITHM_MODE_ENABLE=1算法激活模式。6.7可用性5可用性數(shù)據(jù)類型命名為ARAvailability，其值定義如表7所示。表7可用性數(shù)據(jù)類型ARAvailability定義ARAvailability值描述ARAVAILABILITY_UNKNOWN_ERROR=0未知錯(cuò)誤。ARAVAILABILITY_UNSUPPORTED_DEVICE_NOT_CAPABLE=100設(shè)備不支持AR。ARAVAILABILITY_SUPPORTED_NOT_INSTALLED=201設(shè)備支持，模塊未安裝導(dǎo)致不可用。ARAVAILABILITY_SUPPORTED_VERSION_TOO_OLD=202設(shè)備支持，模塊版本太舊導(dǎo)致不可用。ARAVAILABILITY_SUPPORTED=203設(shè)備支持，并且可用。6.8跟蹤狀態(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)。6.9跟蹤運(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)行。6.10世界坐標(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)系。ARWORLD_ALIGNMENT_MODE_GRAVITY_HEADING=1根據(jù)指南針和重力方向構(gòu)建世界坐標(biāo)系，y軸同重力方向平行，(0,-1,0)朝下，z軸同南北方向平行，(0,0,1)指向所在位置的朝南方向。66.11頂點(diǎn)格式頂點(diǎn)格式數(shù)據(jù)類型命名為ARVertexFormat，其值定義如表11所示。表11頂點(diǎn)格式數(shù)據(jù)類型ARVertexFormat定義ARVertexFormat值描述ARVERTEX_FORMAT_3D_POSITION=0頂點(diǎn)數(shù)據(jù)包含3個(gè)float值，表示該點(diǎn)坐標(biāo)。ARVERTEX_FORMAT_3D_POSITION_NORMAL=1頂點(diǎn)數(shù)據(jù)包含6個(gè)float值，表示該點(diǎn)坐標(biāo)和經(jīng)過(guò)該點(diǎn)的平面法線向量。ARVERTEX_FORMAT_3D_POSITION_NORMAL_COLOR=2頂點(diǎn)數(shù)據(jù)包含10個(gè)float值，表示該點(diǎn)坐標(biāo)、經(jīng)過(guò)該點(diǎn)的平面法線向量和該點(diǎn)的RGBA數(shù)據(jù)。ARVERTEX_FORMAT_NOT_VALID=3非法頂點(diǎn)數(shù)據(jù)。6.12像素格式像素格式數(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格式。6.13參數(shù)參數(shù)數(shù)據(jù)類型命名為ARParameterEnum，其值定義如表13所示。表13參數(shù)數(shù)據(jù)類型ARParameterEnum定義ARParameterEnum值描述ARPARAMETER_VIDEO_VERTICAL_FOV=50視頻垂直方向FOV。ARPARAMETER_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。7ARIlluminationEstimateModeARIlluminationEstimateMode值描述ARILLUMINATION_ESTIMATE_MODE_AMBIENT_INTENSITY=1環(huán)境光亮度模式，包含單一亮度值。6.14左右眼左右眼數(shù)據(jù)類型命名為AREyeSide，其值定義如表14所示。表14左右眼數(shù)據(jù)類型AREyeSide定義AREyeSide值描述AREYE_LEFT=0左眼。AREYE_RIGHT=1右眼。6.15光照估計(jì)模式光照估計(jì)模式數(shù)據(jù)類型命名為ARIlluminationEstimateMode，其值定義如表15所示。表15光照估計(jì)模式數(shù)據(jù)類型ARIlluminationEstimateMode定義6.166.16光照估計(jì)狀態(tài)光照估計(jì)狀態(tài)數(shù)據(jù)類型命名為ARIlluminationEstimateState，其定義如表16所示。表16光照估計(jì)狀態(tài)數(shù)據(jù)類型ARIlluminationEstimateState定義ARIlluminationEstimateState值描述ARILLUMINATION_ESTIMATE_STATE_NOT_VALID=0光照估計(jì)結(jié)果暫時(shí)還不可用。ARILLUMINATION_ESTIMATE_STATE_VALID=1光照估計(jì)結(jié)果可用6.17求交查詢模式求交查詢模式數(shù)據(jù)類型命名為ARQueryMode，其值定義如表17所示。表17求交查詢模式數(shù)據(jù)類型ARQueryMode定義ARQueryMode值描述ARQUERY_MODE_POLYGON_ONLY=0只能跟多邊形平面求交查詢。ARQUERY_MODE_POLYGON_AND_HORIZONPLANE=1能跟多邊形平面以及水平多邊形所在整個(gè)無(wú)限平面求交查詢。ARQUERY_MODE_POLYGON_PERSISTENCE=2能跟多邊形平面以及多邊形平面所在的無(wú)限平面求交查詢，多邊形平面優(yōu)先。6.18云錨點(diǎn)狀態(tài)云錨點(diǎn)狀態(tài)數(shù)據(jù)類型命名為ARCloudAnchorState，其值定義如表18所示。8表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托管或解析沒(méi)有被授權(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沒(méi)有被找到。ARCLOUD_ANCHOR_STATE_ERROR_RESOLVING_LOCALIZATION_NO_MATCH=-7解析失敗，環(huán)境無(wú)法匹配。6.19平面平面數(shù)據(jù)類型命名為ARPlaneType，其值定義如表19所示。表19平面數(shù)據(jù)類型ARPlaneType定義ARCLOUD_ANCHOR_6.19平面平面數(shù)據(jù)類型命名為ARPlaneType，其值定義如表19所示。表19平面數(shù)據(jù)類型ARPlaneType定義解析錨點(diǎn)的SDK版本過(guò)舊。ARCLOUD_ANCHOR_STATE_ERROR_RESOLVING_SDK_VERSION_TOO_NEW=-9解析錨點(diǎn)的SDK版本過(guò)新。ARCLOUD_ANCHOR_STATE_ERROR_UNKNOWN=-11未知錯(cuò)誤。ARPlaneType值描述ARPLANE_TYPE_UPWARD_FACING=0水平平面朝上類型。ARPLANE_TYPE_DOWNWARD_FACING=1水平平面朝下類型。ARPLANE_TYPE_VERTICAL=2垂直平面類型。ARPLANE_TYPE_NOT_VALID=3無(wú)效平面類型。6.20手勢(shì)手勢(shì)數(shù)據(jù)類型命名為ARHandGestureType，其值定義如表20所示。表20手勢(shì)數(shù)據(jù)類型ARHandGestureType定義ARHandGestureType值描述ARHAND_GESTURE_TYPE_UNKNOWN=-1無(wú)效手勢(shì)獲取類型。ARHAND_GESTURE_TYPE_OK=0OK手勢(shì)獲取類型。ARHAND_GESTURE_TYPE_SCISSORS=1剪刀手勢(shì)獲取類型。ARHAND_GESTURE_TYPE_THUMBS_UP=2豎起大拇指手勢(shì)獲取類型。ARHAND_GESTURE_TYPE_PAPER=3布手勢(shì)獲取類型。ARHAND_GESTURE_TYPE_GUN=4手槍手勢(shì)獲取類型。ARHAND_GESTURE_TYPE_ROCK=5石頭手勢(shì)獲取類型。ARHAND_GESTURE_TYPE_FINGER_HEART=6比心手勢(shì)獲取類型。ARHAND_GESTURE_TYPE_FINGERTIP=7指尖手勢(shì)獲取類型。ARHAND_GESTURE_TYPE_WELL_PLAYED=8做得好手勢(shì)獲取類型。977接口7.1功能擴(kuò)展7.1.1獲取擴(kuò)展函數(shù)地址ARHAND_GESTURE_TYPE_THREE_FINGERS=93個(gè)手指手勢(shì)獲取類型。ARHAND_GESTURE_TYPE_FOUR_FINGERS=104個(gè)手指手勢(shì)獲取類型。ARHAND_GESTURE_TYPE_I_LOVE_YOU=11我愛(ài)你手勢(shì)獲取類型。ARHAND_GESTURE_TYPE_INDEX_FINGER_AND_LITTLE_FINGER=12豎起食指與小拇指手勢(shì)獲取類型。ARHAND_GESTURE_TYPE_LITTLE_FINGER=13小拇指手勢(shì)獲取類型。6.21左右手左右手?jǐn)?shù)據(jù)類型命名為ARHandSide，其值定義如表21所示。表21左右手?jǐn)?shù)據(jù)類型ARHandSide定義ARHandSide值描述ARHAND_SIDE_HAND_UNKNOWN=-1無(wú)法區(qū)分左右手。ARHAND_SIDE_RIGHT_HAND=0右手。ARHAND_SIDE_LEFT_HAND=1左手。6.22手掌心朝向手掌心朝向數(shù)據(jù)類型命名為ARHandTowards，其值定義如表22所示。表22手掌心朝向數(shù)據(jù)類型ARHandTowards定義ARHandTowards值描述ARHAND_TOWARDS_UNKNOWN=-1無(wú)效的手朝向。ARHAND_TOWARDS_PALM=0手心方向。ARHAND_TOWARDS_THE_BACK_OF_HAND=1手背方向。ARHAND_TOWARDS_SIDE_HAND=2側(cè)手方向。接口定義：PFN_xrVoidFunctionarGetProcAddress(constchar*name)功能描述：通過(guò)給定的字符串，獲取功能擴(kuò)展的函數(shù)指針。輸入?yún)?shù)：類型：constchar*，值：函數(shù)指針的名字。輸出參數(shù)：類型：PFN_xrVoidFunction，值：typedefvoid(ARAPI_PTR*PFN_arVoidFunction)(void)，定義了函數(shù)指針的類型，ARAPI_PTR定義的是調(diào)用方式，當(dāng)無(wú)法獲取到指定名字的函數(shù)指針的時(shí)候，返回空指針。7.2能力檢測(cè)7.2.1檢測(cè)設(shè)備是否支持接口定義：voidarCapabilityCheckAvailability(void*env,void*context,ARAvailability*out_availability)功能描述：檢測(cè)設(shè)備是否支持運(yùn)行增強(qiáng)現(xiàn)實(shí)模塊。輸入?yún)?shù)：類型：void*，值：運(yùn)行環(huán)境。類型：void*，值：運(yùn)行上下文。輸出參數(shù)：類型：ARAvailability*，值：是否可用，參照ARAvailability定義。7.2.2檢測(cè)是否支持算法接口定義：ARResultarCapabilityCheckAlgorithm(void*env,void*context,ARAlgorithmTypetype,ARStreamModemode)功能描述：檢測(cè)設(shè)備是否支持給定數(shù)據(jù)流模式的算法，返回ARRESULT_SUCCESS表示成功。輸入?yún)?shù)：類型：類型：void*，值：運(yùn)行環(huán)境。類型：void*，值：運(yùn)行上下文。類型：ARAlgorithmType，值：算法類型，參考ARAlgorithmType定義。類型：ARStreamMode，值：數(shù)據(jù)流模式，參考ARStreamMode定義。輸出參數(shù)：類型：ARResult，值：返回值，參考ARResult定義。7.2.3檢測(cè)是否授權(quán)接口定義：ARResultarCapabilityCheckAuthorized(void*env,void*context,constchar*appId)功能描述：檢測(cè)應(yīng)用程序是否授權(quán)運(yùn)行增強(qiáng)現(xiàn)實(shí)模塊，返回ARRESULT_SUCCESS表示成功。輸入?yún)?shù)：類型：void*，值：運(yùn)行環(huán)境。類型：void*，值：運(yùn)行上下文。類型：constchar*，值：應(yīng)用程序授權(quán)字符串。輸出參數(shù)：類型：ARResult，值：返回值，參考ARResult定義。7.3位姿7.3.1創(chuàng)建位姿接口定義：voidarPoseCreate(constfloat*pose_raw,ARPose**out_pose)功能描述：創(chuàng)建位姿結(jié)構(gòu)，數(shù)組參數(shù)為6DoF信息（qx,qy,qz,qw,tx,ty,tz），數(shù)組長(zhǎng)度為7。輸入?yún)?shù)：類型：constfloat*，值：6DoF信息。輸出參數(shù)：類型：ARPose**，值：創(chuàng)建新的位姿結(jié)構(gòu)，結(jié)構(gòu)地址保存到*out_pose中。7.3.2釋放位姿接口定義：voidarPoseDestroy(ARPose*pose)功能描述：銷毀位姿結(jié)構(gòu)。輸入?yún)?shù)：類型：ARPose*，值：位姿結(jié)構(gòu)指針。輸出參數(shù)：不作定義。7.3.3獲取位姿結(jié)構(gòu)的6DoF信息接口定義：voidarPoseGetPoseRaw(constARPose*pose,float*out_pose_raw)功能描述：獲取位姿結(jié)構(gòu)對(duì)應(yīng)的6DoF信息（qx,qy,qz,qw,tx,ty,tz），數(shù)組長(zhǎng)度為7。輸入?yún)?shù)：類型：constARPose*，值：位姿結(jié)構(gòu)指針。輸出參數(shù)：類型：float*，值：6DoF信息。7.3.47.3.4獲取位姿結(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*，值：矩陣，該矩陣為列矩陣形式。7.4配置7.4.1創(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中。7.4.2銷毀配置接口定義：voidarConfigDestroy(ARConfig*config)功能描述：銷毀配置結(jié)構(gòu)。輸入?yún)?shù)：類型：ARConfig*，值：配置結(jié)構(gòu)指針。輸出參數(shù)：不做定義。7.4.3獲取配置中的設(shè)備類型接口定義：voidarConfigGetDeviceType(constARConfig*config,ARDeviceType*out_device_type)功能描述：獲取配置結(jié)構(gòu)中的設(shè)備類型。輸入?yún)?shù)：類型：constARConfig*，值：配置結(jié)構(gòu)指針。輸出參數(shù)：類型：ARDeviceType*，值：設(shè)備類型指針，參考ARDeviceType定義。7.4.4設(shè)置配置中的設(shè)備類型接口定義：voidarConfigSetDeviceType(ARConfig*config,ARDeviceTypedevice_type)功能描述：設(shè)置配置結(jié)構(gòu)中的設(shè)備類型。輸入?yún)?shù)：類型：ARConfig*，值：配置結(jié)構(gòu)指針。類型：ARDeviceType，值：設(shè)備類型，參考ARDeviceType定義。輸出參數(shù)：不做定義。7.4.5獲取配置中的算法數(shù)據(jù)流模式接口定義：voidarConfigGetAlgorithmStreamMode(constARConfig*config,ARAlgorithmTypetypetype,ARStreamMode*out_stream_mode)功能描述：獲取配置結(jié)構(gòu)中指定算法類型的數(shù)據(jù)流模式。輸入?yún)?shù)：類型：constARConfig*，值：配置結(jié)構(gòu)指針。類型：ARAlgorithmType，值：算法類型，參考ARAlgorithmType定義。輸出參數(shù)：類型：ARStreamMode*，值：數(shù)據(jù)流模式指針，參考ARStreamMode定義。7.4.6設(shè)置配置中的算法數(shù)據(jù)流模式接口定義：voidarConfigSetAlgorithmStreamMode(ARConfig*config,ARAlgorithmTypetype,ARStreamModestream_mode)功能描述：設(shè)置配置結(jié)構(gòu)中指定算法類型的數(shù)據(jù)流模式。輸入?yún)?shù)：類型：ARConfig*，值：配置結(jié)構(gòu)指針。類型：ARAlgorithmType，值：算法類型，參考ARAlgorithmType定義。類型：ARStreamMode，值：數(shù)據(jù)流模式，參考ARStreamMode定義。輸出參數(shù)：不做定義。7.4.7獲取配置中的算法開(kāi)關(guān)模式接口定義：voidarConfigGetAlgorithmMode(constARConfig*config,ARAlgorithmTypetype,ARAlgorithmMode*out_algorithm_mode)功能描述：獲取配置結(jié)構(gòu)中指定算法類型的算法開(kāi)關(guān)模式。輸入?yún)?shù)：類型：constARConfig*，值：配置結(jié)構(gòu)指針。類型：ARAlgorithmType，值：算法類型，參考ARAlgorithmType定義。輸出參數(shù)：類型：ARAlgorithmMode*，值：算法開(kāi)關(guān)模式指針，參考ARAlgorithmMode定義。7.4.8設(shè)置配置中的算法開(kāi)關(guān)模式接口定義：voidarConfigSetAlgorithmMode(ARConfig*config,ARAlgorithmTypetype,ARAlgorithmModealgorithm_mode)功能描述：設(shè)置配置結(jié)構(gòu)中指定算法類型的算法開(kāi)關(guān)模式。輸入?yún)?shù)：類型：ARConfig*，值：配置結(jié)構(gòu)指針。類型：ARAlgorithmType，值：算法類型，參考ARAlgorithmType定義。類型：ARAlgorithmMode，值：算法開(kāi)關(guān)模式，參考ARAlgorithmMode定義。輸出參數(shù)：不做定義。7.4.9獲取配置中光照估計(jì)模式接口定義：voidarConfigGetIlluminationEstimateMode(constARConfig*config,ARIlluminationEstimateMode*out_mode)功能描述：獲取配置結(jié)構(gòu)中的光照估計(jì)模式。輸入?yún)?shù)：類型：類型：constARConfig*，值：配置結(jié)構(gòu)指針。輸出參數(shù)：類型：ARIlluminationEstimateMode*，值：光照估計(jì)模式指針，參考ARIlluminationEstimateMode定義。7.4.10設(shè)置配置中光照估計(jì)模式接口定義：voidarConfigSetIlluminationEstimateMode(ARConfig*config,ARIlluminationEstimateModemode)功能描述：設(shè)置配置結(jié)構(gòu)中的光照估計(jì)模式。輸入?yún)?shù)：類型：ARConfig*，值：配置結(jié)構(gòu)指針。類型：ARIlluminationEstimateMode，值：光照估計(jì)模式，參考ARIlluminationEstimateMode定義。輸出參數(shù)：不做定義。7.4.11獲取配置中的跟蹤運(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)行模式指針，參考ARTrackingRunMode定義。7.4.12設(shè)置配置中的跟蹤運(yùn)行模式接口定義：voidarConfigSetTrackingRunMode(ARConfig*config,ARTrackingRunModetracking_run_mode)功能描述：設(shè)置配置結(jié)構(gòu)中的跟蹤運(yùn)行模式。輸入?yún)?shù)：類型：ARConfig*，值：配置結(jié)構(gòu)指針。類型：ARTrackingRunMode，值：跟蹤運(yùn)行模式，參考ARTrackingRunMode定義。輸出參數(shù)：不做定義。7.4.13獲取配置中的世界坐標(biāo)對(duì)齊模式接口定義：voidarConfigGetWorldAlignmentMode(constARConfig*config,ARWorldAlignmentMode*world_alignment_mode)功能描述：獲取配置結(jié)構(gòu)中的世界坐標(biāo)對(duì)齊模式。輸入?yún)?shù)：類型：constARConfig*，值：配置結(jié)構(gòu)指針。輸出參數(shù)：類型：ARWorldAlignmentMode*，值：世界坐標(biāo)對(duì)齊模式指針，參考ARWorldAlignmentMode定義。7.4.14設(shè)置配置中的世界坐標(biāo)對(duì)齊模式接口定義：voidarConfigSetWorldAlignmentMode(ARConfig*config,ARWorldAlignmentModeworld_alignment_mode)功能描述：設(shè)置配置結(jié)構(gòu)中的世界坐標(biāo)對(duì)齊模式。輸入?yún)?shù)：類型：ARConfig*，值：配置結(jié)構(gòu)指針。類型：ARWorldAlignmentMode，值：世界坐標(biāo)對(duì)齊模式，參考ARWorldAlignmentMode定義。輸出參數(shù)：不做定義。7.4.15獲取配置中的參考圖像數(shù)據(jù)集接口定義：voidarConfigGetReferenceImageDatabase(constARConfig*config,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)的指針。7.4.16設(shè)置配置中的參考圖像數(shù)據(jù)集接口定義：voidarConfigSetReferenceImageDatabase(ARConfig*config,constARReferenceImageDatabase*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ù)：不做定義。7.5增強(qiáng)現(xiàn)實(shí)會(huì)話7.5.1創(chuàng)建增強(qiáng)現(xiàn)實(shí)會(huì)話接口定義：ARResultarSessionCreate(void*env,void*context,ARSession**out_session)功能描述：創(chuàng)建增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)，返回ARRESULT_SUCCESS表示成功。輸入?yún)?shù)：類型：void*，值：運(yùn)行環(huán)境。類型：void*，值：運(yùn)行上下文。輸出參數(shù)：類型：ARSession**，值：創(chuàng)建新的增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)，結(jié)構(gòu)地址保存在*out_session中，如果創(chuàng)建失敗，*out_session指向的值為空指針。類型：ARResult，值：返回值，參考ARResult定義。7.5.2銷毀增強(qiáng)現(xiàn)實(shí)會(huì)話接口定義：voidarSessionDestroy(ARSession*session)功能描述：銷毀增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)。輸入?yún)?shù)：輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)結(jié)構(gòu)話指針。輸出參數(shù)：不做定義。7.5.3增強(qiáng)現(xiàn)實(shí)會(huì)話設(shè)置云服務(wù)密鑰接口定義：voidarSessionSetKeyAndSecret(ARSession*session,constchar*key,constchar*secret)功能描述：授權(quán)云服務(wù)。輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constchar*，值：Key字符串。類型：constchar*，值：Secret字符串。輸出參數(shù)：不做定義。7.5.4增強(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ù)組的長(zhǎng)度。輸出參數(shù)：類型：char*，值：填充版本號(hào)的字符串。7.5.5設(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，值：返回值，參考ARResult定義。7.5.6獲取增強(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*，值：配置指針。7.5.7恢復(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ì)場(chǎng)景進(jìn)行跟蹤識(shí)別，返回功能描述：恢復(fù)運(yùn)行增強(qiáng)現(xiàn)實(shí)會(huì)話，進(jìn)入運(yùn)行狀態(tài)，該狀態(tài)下才會(huì)對(duì)場(chǎng)景進(jìn)行跟蹤識(shí)別，返回ARRESULT_SUCCESS表示成功。輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。輸出參數(shù)：類型：ARResult，值：返回值，參考ARResult定義。7.5.8暫停運(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ì)物體場(chǎng)景的跟蹤識(shí)別，返回ARRESULT_SUCCESS表示成功。輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。輸出參數(shù)：類型：ARResult，值：返回值，參考ARResult定義。7.5.9更新增強(qiáng)現(xiàn)實(shí)會(huì)話接口定義：ARResultarSessionUpdate(ARSession*session,ARFrame*out_frame)功能描述：更新增強(qiáng)現(xiàn)實(shí)會(huì)話的內(nèi)部數(shù)據(jù)，例如更新設(shè)備姿態(tài)信息，識(shí)別的平面節(jié)點(diǎn)、圖像節(jié)點(diǎn)。該函數(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*，值：幀畫(huà)面結(jié)構(gòu)指針，需要預(yù)先創(chuàng)建，該結(jié)構(gòu)內(nèi)容會(huì)被更新。類型：ARResult，值：返回值，參考ARResult定義。7.5.10啟動(dòng)運(yùn)行增強(qiáng)現(xiàn)實(shí)會(huì)話算法接口定義：ARResultarSessionStartAlgorithm(ARSession*session,ARAlgorithmTypetype,intoption)功能描述：手動(dòng)方式啟動(dòng)算法，返回ARRESULT_SUCCESS表示成功。輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：ARAlgorithmType，值：算法類型，參考ARAlgorithmType定義。類型：int，值：?jiǎn)?dòng)算法選項(xiàng)。輸出參數(shù)：類型：ARResult，值：返回值，參考ARResult定義。7.5.11停止運(yùn)行增強(qiáng)現(xiàn)實(shí)會(huì)話算法接口定義：ARResultarSessionStopAlgorithm(ARSession*session,ARAlgorithmTypetype,intoption)功能描述：手動(dòng)方式停止算法，返回ARRESULT_SUCCESS表示成功。輸入?yún)?shù)：類型：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：ARAlgorithmType，值：算法類型，參考ARAlgorithmType定義。類型：int，值：停止算法選項(xiàng)。輸出參數(shù)：類型：ARResult，值：返回值，參考ARResult定義。7.5.12設(shè)置增強(qiáng)現(xiàn)實(shí)會(huì)話顯示區(qū)域接口定義：voidarSessionSetDisplayGeometry(ARSession*session,introtation,intwidth,intheight)功能描述：設(shè)置屏幕顯示參數(shù)。輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：int，值：手機(jī)界面朝向模式。類型：int，值：顯示區(qū)域?qū)挼南袼財(cái)?shù)量。類型：int，值：顯示區(qū)域高的像素?cái)?shù)量。輸出參數(shù)：不做定義。7.5.13獲取增強(qiáng)現(xiàn)實(shí)會(huì)話地圖接口定義：ARResultarSessionAcquireWorldMap(ARSession*session,ARWorldMap**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**，值：創(chuàng)建新的增強(qiáng)現(xiàn)實(shí)世界地圖結(jié)構(gòu)，結(jié)構(gòu)地址保存在*out_map中。類型：ARResult，值：返回值，參考ARResult定義。7.5.14獲取增強(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)指針，參考ARTrackingState定義。7.5.15增強(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。類型：ARResult，值：返回值，參考ARResult定義。7.5.16增強(qiáng)現(xiàn)實(shí)會(huì)話解析錨點(diǎn)接口定義：ARResultarSessionResolveAnchor(ARSession*session,constchar*cloud_anchor_id,ARAnchor**out_cloud_anchor)功能描述：通過(guò)云錨點(diǎn)ID解析并獲取云錨點(diǎn)。輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constchar*，值：云端錨點(diǎn)id。輸出參數(shù)：類型：ARAnchor**，值：欣創(chuàng)建的id對(duì)應(yīng)的云錨點(diǎn)結(jié)構(gòu)，結(jié)構(gòu)地址保存在*out_cloud_anchor。類型：ARResult，值：返回值，參考ARResult定義。7.5.17設(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)指針。類型：ARParameterEnum，值：參數(shù)枚舉，參考ARParameterEnum定義。類型：int*，值：參數(shù)對(duì)應(yīng)的整形數(shù)組。類型：int，值：整形數(shù)組長(zhǎng)度。輸出參數(shù)：不做定義。7.5.18設(shè)置增強(qiáng)現(xiàn)實(shí)會(huì)話浮點(diǎn)型數(shù)據(jù)類型參數(shù)值接口定義：voidarSessionSetFloatValue(ARSession*session,ARParameterEnumtype,float*value,intsize)功能描述：設(shè)置指定的浮點(diǎn)型數(shù)據(jù)類型參數(shù)的值。輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：ARParameterEnum，值：參數(shù)枚舉，參考ARParameterEnum定義。類型：float*，值：參數(shù)對(duì)應(yīng)的浮點(diǎn)數(shù)組。類型：int，值：浮點(diǎn)數(shù)組長(zhǎng)度。輸出參數(shù)：不做定義。7.5.19設(shè)置增強(qiáng)現(xiàn)實(shí)會(huì)話字符串?dāng)?shù)據(jù)類型參數(shù)值接口定義：voidarSessionSetStringValue(ARSession*session,ARParameterEnumtype,char*value,intsize)功能描述：設(shè)置指定的字符數(shù)據(jù)類型參數(shù)的值。輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：ARParameterEnum，值：參數(shù)枚舉，參考ARParameterEnum定義。類型：類型：char*，值：參數(shù)對(duì)應(yīng)的字符串?dāng)?shù)組。類型：int，值：字符串?dāng)?shù)組長(zhǎng)度。輸出參數(shù)：不做定義。7.5.20獲取增強(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)指針。類型：ARParameterEnum，值：參數(shù)枚舉，參考ARParameterEnum定義。類型：int，值：整型數(shù)組長(zhǎng)度。輸出參數(shù)：類型：int*，值：保存獲取結(jié)果的整形數(shù)組。7.5.21獲取增強(qiáng)現(xiàn)實(shí)會(huì)話獲取浮點(diǎn)型數(shù)據(jù)類型參數(shù)值接口定義：voidarSessionGetFloatValue(constARSession*session,ARParameterEnumtype,float*out_value,intsize)功能描述：獲取指定的浮點(diǎn)型數(shù)據(jù)類型參數(shù)的值。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：ARParameterEnum，值：參數(shù)枚舉，參考ARParameterEnum定義。類型：int，值：參數(shù)數(shù)組長(zhǎng)度。輸出參數(shù)：類型：float*，值：保存獲取結(jié)果的浮點(diǎn)數(shù)組。7.5.22獲取增強(qiáng)現(xiàn)實(shí)會(huì)話字符串?dāng)?shù)據(jù)類型參數(shù)值接口定義：voidarSessionGetStringValue(constARSession*session,ARParameterEnumtype,char*out_value,int*out_length,intsize)功能描述：獲取指定的字符數(shù)據(jù)類型參數(shù)的值。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：ARParameterEnum，值：參數(shù)枚舉，參考ARParameterEnum定義。類型：int，值：字符串?dāng)?shù)組長(zhǎng)度。輸出參數(shù)：類型：char*，值：保存獲取結(jié)果的字符串?dāng)?shù)組。類型：int*，值：字符串?dāng)?shù)組被填充的長(zhǎng)度。7.5.23開(kāi)始增強(qiáng)現(xiàn)實(shí)會(huì)話頭戴式設(shè)備左右眼繪制接口定義：ARResultarSessionRenderBeginEye(ARSession*session,AREyeSideeye)功能描述：開(kāi)始頭戴式設(shè)備左右眼繪制流程狀態(tài)。輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：類型：AREyeSide，值：左右眼類型，參考AREyeSide定義。輸出參數(shù)：類型：ARResult，值：返回值，參考ARResult定義。7.5.24結(jié)束增強(qiáng)現(xiàn)實(shí)會(huì)話頭戴式設(shè)備左右眼繪制接口定義：ARResultarSessionEndEye(ARSession*session,AREyeSide功能描述：結(jié)束頭戴式設(shè)備左右眼繪制流程狀態(tài)。輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：AREyeSide，值：左右眼類型，參考AREyeSide定義。輸出參數(shù)：類型：ARResult，值：返回值，參考ARResult定義。7.5.25提交增強(qiáng)現(xiàn)實(shí)會(huì)話頭戴式設(shè)備左右眼繪制結(jié)果接口定義：ARResultarSessionRenderSubmitFrame(ARSession*leftEyeTextureId,constintrightEyeTextureId)功能描述：提交左右眼繪制結(jié)果給增強(qiáng)現(xiàn)實(shí)會(huì)話，實(shí)現(xiàn)異步時(shí)間扭曲（ATW）繪制。session,consteye)輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constint，值：左眼離屏繪制結(jié)果紋理參數(shù)。類型：constint，值：右眼離屏繪制結(jié)果紋理參數(shù)。輸出參數(shù)：類型：ARResult，值：返回值，參考ARResult定義。7.5.26設(shè)置增強(qiáng)現(xiàn)實(shí)會(huì)話頭戴式設(shè)備繪制窗口環(huán)境接口定義：ARResultarSessionRenderSetWindow(ARSession*session,void*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，值：返回值，參考ARResult定義。7.6增強(qiáng)現(xiàn)實(shí)世界地圖7.6.1獲取增強(qiáng)現(xiàn)實(shí)世界地圖中新錨點(diǎn)接口定義：ARResultarWorldMapAcquireNewAnchor(ARSession*session,ARWorldMap*ar_map,constARPose*pose,ARAnchor**out_anchor)功能描述：使用指定的位姿來(lái)創(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ù)：輸出參數(shù)：類型：ARAnchor**，值：創(chuàng)建新的錨點(diǎn)結(jié)構(gòu)，結(jié)構(gòu)地址保存在*out_anchor。類型：ARResult，值：返回值，參考ARResult定義。7.6.2獲取增強(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)。7.6.3獲得增強(qiáng)現(xiàn)實(shí)世界地圖中節(jié)點(diǎn)接口定義：voidarWorldMapGetAllNodes(constARSession*session,constARWorldMap*ar_map,ARNodeTypefilter_type,ARNodeList*out_node_list)功能描述：獲取增強(qiáng)現(xiàn)實(shí)世界地圖中所有節(jié)點(diǎn)，包括平面、圖像、手勢(shì)節(jié)點(diǎn)。ARNodeType參數(shù)用于過(guò)濾需要返回的節(jié)點(diǎn)類型。輸入?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)的類型，參考ARNodeType定義。輸出參數(shù)：類型：ARNodeList*，值：節(jié)點(diǎn)列表，需要預(yù)先創(chuàng)建節(jié)點(diǎn)列表結(jié)構(gòu)。7.6.4釋放增強(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ù)：不做定義。7.7幀畫(huà)面7.7.1創(chuàng)建幀畫(huà)面接口定義：voidarFrameCreate(ARSession*session,ARFrame**out_frame)功能描述：創(chuàng)建幀畫(huà)面結(jié)構(gòu)。輸入?yún)?shù)：類型：ARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。輸出參數(shù)：類型：ARFrame**，值：創(chuàng)建新的幀畫(huà)面結(jié)構(gòu)，結(jié)構(gòu)地址保存在*out_frame中。7.7.2銷毀幀畫(huà)面接口定義：接口定義：voidarFrameDestroy(ARFrame*out_frame)功能描述：銷毀幀畫(huà)面結(jié)構(gòu)。輸入?yún)?shù)：類型：ARFrame*，值：幀畫(huà)面結(jié)構(gòu)指針。輸出參數(shù)：不做定義。7.7.3判斷顯示區(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*，值：幀畫(huà)面結(jié)構(gòu)指針。輸出參數(shù)：類型：int*，值：內(nèi)容是否發(fā)生變化，0表示沒(méi)有發(fā)生變化，非0為發(fā)生了變化。7.7.4根據(jù)設(shè)備旋轉(zhuǎn)模式轉(zhuǎn)化紋理坐標(biāo)接口定義：voidarFrameTransformDisplayUvCoords(constARSession*session,constARFrame*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*，值：幀畫(huà)面結(jié)構(gòu)指針。類型：int，值：需要轉(zhuǎn)化的浮點(diǎn)數(shù)數(shù)量。類型：constfloat*，值：需要轉(zhuǎn)化的紋理坐標(biāo)數(shù)組。輸出參數(shù)：類型：float*，值：輸出轉(zhuǎn)化后的紋理坐標(biāo)信息。7.7.5設(shè)置點(diǎn)求交查詢模式接口定義：voidarFrameSetPointQueryMode(constARSession*session,constARFrame*frame,ARQueryModemode)功能描述：設(shè)置求交查詢模式。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARFrame*，值：幀畫(huà)面結(jié)構(gòu)指針。類型：ARQueryMode，值：求交查詢模式，參考ARQueryMode定義。輸出參數(shù)：不做定義。7.7.6獲取點(diǎn)求交查詢結(jié)果列表接口定義：voidarFramePointQuery(constARSession*session,constARFrame*frame,floatpixel_x,floatpixel_y,ARQueryResultList*query_result_list)功能描述：從從視點(diǎn)到屏幕交點(diǎn)投射光線，同節(jié)點(diǎn)求交，獲得求交查詢結(jié)果列表。輸入?yún)?shù)：輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARFrame*，值：幀畫(huà)面結(jié)構(gòu)指針。類型：float，值：屏幕點(diǎn)擊位置的X坐標(biāo)。類型：float，值：屏幕點(diǎn)擊位置的Y坐標(biāo)。輸出參數(shù)：類型：ARQueryResultList*，值：求交獲得的查詢結(jié)果列表，需要預(yù)先創(chuàng)建該結(jié)構(gòu)。7.7.7獲取線求交查詢結(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*，值：幀畫(huà)面結(jié)構(gòu)指針。類型：constfloat*，值：射線的起點(diǎn)坐標(biāo)，包含3個(gè)浮點(diǎn)數(shù)。類型：constfloat*，值：射線的方向向量，包含3個(gè)浮點(diǎn)數(shù)。輸出參數(shù)：類型：ARQueryResultList*，值：求交獲得的查詢結(jié)果列表，需要預(yù)先創(chuàng)建該結(jié)構(gòu)。7.7.8獲取當(dāng)前幀的光照估計(jì)接口定義：voidarFrameGetIlluminationEstimate(constARSession*session,constARFrame*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*，值：幀畫(huà)面結(jié)構(gòu)指針。輸出參數(shù)：類型：ARIlluminationEstimate*，值：光照估計(jì)結(jié)構(gòu)指針，需要預(yù)先創(chuàng)建該結(jié)構(gòu)。7.7.9獲取當(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*，值：幀畫(huà)面結(jié)構(gòu)指針。輸出參數(shù)：類型：ARPointCloud**，值：創(chuàng)建新的稀疏點(diǎn)云結(jié)構(gòu)，結(jié)構(gòu)地址保存在*out_point_cloud中。類型：ARResult，值：返回值，參考ARResult定義。7.7.10獲取當(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*，值：幀畫(huà)面結(jié)構(gòu)指針。輸出參數(shù)：類型：ARCamera**，值：創(chuàng)建新的相機(jī)結(jié)構(gòu)，結(jié)構(gòu)地址保存在*out_camera中。7.7.11獲取當(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*，值：幀畫(huà)面結(jié)構(gòu)指針。輸出參數(shù)：類型：ARDenseMesh**，值：創(chuàng)建新的稠密網(wǎng)格結(jié)構(gòu)，結(jié)構(gòu)地址保存在*out_desh_mesh中。7.7.12獲取更新的錨點(diǎn)列表接口定義：voidarFrameGetUpdatedAnchors(constARSession*session,constARFrame*frame,ARAnchorList*out_anchor_list)功能描述：獲得更新的錨點(diǎn)列表，增強(qiáng)現(xiàn)實(shí)會(huì)話更新過(guò)程中，部分錨點(diǎn)位置等信息會(huì)發(fā)生變化。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARFrame*，值：幀畫(huà)面結(jié)構(gòu)指針。輸出參數(shù)：類型：ARAnchorList*，值：錨點(diǎn)列表，該結(jié)構(gòu)預(yù)先創(chuàng)建。7.7.13獲取更新的節(jié)點(diǎn)列表接口定義：voidarFrameGetUpdatedNodes(constARSession*session,constARFrame*frame,ARNodeTypefilter_type,ARNodeList*out_node_list);功能描述：獲得更新的節(jié)點(diǎn)列表，增強(qiáng)現(xiàn)實(shí)會(huì)話更新過(guò)程中，部分節(jié)點(diǎn)位置等信息會(huì)發(fā)生變化，通過(guò)設(shè)置節(jié)點(diǎn)類型，可以返回指定類型的節(jié)點(diǎn)。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARFrame*，值：幀畫(huà)面結(jié)構(gòu)指針。類型：ARNodeType，值：節(jié)點(diǎn)類型。輸出參數(shù)：類型：ARNodeList*，值：返回節(jié)點(diǎn)列表，該結(jié)構(gòu)預(yù)先創(chuàng)建。7.7.14判斷當(dāng)前幀圖像是否更新接口定義：voidarFrameIsImageUpdated(constARSession*session,constARFrame*frame,int*data_updateddata_updated)功能描述：當(dāng)前圖像是否更新。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARFrame*，值：幀畫(huà)面結(jié)構(gòu)指針。類型：ARNodeType，值：節(jié)點(diǎn)類型。輸出參數(shù)：類型：int*，值：數(shù)據(jù)內(nèi)容是否更新過(guò)，非零表示更新過(guò)，0為未更新。7.7.15獲取當(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*，值：幀畫(huà)面結(jié)構(gòu)指針。輸出參數(shù)：類型：ARPixelFormat*，值：畫(huà)面的像素格式指針，參考ARPixelFormat定義。7.7.16獲取當(dāng)前幀圖像分辨率接口定義：ARResultarFrameGetImageResolution(constARSession*session,constARFrame*frame,int*outwidth,int*outheight)功能描述：獲取當(dāng)前幀圖像分辨率。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARFrame*，值：幀畫(huà)面結(jié)構(gòu)指針。輸出參數(shù)：類型：int*，值：畫(huà)面寬像素?cái)?shù)量。類型：int*，值：畫(huà)面高像素?cái)?shù)量。類型：ARResult，值：返回值，參考ARResult定義。7.7.17獲取當(dāng)前幀圖像數(shù)據(jù)接口定義：ARResultarFrameGetImageData(constARSession*session,constARFrame*frame,unsignedchar*out_data1,unsignedchar*out_data2,unsignedchar*out_data3)功能描述：獲取當(dāng)前幀圖像數(shù)據(jù)，圖像數(shù)據(jù)根據(jù)格式通過(guò)不同方式返回，例如目前支持的YUV格式，out_data1返回的Y通道的數(shù)據(jù)，out_data2返回的是UV通道的數(shù)據(jù)，未來(lái)支持格式的擴(kuò)展，通過(guò)不同的方式進(jìn)行返回。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARFrame*，值：幀畫(huà)面結(jié)構(gòu)指針。輸出參數(shù)：類型：unsignedchar*，值：YUV格式時(shí)，返回圖像Y通道數(shù)據(jù)。類型：unsignedchar*，值：YUV格式時(shí)，返回圖像UV通道數(shù)據(jù)。類型：類型：unsignedchar*，值：預(yù)留未使用。類型：ARResult，值：返回值，參考ARResult定義。7.7.18判斷當(dāng)前幀深度圖像是否可用接口定義：ARResultarFrameIsDepthImageAvaliable(constARSession*session,constARFrame*frame)功能描述：判斷當(dāng)前深度圖像是否可用。輸入?yún)?shù)：類型：constARSession*，值：增強(qiáng)現(xiàn)實(shí)會(huì)話結(jié)構(gòu)指針。類型：constARFrame*，值：幀畫(huà)面結(jié)構(gòu)指針。輸出參數(shù)：類型：ARResult，值：返回值，參考ARResult定義。7.7.19獲取當(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*，值：幀畫(huà)面結(jié)構(gòu)指針。輸出參數(shù)：類型：ARPixelFormat*，值：深度圖像格式，參考ARPixelFormat定義。7.7.20獲取當(dāng)前幀圖像分辨率接口定義：ARResultarFrameGetDepthImageResolution(constARSession*session,constARFrame*frame,int*out_width,int*out_hei