設備方向

stopDeviceMotionListening

TIP

該API使用方法為： wx.stopDeviceMotionListening(Object object)
該API小程序支持，小遊戲暫不支持

• 功能說明： 停止監聽設備方向的變化
• 參數及說明： Object object。

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

startDeviceMotionListening

TIP

該API使用方法為： wx.startDeviceMotionListening(Object object)
該API小程序支持，小遊戲暫不支持

• 功能說明： 開始監聽設備方向的變化
• 參數及說明： Object object。

  内容	類型	預設值	必填	說明
  interval	string	normal	否	監聽設備方向的變化回呼函數的執行頻率，合法值為： game: 適用於更新遊戲的回檔幀率，在20ms/次左右 ui: 適用於更新UI的回檔幀率，在60ms/次左右 normal: 普通的回檔頻率，在200ms/次左右
  success	Function	-	否	接口調用成功的回呼函數
  fail	Function	-	否	接口調用失敗的回呼函數
  complete	Function	-	否	接口調用結束的回呼函數（無論成功與否都執行）

onDeviceMotionChange

TIP

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

• 功能說明： 監聽設備方向變化事件。 頻率根據 wx.startDeviceMotionListening() 的interval參數。 可以使用 wx.stopDeviceMotionListening() 停止監聽。
• 參數及說明： function listener，設備方向變化事件的監聽函數

  内容	類型	說明
  alpha	number	當手機座標X/Y和地球X/Y重合時，繞著Z軸轉動的夾角為alpha，範圍值為[0，2*PI）。逆時針轉動為正。
  beta	number	當手機座標Y/Z和地球Y/Z重合時，繞著X軸轉動的夾角為beta。 範圍值為[-1*PI，PI）。頂部朝著地球表面轉動為正。 也有可能朝著用戶為正。
  gamma	number	當手機X/Z和地球X/Z重合時，繞著Y軸轉動的夾角為gamma。 範圍值為[-1*PI/2，PI/2）。右邊朝著地球表面轉動為正。

offDeviceMotionChange

TIP

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

• 功能說明： 移除設備方向變化事件的監聽函數

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

• 示例代碼：

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

wx.onDeviceMotionChange(listener)
wx.offDeviceMotionChange(listener) // Pass the same function object used for listening.