2024增強(qiáng)現(xiàn)實(shí)軟件構(gòu)件規(guī)范

信息技術(shù)增強(qiáng)現(xiàn)實(shí)軟件構(gòu)件規(guī)范II目?次范圍 1規(guī)范性引用文件 1術(shù)語(yǔ)和定義 1縮略語(yǔ) 2構(gòu)件模型 2構(gòu)件制作 334構(gòu)件接口定義 4449附錄A（規(guī)范性）特殊數(shù)據(jù)類(lèi)型定義 77附錄B（規(guī)范性）枚舉類(lèi)型描述 78附錄C（資料性）原子構(gòu)件的C++制作過(guò)程 82PAGEPAGE10信息技術(shù)增強(qiáng)現(xiàn)實(shí)軟件構(gòu)件規(guī)范范圍本文件適用于虛擬現(xiàn)實(shí)、增強(qiáng)現(xiàn)實(shí)、混合現(xiàn)實(shí)的軟件構(gòu)件的表示與應(yīng)用。規(guī)范性引用文件（不包括勘誤的內(nèi)容GB/T5271.1-2000信息技術(shù)詞匯第1部分：基本術(shù)語(yǔ)。GB/T36455-2018 軟件構(gòu)件模型GB/T38247-2019 術(shù)語(yǔ)和定義下列術(shù)語(yǔ)和定義適用于本文件。3.1構(gòu)件component注：軟件構(gòu)件指獨(dú)立完成一定功能的軟件構(gòu)成成分。注：構(gòu)件由構(gòu)件模型來(lái)定義，并通過(guò)構(gòu)件的接口對(duì)外提供增強(qiáng)現(xiàn)實(shí)與應(yīng)用支撐服務(wù)、或者獲得外部相應(yīng)的請(qǐng)求信息等，且構(gòu)件接口是構(gòu)件與外界通訊的唯一通道。增強(qiáng)現(xiàn)實(shí)構(gòu)件也是為增強(qiáng)現(xiàn)實(shí)應(yīng)用和開(kāi)發(fā)提供軟件服務(wù)調(diào)用和請(qǐng)求的。[來(lái)源：GB/T36455-2018，3.1]3.2構(gòu)件規(guī)約Componentspecification注：“規(guī)約specification”釋義見(jiàn)GB/T11457-2006信息技術(shù)軟件工程術(shù)語(yǔ)，2.1548。3.3構(gòu)件模型Componentmodel對(duì)軟件構(gòu)件本質(zhì)特性的抽象和描述。3.4構(gòu)件接口Componentinterface軟件構(gòu)件對(duì)外交流和交互的通道。注：包括對(duì)外請(qǐng)求服務(wù)接口和外部請(qǐng)求服務(wù)接口。3.5原子構(gòu)件Atomiccomponent不能再被分解為子構(gòu)件的構(gòu)件。3.6復(fù)合構(gòu)件compositecomponent由多個(gè)子構(gòu)件構(gòu)成的構(gòu)件。3.7增強(qiáng)現(xiàn)實(shí)Augmentedreality采用以計(jì)算機(jī)為核心的現(xiàn)代高科技手段生成的附加信息對(duì)使用者感知到的真實(shí)世界進(jìn)行增強(qiáng)的環(huán)境,生成的信息以視覺(jué)、聽(tīng)覺(jué)、味覺(jué)、嗅覺(jué)、觸覺(jué)等生理感覺(jué)融合的方式疊加至真實(shí)場(chǎng)景中。[來(lái)源：GB/T38247-2019，2.1.2]3.8增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)Augmentedrealitysession增強(qiáng)現(xiàn)實(shí)中管理各部分運(yùn)行的消息機(jī)制。3.9面部增強(qiáng)AugmentedFace獲取面部網(wǎng)格信息，做圖像特效處理?？s略語(yǔ)下列縮略語(yǔ)適用于本文件。AR：增強(qiáng)現(xiàn)實(shí)（AugmentedReality）RGB：紅、綠、藍(lán)三個(gè)通道的顏色（Red,Green,Blue）構(gòu)件模型構(gòu)件模型是對(duì)軟件構(gòu)件本質(zhì)特性的描述，具體定義如圖1所示。圖1構(gòu)件模型構(gòu)件由構(gòu)件規(guī)約和構(gòu)件實(shí)現(xiàn)構(gòu)成。構(gòu)件規(guī)約由構(gòu)件的接口部分和結(jié)構(gòu)部分構(gòu)成。構(gòu)件由原子構(gòu)件結(jié)構(gòu)和符合構(gòu)件結(jié)構(gòu)組成。構(gòu)件實(shí)現(xiàn)是利用計(jì)算機(jī)語(yǔ)言代碼定義的構(gòu)件的實(shí)現(xiàn)體。構(gòu)件制作原子構(gòu)件制作原子構(gòu)件是最小粒度的構(gòu)件，在功能等方面具有不可再拆分的性質(zhì)。基于面向?qū)ο?，原子?gòu)件可由單個(gè)對(duì)象封裝而成，也可由多個(gè)協(xié)作的對(duì)象封裝而成。當(dāng)一個(gè)原子構(gòu)件的實(shí)體對(duì)應(yīng)單個(gè)對(duì)象時(shí)，這個(gè)構(gòu)件是單對(duì)象構(gòu)件，其制作流程如下：①定義接口規(guī)約。在構(gòu)件接口規(guī)約中定義其對(duì)外提供的功能和要求的外部功能。②制作構(gòu)件實(shí)體當(dāng)一個(gè)原子構(gòu)件對(duì)應(yīng)多個(gè)協(xié)作對(duì)象時(shí)，其制作流程如下：①需要引入一個(gè)控制對(duì)象。負(fù)責(zé)對(duì)外的交互，并負(fù)責(zé)其它協(xié)作對(duì)象的實(shí)例化和建立它們之間的關(guān)系。②定義構(gòu)件接口的規(guī)約部分。在構(gòu)件接口規(guī)約中定義其對(duì)外提供的功能和要求的外部功能。③制作構(gòu)件實(shí)體。復(fù)合構(gòu)件制作復(fù)合構(gòu)件的制作流程如下：①定義構(gòu)件的接口規(guī)約部分：在構(gòu)件接口規(guī)約中定義其對(duì)外提供的功能和要求的外部功能；②確定所包含的成員構(gòu)件；③建立內(nèi)部的成員構(gòu)件之間的接口連接關(guān)系；④將復(fù)合構(gòu)件對(duì)外提供和要求的功能映射到內(nèi)部成員構(gòu)件相應(yīng)的功能上。在建立內(nèi)部成員之間的連接關(guān)系以及復(fù)合構(gòu)件和成員構(gòu)件的功能映射時(shí)，遵循規(guī)則：①成員構(gòu)件對(duì)外要求的功能只能由一個(gè)提供者提供；②成員構(gòu)件對(duì)外提供的功能可以有多個(gè)使用者；構(gòu)件接口定義概述本章所列數(shù)據(jù)類(lèi)型見(jiàn)附錄A和附錄B。會(huì)話(huà)接口創(chuàng)建增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)參考接口定義：ArStatusArSession_createvoidvoid*contextArSession**out_session_pointer)功能描述：創(chuàng)建一個(gè)新的增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明envvoid是表示運(yùn)行環(huán)境的指針contextvoid是表示運(yùn)行上下文的指針out_session_pointerArSession*是指向ArSession*的指針，以接收新分配的會(huì)話(huà)的地址返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼創(chuàng)建特定功能的增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)參考接口定義：ArStatusArSession_createWithFeaturesvoid*envvoid*contextconstArSessionFeature*features,ArSession**out_session_pointer功能描述：創(chuàng)建一個(gè)新的增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)，請(qǐng)求其他功能。參數(shù)說(shuō)明：類(lèi)型：void，值：運(yùn)行環(huán)境；類(lèi)型：void，值：運(yùn)行上下文；類(lèi)型：constArSessionFeature，值：指向請(qǐng)求的功能列表的指針，值參考表2有關(guān)ArSessionFeature的定義。參數(shù)名類(lèi)型是否必須說(shuō)明envvoid是表示運(yùn)行環(huán)境的指針contextvoid是表示運(yùn)行上下文的指針out_session_pointerArSession*是指向ArSession*的指針，以接收新分配的會(huì)話(huà)的地址返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼釋放增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)參考接口定義：voidArSession_destroy(ArSession*session)功能描述：釋放增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)所占用的資源。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針?lè)祷刂担悍祷刂殿?lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼設(shè)置增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)配置參考接口定義：ArStatusArSession_configure(ArSession*sessionconstArConfig*config)功能描述：增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)具有默認(rèn)配置，如需修改，則調(diào)用此方法。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針configArConfig否增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)的新配置設(shè)置指針?lè)祷刂担悍祷刂殿?lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)配置參考接口定義：voidArSession_getConfig(ArSession*sessionArConfig*out_config功能描述：獲取當(dāng)前增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)的配置。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針out_configArConfig否增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)的新配置設(shè)置指針?lè)祷刂担悍祷刂殿?lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼暫停增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)參考接口定義：ArStatusArSession_pause(ArSession*session)功能描述：暫停當(dāng)前增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針?lè)祷刂担悍祷刂殿?lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼啟動(dòng)增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)參考接口定義：ArStatusArSession_resume(ArSession*session)功能描述：?jiǎn)?dòng)或恢復(fù)增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針?lè)祷刂担悍祷刂殿?lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼創(chuàng)建云錨點(diǎn)ArtausAression_hsAndAcqureNewoudAnchorAressonsession,constArAnchor*anchor,ArAnchor**out_cloud_anchor功能描述：根據(jù)當(dāng)前錨點(diǎn)的位姿和其他的元數(shù)據(jù)創(chuàng)建一個(gè)新的云錨點(diǎn)。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針anchorArAnchor否錨點(diǎn)指針out_cloud_anchorArAnchor否指向ArAnchor*的指針，以接收新分配的云錨點(diǎn)地址返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取所有錨點(diǎn)voidArSession_getAllAnchors(constArSession*session,ArAnchorList*out_anchor_list)功能描述：返回所有已知的錨點(diǎn)，包括當(dāng)前尚未跟蹤的錨點(diǎn)。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針out_anchor_listArAnchorList否所有的錨點(diǎn)列表返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼解決錨的位姿參考接口定義：ArStatusArSession_resolveAndAcquireNewCloudAnchor(ArSession*session,constchar*cloud_anchor_id,ArAnchor**out_cloud_anchor)功能描述：創(chuàng)建一個(gè)新的云ID安排任務(wù)，來(lái)解決錨點(diǎn)的位姿。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針cloud_anchor_idchar否云錨點(diǎn)的IDout_cloud_anchorArAnchor否指向ArAnchor*的指針，以接收新分配的云錨點(diǎn)的地址返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取所有可跟蹤的對(duì)象參考接口定義：voidArSession_getAllTrackables（constArSession*sessionArTrackableTypefilter_type,ArTrackableList*out_trackable_list)功能描述：獲取所有能夠被跟蹤到的對(duì)象。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針filter_typeArTrackableType否可跟蹤對(duì)象類(lèi)型out_trackable_listArTrackableList否指向符合返回類(lèi)型的可跟蹤對(duì)象列表的指針?lè)祷刂担悍祷刂殿?lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼定義跟蹤位置ArSession_acquireNewAnchorArSession*sessionconstArPose*pose**out_anchor)功能描述：定義物理世界中的跟蹤位置錨點(diǎn)。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針poseArPose否位姿指針out_anchorArAnchor否指向ArAnchor*的指針，以接收新分配錨點(diǎn)地址返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼配置接口功能定義創(chuàng)建配置參考接口定義：voidArConfig_create(constArSession*sessionArConfig**out_config)功能描述：創(chuàng)建一個(gè)新的配置對(duì)象，并將其初始化為合理的默認(rèn)配置。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針out_configArConfig否指向ArConfig的指針，以接收新分配的配置指針?lè)祷刂担悍祷刂殿?lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼釋放配置參考接口定義：voidArConfig_destroy(ArConfig*config)功能描述：釋放提供給當(dāng)前配置對(duì)象所使用的內(nèi)存。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明configArConfig否配置指針?lè)祷刂担悍祷刂殿?lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取面部增強(qiáng)模式參考接口定義：voidArConfig_getFocusMode(constArSession*session,ArConfig*config,ArFocusMode*focus_mode)功能描述：參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針configArConfig否配置指針focus_modeArFocusMode否面部增強(qiáng)模式，并將值存入*focus_mode返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼設(shè)置面部增強(qiáng)模式參考接口定義：voidArConfig_setAugmentedFaceMode(constArSession*session,ArConfig*config,ArAugmentedFaceModeaugmented_face_mode)功能描述：給當(dāng)前配置設(shè)置所需要的面部增強(qiáng)模式。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針configArConfig否配置指針augmented_face_modeArAugmentedFaceMode否面部增強(qiáng)模式返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取圖像數(shù)據(jù)庫(kù)ArConfig_getAugmentedFaceMode(constArSession*sessionconstArConfig*config, ArAugmentedFaceMode*augmented_face_mode)功能描述：獲取當(dāng)前配置中所設(shè)定的圖像數(shù)據(jù)庫(kù)。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針configArConfig否配置指針augmented_face_modeArAugmentedFaceMode否面部增強(qiáng)模式返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼設(shè)置圖像數(shù)據(jù)庫(kù)參考接口定義：voidArConfig_setAugmentedImageDatabase(constArSession*sessionArConfig*config,constArAugmentedImageDatabase*augmented_image_database)功能描述：給當(dāng)前配置設(shè)置所需要的圖像數(shù)據(jù)庫(kù)。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針configArConfig否配置指針augmented_image_databaseArAugmentedImageDatabase否圖像數(shù)據(jù)庫(kù)指針?lè)祷刂担悍祷刂殿?lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取云錨點(diǎn)模式參考接口定義：voidStruct_getCloudAnchorMode(constArSession*session,constArConfig*config,ArCloudAnchorMode*out_cloud_anchor_mode)功能描述：獲取當(dāng)前配置中所設(shè)定的云錨點(diǎn)模式。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針configArConfig否配置指針out_cloud_anchor_modeArCloudAnchorMode否云錨點(diǎn)模式，并將存 out_cloud_anchor_mode返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼設(shè)置云錨點(diǎn)模式ArConfig_setCloudAnchorMode(constArSession*sessionArConfig*config,ArCloudAnchorModecloud_anchor_mode)功能描述：給當(dāng)前配置設(shè)置所需要的云錨點(diǎn)模式。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針configArConfig否配置指針cloud_anchor_modeArCloudAnchorMode否云錨點(diǎn)模式返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取深度模式參考接口定義：voidArConfig_getDepthMode(constArSession*sessionconstArConfig*config,ArDepthMode*out_depth_mode)功能描述：獲取當(dāng)前配置中所設(shè)定的深度模式。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針configArConfig否配置指針out_depth_modeArDepthMode否*out_depth_mode返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼設(shè)置深度模式參考接口定義：voidArConfig_setDepthMode(constArSession*session,ArConfig*config,ArDepthModemode)功能描述：給當(dāng)前配置設(shè)置所需要的深度模式。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針configArConfig否配置指針modeArDepthMode否深度模式返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取相機(jī)對(duì)焦模式參考接口定義：voidArConfig_getFocusMode(constArSession*session,ArConfig*config,ArFocusMode*focus_mode)功能描述：獲取當(dāng)前配置中所設(shè)定的相機(jī)對(duì)焦模式。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針configArConfig否配置指針focus_modeArFocusMode否相機(jī)對(duì)焦模式，并將值存儲(chǔ)進(jìn)*focus_mode返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼設(shè)置相機(jī)對(duì)焦模式參考接口定義：voidArConfig_setFocusMode(constArSession*session,ArConfig*config,ArFocusModefocus_mode)功能描述：給當(dāng)前配置設(shè)置所需要的相機(jī)對(duì)焦模式。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針configArConfig否配置指針focus_modeArFocusMode否相機(jī)對(duì)焦模式返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取光照模式ArConfig_getLightEstimationMode(constArSession*sessionconstArConfig*config,ArLightEstimationMode*light_estimation_mode)功能描述：獲取當(dāng)前配置中所設(shè)定的光照模式。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針configArConfig否配置指針light_estimation_modeArLightEstimationMode否光照模式，并將值存入*light_estimation_mode返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼設(shè)置光照模式參考接口定義：voidArConfig_setLightEstimationMode(constArSession*session,ArConfig*config,ArLightEstimationModelight_estimation_mode)功能描述：給當(dāng)前配置設(shè)置所需要的光照模式。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針configArConfig否配置指針light_estimation_modeArLightEstimationMode否光照模式返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取平面模式參考接口定義：voidArConfig_getPlaneFindingMode(constArSession*session,constArConfig*config,ArPlaneFindingMode*plane_finding_mode)功能描述：獲取當(dāng)前配置中所設(shè)定的平面模式。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針configArConfig否配置指針plane_finding_modeArPlaneFindingMode否平面模式類(lèi)型，并將值存入*plane_finding_mode返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼設(shè)置平面模式ArConfig_setPlaneFindingMode(constArSession*sessionArConfig*config,ArPlaneFindingModeplane_finding_mode)功能描述：給當(dāng)前配置設(shè)置所需要的平面模式。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針configArConfig否配置指針plane_finding_modeArPlaneFindingMode否平面模式類(lèi)型返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼相機(jī)接口功能定義相機(jī)內(nèi)參功能定義創(chuàng)建相機(jī)內(nèi)參參考接口定義：voidArCameraIntrinsics_create(constArSession*session,ArCameraIntrinsics**out_camera_intrinsics)功能描述：創(chuàng)建一個(gè)相機(jī)內(nèi)參對(duì)象。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針out_camera_intrinsicsArCameraIntrinsics否指 向ArCameraIntrinsics*的指針，以接收新創(chuàng)建的相機(jī)內(nèi)參對(duì)象的地址返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼釋放相機(jī)內(nèi)參參考接口定義：voidArCameraIntrinsics_destroy(ArCameraIntrinsics*camera_intrinsics)功能描述：釋放提供給相機(jī)內(nèi)參對(duì)象使用的內(nèi)參。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明camera_intrinsicsArCameraIntrinsics是相機(jī)內(nèi)參指針?lè)祷刂担悍祷刂殿?lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取相機(jī)焦距voidArCameraIntrinsics_getFocalLength(constArSession*session,constArCameraIntrinsics*intrinsics,float*out_fx,float*out_fy)功能描述：返回以像素為單位的相機(jī)焦距。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針intrinsicsArCameraIntrinsics否相機(jī)內(nèi)參指針out_fxfloat否返回相機(jī)的X并將其值存儲(chǔ)在*out_fxout_fyfloat否返回相機(jī)的Y并將其值存儲(chǔ)在*out_fy返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取圖像尺寸參考接口定義：voidArCameraIntrinsics_getImageDimensions(constArSession*session,constArCameraIntrinsics*intrinsics,int32_t*out_width,int32_t*out_height)功能描述：返回以像素為單位的圖像的寬度和高度。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針intrinsicsArCameraIntrinsics否相機(jī)內(nèi)參指針out_widthint32_t否返回圖形的寬度，并將其值存儲(chǔ)在*out_widthout_hightint32_t否返回圖形的高度，并將其值存儲(chǔ)在*out_hight返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取相機(jī)位置參考接口定義：voidArCameraIntrinsics_getPrincipalPoint(constArSession*session,constArCameraIntrinsics*intrinsics, float*out_cx,float*out_cy)功能描述：返回以像素為單位的相機(jī)的二維坐標(biāo)。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針intrinsicsArCameraIntrinsics否相機(jī)內(nèi)參指針out_cxfloat否float，值：返回相機(jī)的X軸坐標(biāo)，并將其值存儲(chǔ)在*out_cxout_cyfloat否返回相機(jī)的Y軸坐標(biāo)，并將其值存儲(chǔ)在*out_cy返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼相機(jī)通用功能定義獲取虛擬空間位姿voidArCamera_getDisplayOrientedPose(constArSession*session,constArCamera*camera,ArPose*out_pose)功能描述：AR內(nèi)容渲染到最新的的幀畫(huà)面上。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針cameraArCamera否相機(jī)指針out_poseArPose否返回一個(gè)已經(jīng)定義了的位姿對(duì)象，并將返回值存儲(chǔ)在*out_pose返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取相機(jī)圖像流內(nèi)部函數(shù)參考接口定義：voidArCamera_getImageIntrinsics(constArSession*session,constArCamera*camera,ArCameraIntrinsics*out_camera_intrinsics)功能描述：獲取未旋轉(zhuǎn)和裁剪的相機(jī)圖像的內(nèi)部參數(shù)，由于內(nèi)參可能在每一幀中更改，因此應(yīng)該再每幀上調(diào)用此函數(shù)以獲取當(dāng)前幀的內(nèi)參。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針cameraArCamera否相機(jī)指針out_camera_intrinsicsArCameraIntrinsics否并將其存儲(chǔ)在*out_camera_intrinsics返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取相機(jī)位姿參考接口定義：voidArCamera_getPose(constArSession*session,constArCamera*camera,ArPose*out_pose)功能描述：獲取物理相機(jī)在世界空間中最新幀畫(huà)面的位姿。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針cameraArCamera否相機(jī)指針out_poseArPose否返回一個(gè)已經(jīng)定義了的位姿對(duì)象，并將返回值存儲(chǔ)在*out_pose返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取相機(jī)投影矩陣參考接口定義：voidArCamera_getProjectionMatrix(constArSession*session,constArCamera*camera,floatnear,floatfar, float*dest_col_major_4x4)功能描述：計(jì)算用于在相機(jī)圖像頂部渲染虛擬內(nèi)容的投影矩陣。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針cameraArCamera否相機(jī)指針nearfloat否指定近相機(jī)平面farfloat否指定遠(yuǎn)相機(jī)平面*dest_col_major_4x4float否返回一個(gè)4*4的投影矩陣將 值 存 儲(chǔ) *dest_col_major_4x4返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取紋理流內(nèi)部參數(shù)參考接口定義：voidArCamera_getTextureIntrinsics(constArSession*session,constArCamera*camera,ArCameraIntrinsics*out_camera_intrinsics)功能描述：獲取未GPU紋理流的內(nèi)部參數(shù)。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針cameraArCamera否相機(jī)指針*out_camera_intrinsicsArCameraIntrinsics否并將值存儲(chǔ)在*out_camera_intrinsics返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取相機(jī)跟蹤失敗的原因voidArCamera_getTrackingFailureReason(constArSession*session,constArCamera*camera,ArTrackingFailureReason*out_tracking_failure_reason)功能描述：獲取相機(jī)跟蹤失敗的原因。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針cameraArCamera否相機(jī)指針ArTrackingFailureReason否相機(jī)跟蹤失敗原因，并將值存儲(chǔ)在*out_tracking_failure_reason返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取相機(jī)跟蹤狀態(tài)參考接口定義：voidArCamera_getTrackingState(constArSession*session,constArCamera*camera,ArTrackingState*out_tracking_state)功能描述：獲取當(dāng)前使用的相機(jī)的當(dāng)前運(yùn)動(dòng)跟蹤狀態(tài)。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針cameraArCamera否相機(jī)指針out_tracking_stateArTrackingState否相機(jī)的跟蹤狀態(tài)，并將值存儲(chǔ)在*out_tracking_state返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取相機(jī)視圖矩陣odAramera_ewatrx(constAressionsession,constArameracamera,float*out_col_major_4x4)功能描述：獲取當(dāng)前幀畫(huà)面的視圖矩陣。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針cameraArCamera否相機(jī)指針out_col_major_4x4float否返回一個(gè)4*4的視圖矩陣將 值 存 儲(chǔ) *out_col_major_4x4返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼釋放相機(jī)參考接口定義：voidArCamera_release(ArCamera*camera)功能描述：釋放對(duì)相機(jī)的引用。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明cameraArCamera是相機(jī)指針?lè)祷刂担悍祷刂殿?lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼判斷是否支持深度模式參考接口定義：voidArSession_isDepthModeSupported(constArSession*sessionArDepthModedepth_mode,int32_t*out_is_supported)功能描述：使用當(dāng)前使用的相機(jī)的相關(guān)配置來(lái)檢查當(dāng)前設(shè)備是否支持深度模式。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針depth_modeArDepthMode否需要檢查的深度模式out_is_supportedint32_t否如果當(dāng)前設(shè)備支持深度模式，則返回非零值返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼相機(jī)配置功能定義創(chuàng)建相機(jī)配置voidArCameraConfig_create(constArSession*session,ArCameraConfig**out_camera_config)功能描述：創(chuàng)建一個(gè)相機(jī)配置對(duì)象。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針out_camera_configArCameraConfig否指向ArCameraConfig*的指針，以接收新創(chuàng)建的相機(jī)配置對(duì)象的地址返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取相機(jī)配置參考接口定義：voidArSession_getCameraConfig(constArSession*session,ArCameraConfig*out_camera_config)功能描述：獲取當(dāng)前會(huì)話(huà)所使用的相機(jī)的相關(guān)配置。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針out_camera_configArCameraConfig否相機(jī)配置指針?lè)祷刂担悍祷刂殿?lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼釋放相機(jī)配置參考接口定義：voidArCameraConfig_destroy(ArCameraConfig*camera_config)功能描述：釋放相機(jī)配置對(duì)象所使用的的內(nèi)存，以及其保存的相機(jī)配置引用。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明camera_configArCameraConfig是相機(jī)配置指針?lè)祷刂担悍祷刂殿?lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼創(chuàng)建相機(jī)配置列表參考接口定義：voidArCameraConfigList_create(constArSession*sessionArCameraConfigList**out_list)功能描述：創(chuàng)建一個(gè)相機(jī)配置列表對(duì)象。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針out_listArCameraConfigList否指 向ArCameraConfigList*的指針，以接收新創(chuàng)建的相機(jī)創(chuàng)建列表對(duì)象的地址返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取相機(jī)配置列表參考接口定義：voidArSession_getSupportedCameraConfigsWithFilter(constArSession*session,constArCameraConfigFilter*filter,ArCameraConfigList*list功能描述：獲取滿(mǎn)足系統(tǒng)當(dāng)前相機(jī)配置過(guò)濾器支持的相機(jī)配置列表。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針filterArCameraConfigFilter否相機(jī)配置過(guò)濾器指針listArCameraConfigList否指向支持的相機(jī)配置列表的指針?lè)祷刂担悍祷刂殿?lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取特定位置的相機(jī)配置參考接口定義：voidArCameraConfigList_getItem(constArSession*session,constArCameraConfigList*list,int32_tindex,ArCameraConfig*out_camera_config)功能描述：獲取相機(jī)配置列表中特定位置上的相機(jī)配置。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針camera_configArCameraConfig否相機(jī)配置列表指針indexint32_t否索引值out_camera_configArCameraConfig否返回一個(gè)相機(jī)配置對(duì)象，并將 其 存 儲(chǔ) 在*out_camera_config返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取相機(jī)配置數(shù)量參考接口定義：voidArCameraConfigList_getSize(constArSession*session,constArCameraConfigList*list,int32_t*out_size)功能描述：獲取相機(jī)配置列表中的相機(jī)配置的數(shù)量。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針camera_configArCameraConfig否相機(jī)配置列表指針out_sizeint32_t否返回相機(jī)配置的數(shù)量，將其值存儲(chǔ)在*out_size返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼釋放相機(jī)配置列表參考接口定義：voidArCameraConfigList_destroy(ArCameraConfigList*list)功能描述：釋放相機(jī)配置列表對(duì)象所使用的內(nèi)存，以及其保存的所有的相機(jī)配置引用。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明listArCameraConfigList是相機(jī)配置列表指針?lè)祷刂担悍祷刂殿?lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取深度傳感器使用配置參考接口定義：voidArCameraConfig_getDepthSensorUsage(constArSession*session,constArCameraConfig*camera_config,uint32_t*out_depth_sensor_usage)功能描述：獲取深度傳感器所使用的配置。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針camera_configArCameraConfig否相機(jī)配置指針out_depth_sensor_usageuint32_t否返回深度傳感器的使用配*out_depth_sensor_usage返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取相機(jī)朝向voidArCameraConfig_getFacingDirection(constArSession*session,constArCameraConfig*camera_config,ArCameraConfigFacingDirection*out_facing)功能描述：獲取當(dāng)前相機(jī)配置所選擇的相機(jī)的朝向。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針camera_configArCameraConfig否相機(jī)配置指針out_facingArCameraConfigFacingDirection否值存儲(chǔ)在*out_facing返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取最大最小捕獲速率參考接口定義：voidArCameraConfig_getFpsRange(constArSession*session,constArCameraConfig*camera_config,int32_t*out_min_fps,int32_t*out_max_fps)功能描述：獲取當(dāng)前相機(jī)配置的最大和最小相機(jī)捕獲率，以每秒幀數(shù)為單位。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針camera_configArCameraConfig否相機(jī)配置指針out_min_fpsint32_t否返回值為最小捕獲率，將其值存儲(chǔ)在*out_min_fpsout_max_fpsint32_t否返回值為最大捕獲率，將其值存儲(chǔ)在*out_max_fps返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取圖像尺寸參考接口定義：voidArCameraConfig_getImageDimensions(constArSession*session,constArCameraConfig*camera_config,int32_t*out_width,int32_t*out_height)功能描述：CPU圖像尺寸。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針camera_configArCameraConfig否相機(jī)配置指針out_widthint32_t否返回值為CPU圖像的寬度，將其值存儲(chǔ)在*out_widthout_heightint32_t否返回值為CPU圖像的高度，將其值存儲(chǔ)在*out_height返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取紋理尺寸參考接口定義：voidArCameraConfig_getTextureDimensions(constArSession*session,constArCameraConfig*camera_config,int32_t*out_width,int32_t*out_height)功能描述：GPU紋理尺寸。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針camera_configArCameraConfig否相機(jī)配置指針out_widthint32_t否返回值為GPU紋理的寬度，將其值存儲(chǔ)在*out_widthout_heightint32_t否返回值為GPU紋理的高度，將其值存儲(chǔ)在*out_height返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼相機(jī)過(guò)濾器功能定義創(chuàng)建機(jī)相機(jī)配置過(guò)濾器參考接口定義：void ArCameraConfigFilter_create(const ArSession ArCameraConfigFilter**out_filter)功能描述：創(chuàng)建一個(gè)相機(jī)配置過(guò)濾器對(duì)象。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針out_filterArCameraConfigFilter否指 向ArCameraConfigFilter*的指針，以接收新創(chuàng)建的相機(jī)配置過(guò)濾器對(duì)象的地址返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼釋放相機(jī)配置過(guò)濾器參考接口定義：voidArCameraConfigFilter_destroy(ArCameraConfigFilter*filter)功能描述：釋放提供給相機(jī)配置過(guò)濾器所用的內(nèi)存。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明filterArCameraConfigFilter是相機(jī)配置過(guò)濾器指針?lè)祷刂担悍祷刂殿?lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取所需的深度傳感器使用參考接口定義：voidArCameraConfigFilter_getDepthSensorUsage(constArSession*session,ArCameraConfigFilter*filter,uint32_t*out_depth_sensor_usage)功能描述：獲取所需的深度傳感器的使用。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針filterArCameraConfigFilter否相機(jī)配置過(guò)濾器指針out_depth_sensor_usageuint32_t否深度傳感器使用狀態(tài)，并將其值存儲(chǔ)在*out_depth_sensor_usage返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼設(shè)置所需的深度傳感器使用參考接口定義：voidArCameraConfigFilter_setDepthSensorUsage(constArSession*session,ArCameraConfigFilter*filter, uint32_tdepth_sensor_usage_filters)功能描述：設(shè)置所需的深度傳感器的使用。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針filterArCameraConfigFilter否相機(jī)配置過(guò)濾器指針depth_sensor_usage_filtersuint32_t否深度傳感器使用狀態(tài)返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取所需的捕獲幀率參考接口定義：voidArCameraConfigFilter_getTargetFps(constArSession*session,ArCameraConfigFilter*filter,uint32_t*out_fps_filters)功能描述：獲取允許的所需捕獲幀率。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針filterArCameraConfigFilter否相機(jī)配置過(guò)濾器指針out_fps_filtersuint32_t否目標(biāo)相機(jī)捕獲幀率狀態(tài)，并將其值存儲(chǔ)在*out_fps_filters返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼設(shè)置所需的捕獲幀率參考接口定義：voidArCameraConfigFilter_setTargetFps(constArSession*session,ArCameraConfigFilter*filter,constuint32_tfps_filters)功能描述：設(shè)置允許的所需捕獲幀率。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針filterArCameraConfigFilter否相機(jī)配置過(guò)濾器指針fps_filtersuint32_t否目標(biāo)相機(jī)捕獲幀率狀態(tài)返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼光照估計(jì)接口功能定義創(chuàng)建光照估計(jì)voidArLightEstimate_create(constArSession*session,ArLightEstimate**out_light_estimate)功能描述：創(chuàng)建一個(gè)新的光照估計(jì)對(duì)象。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針out_light_estimateArLightEstimate否指向ArLightEstimate*的指針，以接收新創(chuàng)建的光照估計(jì)對(duì)象的地址返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼釋放光照估計(jì)參考接口定義：voidArLightEstimate_destroy(ArLightEstimate*light_estimate)功能描述：釋放提供給光照估計(jì)對(duì)象使用的內(nèi)存。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明light_estimateArLightEstimate是光照估計(jì)指針?lè)祷刂担悍祷刂殿?lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取顏色校正值voidArLightEstimate_getColorCorrection(constArSession*session,constArLightEstimate*light_estimate,float*out_color_correction_4)功能描述：獲取著色器的顏色校正值。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針light_estimateArLightEstimate否光照估計(jì)對(duì)象指針out_color_correction_4float否返回的校正值返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取環(huán)境照明的球諧系數(shù)參考接口定義：voidArLightEstimate_getEnvironmentalHdrAmbientSphericalHarmonics(constArSession*session,constArLightEstimate*light_estimate,float*out_coefficients_27)功能描述：HDR照明估計(jì)，獲取環(huán)境照明的球諧系數(shù)。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針light_estimateArLightEstimate否光照估計(jì)對(duì)象指針out_coefficients_27float否返回的球諧系數(shù)值返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取主定向光方向參考接口定義：voidArLightEstimate_getEnvironmentalHdrMainLightDirection(constArSession*session,constArLightEstimate*light_estimate,float*out_direction_3)功能描述：HDR照明估計(jì)值返回主定向光的方向。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針light_estimateArLightEstimate否光照估計(jì)對(duì)象指針out_direction_3float否返回的主定向光方向返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取主定向光強(qiáng)度參考接口定義：voidArLightEstimate_getEnvironmentalHdrMainLightIntensity(constArSession*session,constArLightEstimate*light_estimate,float*out_intensity_3)功能描述：HDR照明估計(jì)值返回主定向光的強(qiáng)度。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針light_estimateArLightEstimate否光照估計(jì)對(duì)象指針out_intensity_3float否返回的主定向光強(qiáng)度返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取光照估計(jì)狀態(tài)參考接口定義：voidArLightEstimate_getState(constArSession*session,constArLightEstimate*light_estimate,ArLightEstimateState*out_light_estimate_state)功能描述：獲取當(dāng)前的光照估計(jì)狀態(tài)。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針light_estimateArLightEstimate否光照估計(jì)指針out_light_estimate_stateArLightEstimateState否光照估計(jì)狀態(tài)分類(lèi)返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取時(shí)間戳參考接口定義：voidArLightEstimate_getTimestamp(constArSession*session,constArLightEstimate*light_estimate,int64_t*out_timestamp_ns)功能描述：獲取給定光照估計(jì)的時(shí)間戳（以納秒為單位）。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針light_estimateArLightEstimate否光照估計(jì)指針out_timestamp_nsint64_t否返回的時(shí)間戳返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼位姿接口功能定義創(chuàng)建位姿參考接口定義：voidArPose_create(constArSession*session,constfloat*pose_raw,ArPose**out_pose)功能描述：創(chuàng)建一個(gè)位姿對(duì)象。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針pose_rawfloat否指向float[7]的指針，其中存儲(chǔ)的是描述位姿的旋轉(zhuǎn)四元組和平移三元組out_poseArPose否指向ArPose*，以接收新創(chuàng)建的位姿的對(duì)象的地址返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼釋放位姿參考接口定義：voidArPose_destroy(ArPose*pose)功能描述：釋放提供給位姿使用的內(nèi)存空間，以及其所有的引用。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明poseArPose是位姿指針?lè)祷刂担悍祷刂殿?lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取位姿矩陣參考接口定義：voidArPose_getMatrix(constArSession*session,constArPose*pose,float*out_matrix_col_major_4x4)功能描述：4*4的矩陣，并輸出。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是類(lèi)型：Struct，值：poseArPose否位姿指針out_matrix_col_major_4x4float否輸出轉(zhuǎn)換了的4*4矩陣并其 值 存 儲(chǔ) *out_matrix_col_major_4x4所指向的內(nèi)存空間返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取位姿信息參考接口定義：voidArPose_getPoseRaw(constArSession*session,constArPose*pose,float*out_pose_raw_7)功能描述：獲取位姿的四元組數(shù)據(jù)以及旋轉(zhuǎn)和平移信息。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針poseArPose否位姿指針out_pose_raw_7float否返回值為旋轉(zhuǎn)四元組與平移三元組組成的float[7]數(shù)組，并將其值存儲(chǔ)在*out_pose_raw_7存空間返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼錨點(diǎn)接口功能定義創(chuàng)建錨點(diǎn)列表參考接口定義：voidArAnchorList_create(constArSession*session,ArAnchorList**out_anchor_list)功能描述：創(chuàng)建一個(gè)錨點(diǎn)列表對(duì)象。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針out_anchor_listArAnchorList否ArAnchorList以接收新創(chuàng)建的錨點(diǎn)列表的地址返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼釋放錨點(diǎn)列表參考接口定義：voidArAnchorList_destroy(ArAnchorList*anchor_list)功能描述：釋放提供給錨點(diǎn)列表對(duì)象使用的內(nèi)存，以及其持有的所有錨點(diǎn)的引用。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明anchor_listArAnchorList是錨點(diǎn)列表指針?lè)祷刂担悍祷刂殿?lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取錨點(diǎn)引用參考接口定義：voidArAnchorList_acquireItem(constArSession*session,constArAnchorList*anchor_list,int32_tindex,ArAnchor**out_anchor)功能描述：獲取對(duì)錨點(diǎn)列表中指定索引處的錨點(diǎn)的引用。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針anchor_listArAnchorList否錨點(diǎn)列表指針indexint32_t否指定的索引值out_anchorArAnchor否指向指定索引值的錨點(diǎn)，以接收錨點(diǎn)的存儲(chǔ)地址返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取錨點(diǎn)列表元素個(gè)數(shù)voidArAnchorList_getSize(constArSession*session,constArAnchorList*anchor_list,int32_t*out_size)功能描述：獲取當(dāng)前錨點(diǎn)列表中所包含的錨點(diǎn)個(gè)數(shù)。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針anchor_listArAnchorList否錨點(diǎn)列表指針out_sizeint32_t否返回錨點(diǎn)總個(gè)數(shù)，并將其值存儲(chǔ)在*out_size所指向的內(nèi)存空間返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼ID參考接口定義：voidArAnchor_acquireCloudAnchorId(ArSession*session,ArAnchor*anchor,char**out_cloud_anchor_id)功能描述：ID。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針anchorArAnchor否錨點(diǎn)指針out_cloud_anchor_idchar否指向錨點(diǎn)的云錨點(diǎn)ID的指針，以接收云錨點(diǎn)ID的存儲(chǔ)地址返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼停止跟蹤錨點(diǎn)參考接口定義：voidArAnchor_detach(ArSession*session,ArAnchor*anchor)功能描述：停止對(duì)當(dāng)前錨點(diǎn)的跟蹤。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針anchorArAnchor否錨點(diǎn)指針?lè)祷刂担悍祷刂殿?lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取云錨點(diǎn)狀態(tài)參考接口定義：voidArAnchor_getCloudAnchorState(constArSession*session,constArAnchor*anchor,ArCloudAnchorState*out_state)功能描述：獲取當(dāng)前錨點(diǎn)的云錨點(diǎn)狀態(tài)。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針anchorArAnchor否錨點(diǎn)指針out_stateArCloudAnchorState否云錨點(diǎn)的狀態(tài)分類(lèi)返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取錨點(diǎn)位姿參考接口定義：voidArAnchor_getPose(constArSession*session,constArAnchor*anchor,ArPose*out_pose)功能描述：獲取當(dāng)前錨點(diǎn)的位姿信息。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針anchorArAnchor否錨點(diǎn)指針out_poseArPose否返回位姿，并將其值存儲(chǔ)在*out_pose返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼獲取錨點(diǎn)跟蹤狀態(tài)參考接口定義：voidArAnchor_getTrackingState(constArSession*session,constArAnchor*anchor,ArTrackingState*out_tracking_state)功能描述：獲取當(dāng)前錨點(diǎn)的跟蹤狀態(tài)參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話(huà)指針anchorArAnchor否錨點(diǎn)指針out_tracking_stateArTrackingState否錨點(diǎn)的跟蹤狀態(tài)返回值：返回值類(lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼釋放錨點(diǎn)引用參考接口定義：ArAnchor_release(ArAnchor*anchor)功能描述：釋放對(duì)當(dāng)前錨點(diǎn)的所有引用。參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明anchorArAnchor是錨點(diǎn)指針?lè)祷刂担悍祷刂殿?lèi)型說(shuō)明returnstatusArStatus返回指示功能成功或失敗的代碼點(diǎn)接口功能定義獲取點(diǎn)方向參考接口定義：voidArPoint_getOrientationMode(constArSession*sessionconstArPoint*point,ArPointOrientationMode*out_orientation_mode)功能描述：獲取當(dāng)前正在跟蹤的空間點(diǎn)方向模式參數(shù)說(shuō)明：參數(shù)名類(lèi)型是否必須說(shuō)明sessionArSession是