普通小游戏开发
API
开放能力
数据分析
视频拍摄器
多端支持

tt.onGyroscopeChange

基础库 1.72.0 开始支持本方法,低版本需做兼容处理

监听陀螺仪数据变化,数据变化及回调函数被调用的频率取决于启动陀螺仪实例时传入的参数,该方法为同步方法。

语法

tt.onGyroscopeChange(callback)

参数说明

属性类型是否必填说明
callbackfunction陀螺仪数据变化事件的回调函数,回调频率由开发者决定。

回调数据

回调参数类型为 object, 说明如下

属性类型说明
xnumberx 轴的角速度。
ynumbery 轴的角速度。
znumberz 轴的角速度。
rollnumber姿态角值,围绕 Z 轴旋转,也叫翻滚角。
pitchnumber姿态角值,围绕 X 轴旋转,也叫做俯仰角。
yawnumber姿态角值,围绕 Y 轴旋转,也叫偏航角。
tnumber从设备启动到现在经过的时间戳,单位是 ms。
resultnumber数据是否有效的标示,但值为-1 时表示当前值无效。

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

//设置每隔100ms刷新一次陀螺仪数据

tt.startGyroscope({ interval: 100 });

tt.onGyroscopeChange(function (params) {
  console.log("陀螺仪数据:x ", params.x);
  console.log("陀螺仪数据:y ", params.y);
  console.log("陀螺仪数据:z ", params.z);
  console.log("陀螺仪数据:t ", params.t);
  console.log("陀螺仪数据:result ", params.result);
});

Bug & Tip

  • 姿态角相关值需要基础库 1.77.0 以上 版本支持
点击纠错
评价此篇文档