百度智能小程序 AR相機(jī)

ar-camera AR 相機(jī)

基礎(chǔ)庫 3.15.104 開始支持，低版本需做兼容處理。ar-camera 組件目前只針對(duì)百度 APP 開放使用。

解釋：AR 相機(jī)，在DuMixAR 內(nèi)容開放平臺(tái)提交并上線 AR 項(xiàng)目后（選擇“百度 App-相機(jī)”渠道）獲取到 AR Key、AR Type，可配置展現(xiàn)。ar-camera 組件還提供豐富的 api 來控制相機(jī)錄像、拍照等，詳見swan.createARCameraContext。

屬性說明

type 有效值

flash 有效值

示例

代碼示例

<ar-camera ar-key="10298931" ar-type="5" flash="{{flashState}}" class="camera" bindload="loadCameraSuccess" bindmessage="message" binderror="error">
</ar-camera>

其它代碼過長，建議直接在開發(fā)者工具中預(yù)覽效果。

用戶自定義事件

設(shè)計(jì)指南

如未獲取相機(jī)權(quán)限致使相機(jī)無法使用，可通過模態(tài)彈窗（showModal）進(jìn)行明確的提示反饋，避免相機(jī)黑屏阻斷流程，影響用戶體驗(yàn)。

正確未獲取相機(jī)權(quán)限時(shí)提示用戶權(quán)限未開啟


錯(cuò)誤未獲取相機(jī)權(quán)限卻無提示，導(dǎo)致用戶無措

使用 AR 相機(jī)過程中如遇網(wǎng)絡(luò)、性能等問題導(dǎo)致等待時(shí)間過長（超過 3 秒）或操作失敗，可通過消息提示框（showToast）為用戶提供明確的操作反饋。

正確

識(shí)別過程反饋

正確

操作失敗反饋

Bug & Tip

• Tip：ar-camera 組件是由客戶端創(chuàng)建的原生組件，它的層級(jí)是最高的，不能通過 z-index 控制層級(jí)?？墒褂?cover-view cover-image 覆蓋在上面。Tip：同一頁面只能插入一個(gè) ar-camera 組件?？稍谛马撁嬷蟹胖?ar-camera 組件，并使用 swan.navigate API（注意應(yīng)防止用戶多次連續(xù)點(diǎn)擊，否則會(huì)導(dǎo)致 AR 頁面多次打開出現(xiàn)卡頓）跳轉(zhuǎn)至該頁面。Tip：請(qǐng)勿在 scroll-view、swiper、picker-view、movable-view 中使用 ar-camera 組件。Tip：AR 相機(jī)支持 iPhone X 及以上機(jī)型顯示 16：9 的比例；支持 iPhone X 以下機(jī)型顯示全屏比例。Tip：相關(guān) API：createARCameraContext。