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

ar-camera AR 相機(jī)

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

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

屬性說(shuō)明

屬性名	類型	默認(rèn)值	必填	說(shuō)明
key	String		是	AR 項(xiàng)目唯一標(biāo)識(shí)，在 DuMixAR 內(nèi)容開(kāi)放平臺(tái)上傳生成 AR 項(xiàng)目后獲取 AR Key
type	String		是	AR 相機(jī)類型，在 DuMixAR 內(nèi)容開(kā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		否	開(kāi)發(fā)者制作 AR 項(xiàng)目時(shí)可自定義按鍵，用戶點(diǎn)擊時(shí)會(huì)收到事件和數(shù)據(jù)，用戶自定義事件格式參見(jiàn)代碼示例 2：用戶自定義事件
bindscancode	EventHandle		否	掃描識(shí)圖結(jié)束后觸發(fā)

type 有效值

值	說(shuō)明
0	2D 跟蹤類型
5	SLAM 類型
8	IMU 類型

flash 有效值

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

示例

跳轉(zhuǎn)編輯工具

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

在 WEB IDE 中打開(kāi)

掃碼體驗(yàn)

代碼示例

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

代碼示例 1

• SWAN

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

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

• JSON

 
 
 

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

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

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

正確

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

錯(cuò)誤

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

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

正確

識(shí)別過(guò)程反饋

正確

操作失敗反饋

Bug & Tip

• Tip：ar-camera 組件是由客戶端創(chuàng)建的原生組件，它的層級(jí)是最高的，不能通過(guò) z-index 控制層級(jí)。可使用 cover-view cover-image 覆蓋在上面。
• Tip：同一頁(yè)面只能插入一個(gè) ar-camera 組件?？稍谛马?yè)面中放置 ar-camera 組件，并使用 API swan.navigateTo（注意應(yīng)防止用戶多次連續(xù)點(diǎn)擊，否則會(huì)導(dǎo)致 AR 頁(yè)面多次打開(kāi)出現(xiàn)卡頓）跳轉(zhuǎn)至該頁(yè)面。
• 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ī)
標(biāo)題網(wǎng)址：http://m.5511xx.com/article/ccejcsj.html