抖音开放平台Logo
控制台

tt.onCompassChange
收藏
我的收藏

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

监听罗盘数据变化事件,罗盘数据会在用户手机发生“朝向变化/加速前进&后退/摇一摇”等手势时触发变化。频率:5 次/秒,接口调用后会自动开始监听,可使用 tt.stopCompass 停止监听。

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

语法

tt.onCompassChange(callback)

参数说明

callback

类型默认值必填说明最低支持版本
function

在罗盘数据变化时执行的回调函数

1.2.0

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

属性名类型说明最低支持版本
directionnumber

面对的方向度数(从朝南方向开始,顺时针转的角度)

1.2.0

返回值

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

tt.onCompassChange((res) => {
  console.log(`罗盘方向: ${res.direction}`);
});