基础库 2.92.0 开始支持本方法，这是一个同步方法。

监听设备方向变化事件。数据变化及回调的频率根据 tt.startDeviceMotionListening 的 interval 参数决定。

前提条件	无
业务背景	无
使用限制	无
注意事项	无
相关教程	无

语法

tt.onDeviceMotionChange(callback)

参数说明

callback

类型	默认值	必填	说明	最低支持版本
function		是	设备方向变化事件的回调函数，回调频率由开发者决定。	2.92.0

callback 参数说明

设备方向为相对方向，依赖于坐标系如何建立。为方便回调参数的描述与理解，首先以手机中心点为原点，可以假定坐标系如下图所示：

callback 是一个回调函数，接收 object 类型的参数，属性如下：

属性名	类型	说明	最低支持版本
alpha	number	偏航角，绕z轴旋转，逆时针转动为正方向，取值范围为[-PI, PI)。	2.92.0
beta	number	俯仰角，绕x轴旋转，手机顶部向上为正方向，取值范围为[-PI/2, PI/2)。	2.92.0
gamma	number	翻滚角，绕y轴旋转，手机右侧向下为正方向，取值范围为[-PI, PI)。	2.92.0

返回值

无

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

tt.startDeviceMotionListening({
  interval: "normal",
  success(res) {
    tt.onDeviceMotionChange((res) => {
      console.log("设备的偏航角为：", res.alpha);
      console.log("设备的俯仰角为：", res.beta);
      console.log("设备的翻滚角为：", res.gamma);
    });
  },
});