Accelerometer API

Accelerometer API

参考: 加速度计 API 是与 wx API（wx.startAccelerometer、wx.stopAccelerometer 等）不兼容的 TudadaSDK 独立接口。API 名称（startAccelerometerSensor vs startAccelerometer）和参数结构不同，请务必通过 TudadaSDK 直接调用。无法通过 wx 对象使用。

startAccelerometerSensor(options?)

开始加速度计传感。

选项:

参数	类型	必填	说明
sensitivity	string	-	灵敏度 ('sensitive' | 'normal' | 'insensitive')。默认值: 'normal'
success	function	-	成功回调
fail	function	-	失败回调
complete	function	-	完成回调

灵敏度选项:

值	说明
'sensitive'	敏感 -- 检测微小变化
'normal'	正常 -- 检测一般变化（默认值）
'insensitive'	迟钝 -- 仅检测大幅变化

TudadaSDK.startAccelerometerSensor({
  sensitivity: 'normal',
  success: () => console.log('开始传感'),
  fail: (err) => console.error('启动失败:', err.errMsg),
});

stopAccelerometerSensor(options?)

停止加速度计传感。

选项:

参数	类型	必填	说明
success	function	-	成功回调
fail	function	-	失败回调
complete	function	-	完成回调

TudadaSDK.stopAccelerometerSensor({
  success: () => console.log('停止传感'),
});

onAccelerometerChange(callback) / offAccelerometerChange(callback?)

注册/注销加速度计变化事件监听器。offAccelerometerChange 未指定 callback 时移除所有监听器。

回调参数:

字段	类型	说明
x	number	X 轴加速度
y	number	Y 轴加速度
z	number	Z 轴加速度

// 注册事件监听器（可在开始传感前注册）
TudadaSDK.onAccelerometerChange((res) => {
  console.log(`X: ${res.x}, Y: ${res.y}, Z: ${res.z}`);
});

// 开始传感
TudadaSDK.startAccelerometerSensor({
  sensitivity: 'normal',
  success: () => console.log('开始传感'),
});

// 停止传感
TudadaSDK.stopAccelerometerSensor({
  success: () => console.log('停止传感'),
});

// 移除事件监听器
TudadaSDK.offAccelerometerChange();