加速計

startAccelerometer

TIP

該API使用方法為： wx.startAccelerometer(Object object)

TIP

根據機型效能、當前CPU與記憶體的佔用情况，interval的設定與實際 wx.onAccelerometerChange 回呼函數的執行頻率會有一些出入

• 功能說明： 開始監聽加速度數據

• 參數及說明： Object object。

  内容	類型	預設值	必填	說明
  interval	string	normal	是	監聽加速度數據回呼函數的執行頻率
  success	Function	-	否	接口調用成功的回呼函數
  fail	Function	-	否	接口調用失敗的回呼函數
  complete	Function	-	否	接口調用結束的回呼函數（無論成功與否都執行）

• object.interval的合法值

  值	說明
  game	適用於更新遊戲的回檔頻率，在20ms/次左右
  ui	適用於更新UI的回檔頻率，在60ms/次左右
  normal	普通的回檔頻率，在200ms/次左右

• 示例代碼：

wx.startAccelerometer({
  interval: 'game'
})

stopAccelerometer

TIP

該API使用方法為： wx.stopAccelerometer(Object object)

• 功能說明： 停止監聽加速度數據

• 參數及說明： Object object。

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

• 示例代碼：

wx.stopAccelerometer()

onAccelerometerChange

TIP

該API使用方法為： wx.onAccelerometerChange(function listener)

• 功能說明： 監聽設備方向變化事件。 頻率根據 wx.startAccelerometer() 的interval參數。 可以使用 wx.stopAccelerometer() 停止監聽。

• 參數及說明： function callback, 加速度數據事件的回呼函數。 參數Object.res如下：

  内容	類型	說明
  x	number	X軸
  y	number	Y軸
  z	number	Z軸

• 示例代碼：

wx.onAccelerometerChange(function (res) {
  console.log(res.x)
  console.log(res.y)
  console.log(res.z)
})

offAccelerometerChange

TIP

該API使用方法為： wx.offAccelerometerChange(function listener)

• 功能說明： 移除加速度數據事件的監聽函數

• 參數及說明： function callback, onAccelerometerChange傳入的監聽函數。 不傳此參數則移除所有監聽函數

• 示例代碼：

const listener = function (res) { console.log(res) }

wx.onAccelerometerChange(listener)
wx.offAccelerometerChange(listener) // Pass the same function object used for listening.