• ar-camera AR 相機
  • 屬性說明
    • type 有效值
    • flash 有效值
  • 示例
    • 代碼示例 1
    • 代碼示例 2：用戶自定義事件
  • Bug & Tip

ar-camera AR 相機

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

解釋：AR 相機，在 DuMixAR 內(nèi)容開放平臺提交并上線 AR 項目后（選擇“百度 App -> 相機”渠道）獲取到 AR Key、AR Type ，可配置展現(xiàn)。ar-camera 組件還提供豐富的 API 來控制相機錄像、拍照等，詳見 swan.createARCameraContext 。
Web 態(tài)說明：Web 態(tài)暫不支持 ar-camera 組件。在 Web 態(tài)會做打開百度 App 對應(yīng)小程序頁面的降級處理。

屬性說明

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

type 有效值

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

flash 有效值

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

示例

跳轉(zhuǎn)編輯工具

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

在 WEB IDE 中打開

掃碼體驗

代碼示例

請使用百度APP掃碼

代碼示例 1

• SWAN

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

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

• JSON

 
 
 

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

設(shè)計指南

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

正確

未獲取相機權(quán)限時提示用戶權(quán)限未開啟

錯誤

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

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

正確

識別過程反饋

正確

操作失敗反饋

Bug & Tip

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

當前名稱：創(chuàng)新互聯(lián)百度小程序教程：ar-cameraAR相機
文章路徑：http://www.dlmjj.cn/article/ccejcsj.html