1GB/TXXXXX.1—XXXX信息技術(shù)增強(qiáng)現(xiàn)實(shí)軟件構(gòu)件規(guī)范本文件規(guī)定了用于增強(qiáng)現(xiàn)實(shí)的軟件構(gòu)件規(guī)范，包括構(gòu)件模型定義、構(gòu)件制作過(guò)程定義、構(gòu)件接口定本文件適用于虛擬現(xiàn)實(shí)、增強(qiáng)現(xiàn)實(shí)、混合現(xiàn)實(shí)的軟件構(gòu)件的表示與應(yīng)用。2規(guī)范性引用文件下列文件中的條款通過(guò)本規(guī)范的引用而成為本規(guī)范的條款。凡是注日期的引用文件，其隨后所有的修改單（不包括勘誤的內(nèi)容）或修訂版均不適用于本規(guī)范，然而，鼓勵(lì)根據(jù)本規(guī)范達(dá)成協(xié)議的各方研究是否可使用這些文件的最新版本。凡是不注日期的引用文件，其最新版本適用于本規(guī)范。GB/T5271.1-2000信息技術(shù)詞匯第1部分：基本術(shù)語(yǔ)。GB/T36455-2018軟件構(gòu)件模型GB/T38247-2019信息技術(shù)增強(qiáng)現(xiàn)實(shí)術(shù)語(yǔ)3術(shù)語(yǔ)和定義下列術(shù)語(yǔ)和定義適用于本文件。3.1構(gòu)件component軟件系統(tǒng)中具有相對(duì)獨(dú)立功能、可以明確辨識(shí)、接口由契約指定、和語(yǔ)境有明顯依賴關(guān)系、可獨(dú)立部署的可組裝軟件實(shí)體。注：構(gòu)件由構(gòu)件模型來(lái)定義，并通過(guò)構(gòu)件的接口對(duì)外提供增強(qiáng)現(xiàn)實(shí)與應(yīng)用支撐等，且構(gòu)件接口是構(gòu)件與外界通訊的唯一通道。增強(qiáng)現(xiàn)實(shí)構(gòu)件也是為增強(qiáng)現(xiàn)實(shí)應(yīng)用和開發(fā)提供軟[來(lái)源：GB/T36455-2018，3.1]3.2構(gòu)件規(guī)約Componentspecification對(duì)軟件構(gòu)件的定義，也是對(duì)軟件構(gòu)件模型的定義。使用某種構(gòu)件描述語(yǔ)言對(duì)構(gòu)件復(fù)用信息的形式化描述。3.3構(gòu)件模型ComponentmodelGB/TXXXXX.1—XXXX對(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é)、聽覺(jué)、味覺(jué)、嗅覺(jué)、觸覺(jué)等生理感覺(jué)融合的方式疊加至真實(shí)場(chǎng)景中。[來(lái)源：GB/T38247-2019，2.1.2]3.8增強(qiáng)現(xiàn)實(shí)會(huì)話Augmentedrealitysession增強(qiáng)現(xiàn)實(shí)中管理各部分運(yùn)行的消息機(jī)制。3.9面部增強(qiáng)AugmentedFace獲取面部網(wǎng)格信息，做圖像特效處理。4縮略語(yǔ)下列縮略語(yǔ)適用于本文件。AR：增強(qiáng)現(xiàn)實(shí)（AugmentedReality）RGB：紅、綠、藍(lán)三個(gè)通道的顏色（Red,Green,Blue）5構(gòu)件模型構(gòu)件模型是對(duì)軟件構(gòu)件本質(zhì)特性的描述，具體定義如圖1所示。3GB/TXXXXX.1—XXXX圖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)件與外界交流的唯一途徑和通道，包含了對(duì)外請(qǐng)求的功能和對(duì)外提供的功能，以服務(wù)的形式體現(xiàn)。構(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)體。6構(gòu)件制作6.1原子構(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í)體。GB/TXXXXX.1—XXXX6.2復(fù)合構(gòu)件制作復(fù)合構(gòu)件是由原子構(gòu)件或者復(fù)合構(gòu)件組裝而成的。復(fù)合構(gòu)件的組成成員之間的連接建立就是匹配各成員構(gòu)件對(duì)外提供的功能和對(duì)外需求的功能，并將這兩種功能映射到成員構(gòu)件相應(yīng)的功能上去。復(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è)使用者；③復(fù)合構(gòu)件對(duì)外要求的功能可以映射到多個(gè)成員構(gòu)件的功能；④復(fù)合構(gòu)件對(duì)外提供的功能只能映射到一個(gè)成員構(gòu)件的功能。可以看出，復(fù)合構(gòu)件的制作是建立在已有的構(gòu)件基礎(chǔ)之上，同樣也要遵從構(gòu)件模型所描述的內(nèi)容和基本原則。7構(gòu)件接口定義7.1概述本章所列數(shù)據(jù)類型見附錄A和附錄B。7.2會(huì)話接口7.2.1創(chuàng)建增強(qiáng)現(xiàn)實(shí)會(huì)話a)參考接口定義：ArStatusArSession_create(void*env,void*context,ArSession**out_session_pointer)b)功能描述：創(chuàng)建一個(gè)新的增強(qiáng)現(xiàn)實(shí)會(huì)話。c)參數(shù)說(shuō)明：envvoid是表示運(yùn)行環(huán)境的指針contextvoid是表示運(yùn)行上下文的指針out_session_pointerArSession*是指向ArSession*的指針，以接收新分配的會(huì)話的地址5GB/TXXXXX.1—XXXXd)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.2.2創(chuàng)建特定功能的增強(qiáng)現(xiàn)實(shí)會(huì)話a)參考接口定義：ArStatusArSession_createWithFeatures(void*env,void*context,constArSessionFeature*features,ArSession**out_session_pointer)b)功能描述：創(chuàng)建一個(gè)新的增強(qiáng)現(xiàn)實(shí)會(huì)話，請(qǐng)求其他功能。c)參數(shù)說(shuō)明：類型：void，值：運(yùn)行環(huán)境；類型：void，值：運(yùn)行上下文；類型：constArSessionFeature，值：指向請(qǐng)求的功能列表的指針，值參考表2有關(guān)ArSessionFeature的定義。envvoid是表示運(yùn)行環(huán)境的指針contextvoid是表示運(yùn)行上下文的指針out_session_pointerArSession*是指向ArSession*的指針，以接收新分配的會(huì)話的地址d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.2.3釋放增強(qiáng)現(xiàn)實(shí)會(huì)話a)參考接口定義：voidArSession_destroy(ArSession*session)b)功能描述：釋放增強(qiáng)現(xiàn)實(shí)會(huì)話所占用的資源。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.2.4設(shè)置增強(qiáng)現(xiàn)實(shí)會(huì)話配置a)參考接口定義：ArStatusArSession_configure(ArSession*session,constArConfig*config)GB/TXXXXX.1—XXXXb)功能描述：增強(qiáng)現(xiàn)實(shí)會(huì)話具有默認(rèn)配置，如需修改，則調(diào)用此方法。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針configArConfig否增強(qiáng)現(xiàn)實(shí)會(huì)話的新配置設(shè)置指針d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.2.5獲取增強(qiáng)現(xiàn)實(shí)會(huì)話配置a)參考接口定義：voidArSession_getConfig(ArSession*session,ArConfig*out_config)b)功能描述：獲取當(dāng)前增強(qiáng)現(xiàn)實(shí)會(huì)話的配置。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針out_configArConfig否增強(qiáng)現(xiàn)實(shí)會(huì)話的新配置設(shè)置指針d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.2.6暫停增強(qiáng)現(xiàn)實(shí)會(huì)話a)參考接口定義：ArStatusArSession_pause(ArSession*session)b)功能描述：暫停當(dāng)前增強(qiáng)現(xiàn)實(shí)會(huì)話。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.2.7啟動(dòng)增強(qiáng)現(xiàn)實(shí)會(huì)話a)參考接口定義：ArStatusArSession_resume(ArSession*session)7GB/TXXXXX.1—XXXXb)功能描述：?jiǎn)?dòng)或恢復(fù)增強(qiáng)現(xiàn)實(shí)會(huì)話。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.2.8創(chuàng)建云錨點(diǎn)a)參考接口定義：ArStatusArSession_hostAndAcquireNewCloudAnchor（ArSession*session,constArAnchor*anchor,ArAnchor**out_cloud_anchor)b)功能描述：根據(jù)當(dāng)前錨點(diǎn)的位姿和其他的元數(shù)據(jù)創(chuàng)建一個(gè)新的云錨點(diǎn)。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針anchorArAnchor否錨點(diǎn)指針out_cloud_anchorArAnchor否指向ArAnchor*的指針，以接收新分配的云錨點(diǎn)地址d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.2.9獲取所有錨點(diǎn)a)參考接口定義：voidArSession_getAllAnchors(constArSession*session,ArAnchorList*out_anchor_list)b)功能描述：返回所有已知的錨點(diǎn)，包括當(dāng)前尚未跟蹤的錨點(diǎn)。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針out_anchor_listArAnchorList否所有的錨點(diǎn)列表d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼GB/TXXXXX.1—XXXX7.2.10解決錨的位姿a)參考接口定義：ArStatusArSession_resolveAndAcquireNewCloudAnchor(ArSession*session,constchar*cloud_anchor_id,ArAnchor**out_cloud_anchor)b)功能描述：創(chuàng)建一個(gè)新的云錨點(diǎn)，并使用給定的云錨點(diǎn)ID安排任務(wù)，來(lái)解決錨點(diǎn)的位姿。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針cloud_anchor_idchar否云錨點(diǎn)的IDout_cloud_anchorArAnchor否指向ArAnchor*的指針，以接收新分配的云錨點(diǎn)的地址d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.2.11獲取所有可跟蹤的對(duì)象a)參考接口定義：voidArSession_getAllTrackables（constArSession*session,ArTrackableTypefilter_type,ArTrackableList*out_trackable_list)b)功能描述：獲取所有能夠被跟蹤到的對(duì)象。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針filter_typeArTrackableType否可跟蹤對(duì)象類型out_trackable_listArTrackableList否指向符合返回類型的可跟蹤對(duì)象列表的指針d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.2.12定義跟蹤位置a)參考接口定義：ArStatusArSession_acquireNewAnchor(ArSession*session,constArPose*pose,ArAnchor**out_anchor)b)功能描述：定義物理世界中的跟蹤位置錨點(diǎn)。c)參數(shù)說(shuō)明：9GB/TXXXXX.1—XXXXsessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針poseArPose否位姿指針out_anchorArAnchor否指向ArAnchor*的指針，以接收新分配錨點(diǎn)地址d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.3配置接口功能定義7.3.1創(chuàng)建配置a)參考接口定義：voidArConfig_create(constArSession*session,ArConfig**out_config)b)功能描述：創(chuàng)建一個(gè)新的配置對(duì)象，并將其初始化為合理的默認(rèn)配置。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針out_configArConfig否指向ArConfig的指針，以接收新分配的配置指針d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.3.2釋放配置a)參考接口定義：voidArConfig_destroy(ArConfig*config)b)功能描述：釋放提供給當(dāng)前配置對(duì)象所使用的內(nèi)存。c)參數(shù)說(shuō)明：configArConfig否配置指針d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.3.3獲取面部增強(qiáng)模式a)參考接口定義：voidArConfig_getFocusMode(constArSession*session,ArConfig*config,ArFocusMode*focus_mode)b)功能描述：GB/TXXXXX.1—XXXXc)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針configArConfig否配置指針focus_modeArFocusMode否面部增強(qiáng)模式，并將值存入*focus_moded)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.3.4設(shè)置面部增強(qiáng)模式a)參考接口定義：voidArConfig_setAugmentedFaceMode(constArSession*session,ArConfig*config,ArAugmentedFaceModeaugmented_face_mode)b)功能描述：給當(dāng)前配置設(shè)置所需要的面部增強(qiáng)模式。c)參數(shù)說(shuō)明：須sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針configArConfig否配置指針augmented_face_modeArAugmentedFaceMode否面部增強(qiáng)模式d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.3.5獲取圖像數(shù)據(jù)庫(kù)a)參考接口定義：voidArConfig_getAugmentedFaceMode(constArSession*session,constArConfig*config,ArAugmentedFaceMode*augmented_face_mode)b)功能描述：獲取當(dāng)前配置中所設(shè)定的圖像數(shù)據(jù)庫(kù)。c)參數(shù)說(shuō)明：須sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針configArConfig否配置指針augmented_face_modeArAugmentedFaceMode否面部增強(qiáng)模式GB/TXXXXX.1—XXXXd)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.3.6設(shè)置圖像數(shù)據(jù)庫(kù)a)參考接口定義：voidArConfig_setAugmentedImageDatabase(constArSession*session,ArConfig*config,constArAugmentedImageDatabase*augmented_image_database)b)功能描述：給當(dāng)前配置設(shè)置所需要的圖像數(shù)據(jù)庫(kù)。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針configArConfig否配置指針augmented_image_databaseArAugmentedImageDataba否圖像數(shù)據(jù)庫(kù)指針d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.3.7獲取云錨點(diǎn)模式a)參考接口定義：voidStruct_getCloudAnchorMode(constArSession*session,constArConfig*config,ArCloudAnchorMode*out_cloud_anchor_mode)b)功能描述：獲取當(dāng)前配置中所設(shè)定的云錨點(diǎn)模式。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針configArConfig否配置指針out_cloud_anchor_modeArCloudAnchorMode否云錨點(diǎn)模式，并將值存入out_cloud_anchor_moded)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼GB/TXXXXX.1—XXXX7.3.8設(shè)置云錨點(diǎn)模式a)參考接口定義：voidArConfig_setCloudAnchorMode(constArSession*session,ArConfig*config,ArCloudAnchorModecloud_anchor_mode)b)功能描述：給當(dāng)前配置設(shè)置所需要的云錨點(diǎn)模式。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針configArConfig否配置指針cloud_anchor_modeArCloudAnchorMode否云錨點(diǎn)模式d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.3.9獲取深度模式a)參考接口定義：voidArConfig_getDepthMode(constArSession*session,constArConfig*config,ArDepthMode*out_depth_mode)b)功能描述：獲取當(dāng)前配置中所設(shè)定的深度模式。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針configArConfig否配置指針out_depth_modeArDepthMode否*out_depth_moded)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.3.10設(shè)置深度模式a)參考接口定義：voidArConfig_setDepthMode(constArSession*session,ArConfig*config,ArDepthModemode)b)功能描述：給當(dāng)前配置設(shè)置所需要的深度模式。GB/TXXXXX.1—XXXXc)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針configArConfig否配置指針modeArDepthMode否深度模式d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.3.11獲取相機(jī)對(duì)焦模式a)參考接口定義：voidArConfig_getFocusMode(constArSession*session,ArConfig*config,ArFocusMode*focus_mode)b)功能描述：獲取當(dāng)前配置中所設(shè)定的相機(jī)對(duì)焦模式。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針configArConfig否配置指針focus_modeArFocusMode否相機(jī)對(duì)焦模式，并將值存儲(chǔ)進(jìn)*focus_moded)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.3.12設(shè)置相機(jī)對(duì)焦模式a)參考接口定義：voidArConfig_setFocusMode(constArSession*session,ArConfig*config,ArFocusModefocus_mode)b)功能描述：給當(dāng)前配置設(shè)置所需要的相機(jī)對(duì)焦模式。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針configArConfig否配置指針focus_modeArFocusMode否相機(jī)對(duì)焦模式d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼GB/TXXXXX.1—XXXX7.3.13獲取光照模式a)參考接口定義：voidArConfig_getLightEstimationMode(constArSession*session,constArConfig*config,ArLightEstimationMode*light_estimation_mode)b)功能描述：獲取當(dāng)前配置中所設(shè)定的光照模式。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針configArConfig否配置指針light_estimation_modeArLightEstimationMode否光照模式，并將值存入*light_estimation_moded)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.3.14設(shè)置光照模式a)參考接口定義：voidArConfig_setLightEstimationMode(constArSession*session,ArConfig*config,ArLightEstimationModelight_estimation_mode)b)功能描述：給當(dāng)前配置設(shè)置所需要的光照模式。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針configArConfig否配置指針light_estimation_modeArLightEstimationMode否光照模式d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.3.15獲取平面模式a)參考接口定義：voidArConfig_getPlaneFindingMode(constArSession*session,constArConfig*config,ArPlaneFindingMode*plane_finding_mode)b)功能描述：獲取當(dāng)前配置中所設(shè)定的平面模式。GB/TXXXXX.1—XXXXc)參數(shù)說(shuō)明：須sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針configArConfig否配置指針plane_finding_modeArPlaneFindingMode否平面模式類型，并將值存入*plane_finding_moded)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.3.16設(shè)置平面模式a)參考接口定義：voidArConfig_setPlaneFindingMode(constArSession*session,ArConfig*config,ArPlaneFindingModeplane_finding_mode)b)功能描述：給當(dāng)前配置設(shè)置所需要的平面模式。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針configArConfig否配置指針plane_finding_modeArPlaneFindingMode否平面模式類型d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.4相機(jī)接口功能定義7.4.1相機(jī)內(nèi)參功能定義創(chuàng)建相機(jī)內(nèi)參a)參考接口定義：voidArCameraIntrinsics_create(constArSession*session,ArCameraIntrinsics**out_camera_intrinsics)b)功能描述：創(chuàng)建一個(gè)相機(jī)內(nèi)參對(duì)象。c)參數(shù)說(shuō)明：GB/TXXXXX.1—XXXXsessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針out_camera_intrinsicsArCameraIntrinsics否ArCameraIntrinsics*的指針，以接收新創(chuàng)建的相機(jī)內(nèi)參對(duì)象的地址d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼釋放相機(jī)內(nèi)參a)參考接口定義：voidArCameraIntrinsics_destroy(ArCameraIntrinsics*camera_intrinsics)b)功能描述：釋放提供給相機(jī)內(nèi)參對(duì)象使用的內(nèi)參。c)參數(shù)說(shuō)明：須camera_intrinsicsArCameraIntrinsics是相機(jī)內(nèi)參指針d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼獲取相機(jī)焦距a)參考接口定義：voidArCameraIntrinsics_getFocalLength(constArSession*session,constArCameraIntrinsics*intrinsics,float*out_fx,float*out_fy)b)功能描述：返回以像素為單位的相機(jī)焦距。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針intrinsicsArCameraIntrinsics否相機(jī)內(nèi)參指針out_fxfloat否返回相機(jī)的X軸上的焦距，并將其值存儲(chǔ)在*out_fxout_fyfloat否返回相機(jī)的Y軸上的焦距，并將其值存儲(chǔ)在*out_fyd)返回值：GB/TXXXXX.1—XXXXreturnstatusArStatus返回指示功能成功或失敗的代碼獲取圖像尺寸a)參考接口定義：voidArCameraIntrinsics_getImageDimensions(constArSession*session,constArCameraIntrinsics*intrinsics,int32_t*out_width,int32_t*out_height)b)功能描述：返回以像素為單位的圖像的寬度和高度。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針intrinsicsArCameraIntrinsics否相機(jī)內(nèi)參指針out_widthint32_t否返回圖形的寬度，并將其值存儲(chǔ)在*out_widthout_hightint32_t否返回圖形的高度，并將其值存儲(chǔ)在*out_hightd)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼獲取相機(jī)位置a)參考接口定義：voidArCameraIntrinsics_getPrincipalPoint(constArSession*session,constArCameraIntrinsics*intrinsics,float*out_cx,float*out_cy)b)功能描述：返回以像素為單位的相機(jī)的二維坐標(biāo)。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針intrinsicsArCameraIntrinsics否相機(jī)內(nèi)參指針out_cxfloat否float，值：返回相機(jī)的X軸坐標(biāo)，并將其值存儲(chǔ)在*out_cxout_cyfloat否返回相機(jī)的Y軸坐標(biāo)，并將其值存儲(chǔ)在*out_cyd)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼GB/TXXXXX.1—XXXX7.4.2相機(jī)通用功能定義獲取虛擬空間位姿a)參考接口定義：voidArCamera_getDisplayOrientedPose(constArSession*session,constArCamera*camera,ArPose*out_pose)b)功能描述：獲取虛擬空間在世界空間中的位姿，并將其AR內(nèi)容渲染到最新的的幀畫面上。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針cameraArCamera否相機(jī)指針out_poseArPose否返回一個(gè)已經(jīng)定義了的位姿對(duì)象，并將返回值存儲(chǔ)在*out_posed)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼獲取相機(jī)圖像流內(nèi)部函數(shù)a)參考接口定義：voidArCamera_getImageIntrinsics(constArSession*session,constArCamera*camera,ArCameraIntrinsics*out_camera_intrinsics)b)功能描述：獲取未旋轉(zhuǎn)和裁剪的相機(jī)圖像的內(nèi)部參數(shù)，由于內(nèi)參可能在每一幀中更改，因此應(yīng)該再每幀上調(diào)用此函數(shù)以獲取當(dāng)前幀的內(nèi)參。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針cameraArCamera否相機(jī)指針out_camera_intrinsicsArCameraIntrinsics否返回一個(gè)相機(jī)內(nèi)參對(duì)象，并將其存儲(chǔ)在*out_camera_intrinsicsd)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼GB/TXXXXX.1—XXXX獲取相機(jī)位姿a)參考接口定義：voidArCamera_getPose(constArSession*session,constArCamera*camera,ArPose*out_pose)b)功能描述：獲取物理相機(jī)在世界空間中最新幀畫面的位姿。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針cameraArCamera否相機(jī)指針out_poseArPose否返回一個(gè)已經(jīng)定義了的位姿對(duì)象，并將返回值存儲(chǔ)在*out_posed)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼獲取相機(jī)投影矩陣a)參考接口定義：voidArCamera_getProjectionMatrix(constArSession*session,constArCamera*camera,floatnear,floatfar,float*dest_col_major_4x4)b)功能描述：計(jì)算用于在相機(jī)圖像頂部渲染虛擬內(nèi)容的投影矩陣。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針cameraArCamera否相機(jī)指針nearfloat否指定近相機(jī)平面farfloat否指定遠(yuǎn)相機(jī)平面*dest_col_major_4x4float否返回一個(gè)4*4的投影矩陣，并將值存儲(chǔ)在*dest_col_major_4x4d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼GB/TXXXXX.1—XXXX獲取紋理流內(nèi)部參數(shù)a)參考接口定義：voidArCamera_getTextureIntrinsics(constArSession*session,constArCamera*camera,ArCameraIntrinsics*out_camera_intrinsics)b)功能描述：獲取未旋轉(zhuǎn)和檢測(cè)的GPU紋理流的內(nèi)部參數(shù)。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針cameraArCamera否相機(jī)指針*out_camera_intrinsicsArCameraIntrinsics否返回一個(gè)相機(jī)內(nèi)參對(duì)象，并將值存儲(chǔ)在*out_camera_intrinsicsd)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼獲取相機(jī)跟蹤失敗的原因a)參考接口定義：voidArCamera_getTrackingFailureReason(constArSession*session,constArCamera*camera,ArTrackingFailureReason*out_tracking_failure_reason)b)功能描述：獲取相機(jī)跟蹤失敗的原因。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針cameraArCamera否相機(jī)指針ArTrackingFailureReason否相機(jī)跟蹤失敗原因，并將值存儲(chǔ)在*out_tracking_failure_reasond)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼GB/TXXXXX.1—XXXX獲取相機(jī)跟蹤狀態(tài)a)參考接口定義：voidArCamera_getTrackingState(constArSession*session,constArCamera*camera,ArTrackingState*out_tracking_state)b)功能描述：獲取當(dāng)前使用的相機(jī)的當(dāng)前運(yùn)動(dòng)跟蹤狀態(tài)。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針cameraArCamera否相機(jī)指針out_tracking_stateArTrackingState否相機(jī)的跟蹤狀態(tài)，并將值存儲(chǔ)在*out_tracking_stated)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼獲取相機(jī)視圖矩陣a)參考接口定義：voidArCamera_getViewMatrix(constArSession*session,constArCamera*camera,float*out_col_major_4x4)b)功能描述：獲取當(dāng)前幀畫面的視圖矩陣。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針cameraArCamera否相機(jī)指針out_col_major_4x4float否返回一個(gè)4*4的視圖矩陣，并將值存儲(chǔ)在*out_col_major_4x4d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼釋放相機(jī)a)參考接口定義：voidArCamera_release(ArCamera*camera)b)功能描述：釋放對(duì)相機(jī)的引用。c)參數(shù)說(shuō)明：GB/TXXXXX.1—XXXXcameraArCamera是相機(jī)指針d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼0判斷是否支持深度模式a)參考接口定義：voidArSession_isDepthModeSupported(constArSession*session,ArDepthModedepth_mode,int32_t*out_is_supported)b)功能描述：使用當(dāng)前使用的相機(jī)的相關(guān)配置來(lái)檢查當(dāng)前設(shè)備是否支持深度模式。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針depth_modeArDepthMode否需要檢查的深度模式out_is_supportedint32_t否如果當(dāng)前設(shè)備支持深度模式，則返回非零值d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.4.3相機(jī)配置功能定義創(chuàng)建相機(jī)配置a)參考接口定義：voidArCameraConfig_create(constArSession*session,ArCameraConfig**out_camera_config)b)功能描述：創(chuàng)建一個(gè)相機(jī)配置對(duì)象。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針out_camera_configArCameraConfig否指向ArCameraConfig*的指針，以接收新創(chuàng)建的相機(jī)配置對(duì)象的地址d)返回值：GB/TXXXXX.1—XXXXreturnstatusArStatus返回指示功能成功或失敗的代碼獲取相機(jī)配置a)參考接口定義：voidArSession_getCameraConfig(constArSession*session,ArCameraConfig*out_camera_config)b)功能描述：獲取當(dāng)前會(huì)話所使用的相機(jī)的相關(guān)配置。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針out_camera_configArCameraConfig否相機(jī)配置指針d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼釋放相機(jī)配置a)參考接口定義：voidArCameraConfig_destroy(ArCameraConfig*camera_config)b)功能描述：釋放相機(jī)配置對(duì)象所使用的的內(nèi)存，以及其保存的相機(jī)配置引用。c)參數(shù)說(shuō)明：camera_configArCameraConfig是相機(jī)配置指針d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼創(chuàng)建相機(jī)配置列表a)參考接口定義：voidArCameraConfigList_create(constArSession*session,ArCameraConfigList**out_list)b)功能描述：創(chuàng)建一個(gè)相機(jī)配置列表對(duì)象。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針GB/TXXXXX.1—XXXXout_listArCameraConfigList否ArCameraConfigList*的指針，以接收新創(chuàng)建的相機(jī)創(chuàng)建列表對(duì)象的地址d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼獲取相機(jī)配置列表a)參考接口定義：voidArSession_getSupportedCameraConfigsWithFilter(constArSession*session,constArCameraConfigFilter*filter,ArCameraConfigList*list)b)功能描述：獲取滿足系統(tǒng)當(dāng)前相機(jī)配置過(guò)濾器支持的相機(jī)配置列表。c)參數(shù)說(shuō)明：須sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針filterArCameraConfigFilter否相機(jī)配置過(guò)濾器指針listArCameraConfigList否指向支持的相機(jī)配置列表的指針d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼獲取特定位置的相機(jī)配置a)參考接口定義：voidArCameraConfigList_getItem(constArSession*session,constArCameraConfigList*list,int32_tindex,ArCameraConfig*out_camera_config)b)功能描述：獲取相機(jī)配置列表中特定位置上的相機(jī)配置。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針camera_configArCameraConfig否相機(jī)配置列表指針indexint32_t否索引值out_camera_configArCameraConfig否返回一個(gè)相機(jī)配置對(duì)象，并將其存儲(chǔ)在GB/TXXXXX.1—XXXX*out_camera_configd)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼獲取相機(jī)配置數(shù)量a)參考接口定義：voidArCameraConfigList_getSize(constArSession*session,constArCameraConfigList*list,int32_t*out_size)b)功能描述：獲取相機(jī)配置列表中的相機(jī)配置的數(shù)量。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針camera_configArCameraConfig否相機(jī)配置列表指針out_sizeint32_t否返回相機(jī)配置的數(shù)量，將其值存儲(chǔ)在*out_sized)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼釋放相機(jī)配置列表a)參考接口定義：voidArCameraConfigList_destroy(ArCameraConfigList*list)b)功能描述：釋放相機(jī)配置列表對(duì)象所使用的內(nèi)存，以及其保存的所有的相機(jī)配置引用。c)參數(shù)說(shuō)明：須listArCameraConfigList是相機(jī)配置列表指針d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼獲取深度傳感器使用配置a)參考接口定義：voidArCameraConfig_getDepthSensorUsage(constArSession*session,constGB/TXXXXX.1—XXXXArCameraConfig*camera_config,uint32_t*out_depth_sensor_usage)b)功能描述：獲取深度傳感器所使用的配置。c)參數(shù)說(shuō)明：須sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針camera_configArCameraConfig否相機(jī)配置指針out_depth_sensor_usageuint32_t否返回深度傳感器的使用配*out_depth_sensor_usaged)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼0獲取相機(jī)朝向a)參考接口定義：voidArCameraConfig_getFacingDirection(constArSession*session,constArCameraConfig*camera_config,ArCameraConfigFacingDirection*out_facing)b)功能描述：獲取當(dāng)前相機(jī)配置所選擇的相機(jī)的朝向。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針camera_configArCameraConfig否相機(jī)配置指針out_facingArCameraConfigFacingDirection否相機(jī)朝向分類，并將其值存儲(chǔ)在*out_facingd)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼1獲取最大最小捕獲速率a)參考接口定義：voidArCameraConfig_getFpsRange(constArSession*session,constArCameraConfig*camera_config,int32_t*out_min_fps,int32_t*out_max_fps)b)功能描述：獲取當(dāng)前相機(jī)配置的最大和最小相機(jī)捕獲率，以每秒幀數(shù)為單位。GB/TXXXXX.1—XXXXc)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針camera_configArCameraConfig否相機(jī)配置指針out_min_fpsint32_t否返回值為最小捕獲率，將其值存儲(chǔ)在*out_min_fpsout_max_fpsint32_t否返回值為最大捕獲率，將其值存儲(chǔ)在*out_max_fpsd)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼2獲取圖像尺寸a)參考接口定義：voidArCameraConfig_getImageDimensions(constArSession*session,constArCameraConfig*camera_config,int32_t*out_width,int32_t*out_height)b)功能描述：獲取當(dāng)前相機(jī)配置中的CPU圖像尺寸。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針camera_configArCameraConfig否相機(jī)配置指針out_widthint32_t否返回值為CPU圖像的寬度，將其值存儲(chǔ)在*out_widthout_heightint32_t否返回值為CPU圖像的高度，將其值存儲(chǔ)在*out_heightd)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼3獲取紋理尺寸a)參考接口定義：voidArCameraConfig_getTextureDimensions(constArSession*session,constArCameraConfig*camera_config,int32_t*out_width,int32_t*out_height)b)功能描述：獲取當(dāng)前相機(jī)配置中的GPU紋理尺寸。c)參數(shù)說(shuō)明：GB/TXXXXX.1—XXXXsessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針camera_configArCameraConfig否相機(jī)配置指針out_widthint32_t否返回值為GPU紋理的寬度，將其值存儲(chǔ)在*out_widthout_heightint32_t否返回值為GPU紋理的高度，將其值存儲(chǔ)在*out_heightd)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.4.4相機(jī)過(guò)濾器功能定義創(chuàng)建機(jī)相機(jī)配置過(guò)濾器a)參考接口定義：voidArCameraConfigFilter_create(constArSession*session,ArCameraConfigFilter**out_filter)b)功能描述：創(chuàng)建一個(gè)相機(jī)配置過(guò)濾器對(duì)象。c)參數(shù)說(shuō)明：須sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針out_filterArCameraConfigFilter否ArCameraConfigFilter*的指針，以接收新創(chuàng)建的相機(jī)配置過(guò)濾器對(duì)象的地址d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼釋放相機(jī)配置過(guò)濾器a)參考接口定義：voidArCameraConfigFilter_destroy(ArCameraConfigFilter*filter)b)功能描述：釋放提供給相機(jī)配置過(guò)濾器所用的內(nèi)存。c)參數(shù)說(shuō)明：須GB/TXXXXX.1—XXXXfilterArCameraConfigFilter是相機(jī)配置過(guò)濾器指針d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼獲取所需的深度傳感器使用a)參考接口定義：voidArCameraConfigFilter_getDepthSensorUsage(constArSession*session,ArCameraConfigFilter*filter,uint32_t*out_depth_sensor_usage)b)功能描述：獲取所需的深度傳感器的使用。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針filterArCameraConfigFilter否相機(jī)配置過(guò)濾器指針out_depth_sensor_usageuint32_t否深度傳感器使用狀態(tài)，并將其值存儲(chǔ)在*out_depth_sensor_usaged)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼設(shè)置所需的深度傳感器使用a)參考接口定義：voidArCameraConfigFilter_setDepthSensorUsage(constArSession*session,ArCameraConfigFilter*filter,uint32_tdepth_sensor_usage_filters)b)功能描述：設(shè)置所需的深度傳感器的使用。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針filterArCameraConfigFilter否相機(jī)配置過(guò)濾器指針depth_sensor_usage_filtersuint32_t否深度傳感器使用狀態(tài)d)返回值：GB/TXXXXX.1—XXXXreturnstatusArStatus返回指示功能成功或失敗的代碼獲取所需的捕獲幀率a)參考接口定義：voidArCameraConfigFilter_getTargetFps(constArSession*session,ArCameraConfigFilter*filter,uint32_t*out_fps_filters)b)功能描述：獲取允許的所需捕獲幀率。c)參數(shù)說(shuō)明：須sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針filterArCameraConfigFilter否相機(jī)配置過(guò)濾器指針out_fps_filtersuint32_t否目標(biāo)相機(jī)捕獲幀率狀態(tài)，并將其值存儲(chǔ)在*out_fps_filtersd)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼設(shè)置所需的捕獲幀率a)參考接口定義：voidArCameraConfigFilter_setTargetFps(constArSession*session,ArCameraConfigFilter*filter,constuint32_tfps_filters)b)功能描述：設(shè)置允許的所需捕獲幀率。c)參數(shù)說(shuō)明：須sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針filterArCameraConfigFilter否相機(jī)配置過(guò)濾器指針fps_filtersuint32_t否目標(biāo)相機(jī)捕獲幀率狀態(tài)d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.5光照估計(jì)接口功能定義GB/TXXXXX.1—XXXX7.5.1創(chuàng)建光照估計(jì)a)參考接口定義：voidArLightEstimate_create(constArSession*session,ArLightEstimate**out_light_estimate)b)功能描述：創(chuàng)建一個(gè)新的光照估計(jì)對(duì)象。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針out_light_estimateArLightEstimate否指向ArLightEstimate*的指針，以接收新創(chuàng)建的光照估計(jì)對(duì)象的地址d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.5.2釋放光照估計(jì)a)參考接口定義：voidArLightEstimate_destroy(ArLightEstimate*light_estimate)b)功能描述：釋放提供給光照估計(jì)對(duì)象使用的內(nèi)存。c)參數(shù)說(shuō)明：light_estimateArLightEstimate是光照估計(jì)指針d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.5.3獲取顏色校正值a)參考接口定義：voidArLightEstimate_getColorCorrection(constArSession*session,constArLightEstimate*light_estimate,float*out_color_correction_4)b)功能描述：獲取著色器的顏色校正值。c)參數(shù)說(shuō)明：須sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針light_estimateArLightEstimate否光照估計(jì)對(duì)象指針out_color_correction_4float否返回的校正值GB/TXXXXX.1—XXXXd)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.5.4獲取環(huán)境照明的球諧系數(shù)a)參考接口定義：voidArLightEstimate_getEnvironmentalHdrAmbientSphericalHarmonics(constArSession*session,constArLightEstimate*light_estimate,float*out_coefficients_27)b)功能描述：根據(jù)推斷的環(huán)境HDR照明估計(jì)，獲取環(huán)境照明的球諧系數(shù)。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針light_estimateArLightEstimate否光照估計(jì)對(duì)象指針out_coefficients_27float否返回的球諧系數(shù)值d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.5.5獲取主定向光方向a)參考接口定義：voidArLightEstimate_getEnvironmentalHdrMainLightDirection(constArSession*session,constArLightEstimate*light_estimate,float*out_direction_3)b)功能描述：根據(jù)推斷的環(huán)境HDR照明估計(jì)值返回主定向光的方向。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針light_estimateArLightEstimate否光照估計(jì)對(duì)象指針out_direction_3float否返回的主定向光方向d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.5.6獲取主定向光強(qiáng)度a)參考接口定義：voidArLightEstimate_getEnvironmentalHdrMainLightIntensity(constArSession*session,constArLightEstimate*light_estimate,float*out_intensity_3)b)功能描述：根據(jù)推斷的環(huán)境HDR照明估計(jì)值返回主定向光的強(qiáng)度。GB/TXXXXX.1—XXXXc)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針light_estimateArLightEstimate否光照估計(jì)對(duì)象指針out_intensity_3float否返回的主定向光強(qiáng)度d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.5.7獲取光照估計(jì)狀態(tài)a)參考接口定義：voidArLightEstimate_getState(constArSession*session,constArLightEstimate*light_estimate,ArLightEstimateState*out_light_estimate_state)b)功能描述：獲取當(dāng)前的光照估計(jì)狀態(tài)。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針light_estimateArLightEstimate否光照估計(jì)指針out_light_estimate_stateArLightEstimateState否光照估計(jì)狀態(tài)分類d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.5.8獲取時(shí)間戳a)參考接口定義：voidArLightEstimate_getTimestamp(constArSession*session,constArLightEstimate*light_estimate,int64_t*out_timestamp_ns)b)功能描述：獲取給定光照估計(jì)的時(shí)間戳（以納秒為單位）。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針light_estimateArLightEstimate否光照估計(jì)指針out_timestamp_nsint64_t否返回的時(shí)間戳d)返回值：GB/TXXXXX.1—XXXXreturnstatusArStatus返回指示功能成功或失敗的代碼7.6位姿接口功能定義7.6.1創(chuàng)建位姿a)參考接口定義：voidArPose_create(constArSession*session,constfloat*pose_raw,ArPose**out_pose)b)功能描述：創(chuàng)建一個(gè)位姿對(duì)象。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針pose_rawfloat否指向float[7]的指針，其中存儲(chǔ)的是描述位姿的旋轉(zhuǎn)四元組和平移三元組out_poseArPose否指向ArPose*，以接收新創(chuàng)建的位姿的對(duì)象的地址d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.6.2釋放位姿a)參考接口定義：voidArPose_destroy(ArPose*pose)b)功能描述：釋放提供給位姿使用的內(nèi)存空間，以及其所有的引用。c)參數(shù)說(shuō)明：poseArPose是位姿指針d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.6.3獲取位姿矩陣a)參考接口定義：voidArPose_getMatrix(constArSession*session,constArPose*pose,float*out_matrix_col_major_4x4)b)功能描述：將位姿轉(zhuǎn)換成4*4的矩陣，并輸出。GB/TXXXXX.1—XXXXc)參數(shù)說(shuō)明：須sessionArSession是類型：Struct，值：poseArPose否位姿指針out_matrix_col_major_4x4float否其值存儲(chǔ)在*out_matrix_col_major_4x4所指向的內(nèi)存空間d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.6.4獲取位姿信息a)參考接口定義：voidArPose_getPoseRaw(constArSession*session,constArPose*pose,float*out_pose_raw_7)b)功能描述：獲取位姿的四元組數(shù)據(jù)以及旋轉(zhuǎn)和平移信息。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針poseArPose否位姿指針out_pose_raw_7float否返回值為旋轉(zhuǎn)四元組與平移三元組組成的float[7]數(shù)組，并將其值存儲(chǔ)在*out_pose_raw_7所指向的內(nèi)存空間d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.7錨點(diǎn)接口功能定義7.7.1創(chuàng)建錨點(diǎn)列表a)參考接口定義：voidArAnchorList_create(constArSession*session,ArAnchorList**out_anchor_list)GB/TXXXXX.1—XXXXb)功能描述：創(chuàng)建一個(gè)錨點(diǎn)列表對(duì)象。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針out_anchor_listArAnchorList否指向ArAnchorList的指針，以接收新創(chuàng)建的錨點(diǎn)列表的地址d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.7.2釋放錨點(diǎn)列表a)參考接口定義：voidArAnchorList_destroy(ArAnchorList*anchor_list)b)功能描述：釋放提供給錨點(diǎn)列表對(duì)象使用的內(nèi)存，以及其持有的所有錨點(diǎn)的引用。c)參數(shù)說(shuō)明：anchor_listArAnchorList是錨點(diǎn)列表指針d)返回值：returnstatusArStatus返回指示功能成功或失敗的代碼7.7.3獲取錨點(diǎn)引用a)參考接口定義：voidArAnchorList_acquireItem(constArSession*session,constArAnchorList*anchor_list,int32_tindex,ArAnchor**out_anchor)b)功能描述：獲取對(duì)錨點(diǎn)列表中指定索引處的錨點(diǎn)的引用。c)參數(shù)說(shuō)明：sessionArSession是增強(qiáng)現(xiàn)實(shí)會(huì)話指針anchor_listArAnchorList否錨點(diǎn)列表指針indexint32_t否指定的索引值out_anchorArAnchor否指向指定索引值的錨點(diǎn)，