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 。
Web 態(tài)說明：Web 態(tài)暫不支持 ar-camera 組件。在 Web 態(tài)會(huì)做打開百度 App 對(duì)應(yīng)小程序頁面的降級(jí)處理。

屬性說明

屬性名	類型	默認(rèn)值	必填	說明
key	String		是	AR 項(xiàng)目唯一標(biāo)識(shí)，在 DuMixAR 內(nèi)容開放平臺(tái)上傳生成 AR 項(xiàng)目后獲取 AR Key
type	String		是	AR 相機(jī)類型，在 DuMixAR 內(nèi)容開放平臺(tái)上傳生成 AR 項(xiàng)目后獲取 AR Type： 2D 跟蹤類型：0 SLAM 類型：5 IMU 類型：8
flash	String	off	否	閃光燈，值為 auto、on、off
binderror	EventHandle		否	用戶不允許使用攝像頭或掃碼失敗時(shí)觸發(fā)
bindload	EventHandle		否	AR 加載成功時(shí)觸發(fā)
bindmessage	EventHandle		否	開發(fā)者制作 AR 項(xiàng)目時(shí)可自定義按鍵，用戶點(diǎn)擊時(shí)會(huì)收到事件和數(shù)據(jù)，用戶自定義事件格式參見代碼示例 2：用戶自定義事件
bindscancode	EventHandle		否	掃描識(shí)圖結(jié)束后觸發(fā)

type 有效值

值	說明
0	2D 跟蹤類型
5	SLAM 類型
8	IMU 類型

flash 有效值

值	說明
auto	自動(dòng)閃光燈
on	閃光燈開
off	閃光燈關(guān)

示例

跳轉(zhuǎn)編輯工具

在開發(fā)者工具中打開

在 WEB IDE 中打開

掃碼體驗(yàn)

代碼示例

請(qǐng)使用百度APP掃碼

代碼示例 1

SWAN

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

代碼示例 2：用戶自定義事件

JSON

 
 
 
  
  
  {
  
  
   // 常量值，不能改變
  
  
   "event_name": "smart_baiduapp_event", 
  
  
   // 自定義K-V數(shù)據(jù)，會(huì)透傳給小程序
  
  
   "data": { 
  
  
   // key必須是string類型，value建議也是string類型
  
  
   "key1": "value1" 
  
  
   }
  
  
  }

設(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 組件，并使用 API swan.navigateTo（注意應(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ī)型顯示全屏比例。

本文名稱：創(chuàng)新互聯(lián)百度小程序教程：ar-cameraAR相機(jī)
文章URL：http://m.fisionsoft.com.cn/article/ccejcsj.html

新聞中心