相機

createCameraContext

TIP

該API使用方法為： CameraContext wx.createCameraContext()

• 功能說明： 創建camera上下文CameraContext對象
• 返回值： CameraContext

CameraContext

• 功能說明： CameraContext實例，可通過 wx.createCameraContext 取。 cameraContext與頁面內唯一的 camera 組件綁定，操作對應的 camera 組件

.onCameraFrame

TIP

該API使用方法為： CameraFrameListener CameraContext.onCameraFrame(onCameraFrameCallback callback)

TIP

使用該接口需同時在 camera 組件内容中指定frame-size

• 功能說明： 獲取Camera實时幀數據。

• 返回值： function callback。

• object.success回呼函數參數： Object res。

  内容	類型	說明
  width	number	影像數據矩形的寬度
  height	number	影像數據矩形的高度
  data	ArrayBuffer	影像點數點數據，一維數組，每四項表示一個點數點的rgba

• 返回值： CameraFrameListener

• 示例代碼：

const context = wx.createCameraContext()
const listener = context.onCameraFrame((frame) => {
  console.log(frame.data instanceof ArrayBuffer, frame.width, frame.height)
})
listener.start()

.setZoom

TIP

該API使用方法為： CameraContext.setZoom(Object object)

• 功能說明： 設定縮放級別。

• 參數及說明： Object object

  内容	類型	預設值	必填	說明
  zoom	number	-	是	縮放級別，範圍[1，maxZoom]。 zoom可取小數，精確到小數後一比特。 maxZoom可在bindinitdone返回值中獲取
  success	Function	-	否	接口調用成功的回呼函數
  fail	Function	-	否	接口調用失敗的回呼函數
  complete	Function	-	否	接口調用結束的回呼函數（無論成功與否都執行）

• object.success回呼函數參數： Object res。

  内容	類型	說明
  zoom	number	實際設定的縮放級別，由於系統限制，某些機型可能無法設定成指定值，會改用最接近的可設值

.startRecord

TIP

該API使用方法為： CameraContext.startRecord(Object object)

• 功能說明： 開始錄影。

• 參數及說明： Object object

  内容	類型	預設值	必填	說明
  timeoutCallback	function	-	否	超過30s或頁面 onHide 時會結束錄影，錄影異常退出時也會觸發此回調
  success	Function	-	否	接口調用成功的回呼函數
  fail	Function	-	否	接口調用失敗的回呼函數
  complete	Function	-	否	接口調用結束的回呼函數（無論成功與否都執行）

• object.timeoutCallback回呼函數參數： Object res。

  内容	類型	說明
  tempThumbPath	string	封面圖片文件的臨時路徑
  tempVideoPath	string	視頻的文件的臨時路徑

.stopRecord

TIP

該API使用方法為： CameraContext.stopRecord(Object object)

• 功能說明： 結束錄影。

• 參數及說明： Object object

  内容	類型	預設值	必填	說明
  success	Function	-	否	接口調用成功的回呼函數
  fail	Function	-	否	接口調用失敗的回呼函數
  complete	Function	-	否	接口調用結束的回呼函數（無論成功與否都執行）

• object.success回呼函數參數： Object res。

  内容	類型	說明
  tempThumbPath	string	封面圖片文件的臨時路徑
  tempVideoPath	string	視頻的文件的臨時路徑

.takePhoto

TIP

該API使用方法為： CameraContext.takePhoto(Object object)

• 功能說明： 拍攝照片。

• 參數及說明： Object object

  内容	類型	預設值	必填	說明
  quality	string	normal	否	成像品質
  success	Function	-	否	接口調用成功的回呼函數
  fail	Function	-	否	接口調用失敗的回呼函數
  complete	Function	-	否	接口調用結束的回呼函數（無論成功與否都執行）

• object.quality的合法值

  值	說明
  high	高品質
  normal	普通質量
  low	低質量

• object.success回呼函數參數： Object res。

  内容	類型	說明
  tempImagePath	string	照片文件的臨時路徑（本地路徑），安卓是jpg圖片格式，ios是png

CameraFrameListener

TIP

• CameraContext.onCameraFrame（）返回的監聽器。
• 相關文檔，可參見 camera。

.start

TIP

該API使用方法為： CameraFrameListener.start(Object object)

• 功能說明： 開始監聽幀數據。

• 參數及說明： Object object

  内容	類型	預設值	必填	說明
  success	Function	-	否	接口調用成功的回呼函數
  fail	Function	-	否	接口調用失敗的回呼函數
  complete	Function	-	否	接口調用結束的回呼函數（無論成功與否都執行）

.stop

TIP

該API使用方法為： CameraFrameListener.stop(Object object)

• 功能說明： 停止監聽幀數據。

• 參數及說明： Object object

  内容	類型	預設值	必填	說明
  success	Function	-	否	接口調用成功的回呼函數
  fail	Function	-	否	接口調用失敗的回呼函數
  complete	Function	-	否	接口調用結束的回呼函數（無論成功與否都執行）