Accelerometer API

Accelerometer API

Note: The Accelerometer API is a TudadaSDK-specific interface that is not compatible with the wx API (wx.startAccelerometer, wx.stopAccelerometer, etc.). The API names (startAccelerometerSensor vs startAccelerometer) and parameter structures differ, so you must call them directly from TudadaSDK. They cannot be used through the wx object.

startAccelerometerSensor(options?)

Starts accelerometer sensing.

Options:

Parameter	Type	Required	Description
sensitivity	string	-	Sensitivity ('sensitive' | 'normal' | 'insensitive'). Default: 'normal'
success	function	-	Success callback
fail	function	-	Failure callback
complete	function	-	Completion callback

Sensitivity Options:

Value	Description
'sensitive'	Sensitive -- detects small changes
'normal'	Normal -- detects general changes (default)
'insensitive'	Insensitive -- detects only large changes

TudadaSDK.startAccelerometerSensor({
  sensitivity: 'normal',
  success: () => console.log('Sensing started'),
  fail: (err) => console.error('Start failed:', err.errMsg),
});

stopAccelerometerSensor(options?)

Stops accelerometer sensing.

Options:

Parameter	Type	Required	Description
success	function	-	Success callback
fail	function	-	Failure callback
complete	function	-	Completion callback

TudadaSDK.stopAccelerometerSensor({
  success: () => console.log('Sensing stopped'),
});

onAccelerometerChange(callback) / offAccelerometerChange(callback?)

Registers/unregisters an accelerometer change event listener. When offAccelerometerChange is called without a callback, all listeners are removed.

Callback Parameters:

Field	Type	Description
x	number	X-axis acceleration
y	number	Y-axis acceleration
z	number	Z-axis acceleration

// Register event listener (can be registered before sensing starts)
TudadaSDK.onAccelerometerChange((res) => {
  console.log(`X: ${res.x}, Y: ${res.y}, Z: ${res.z}`);
});

// Start sensing
TudadaSDK.startAccelerometerSensor({
  sensitivity: 'normal',
  success: () => console.log('Sensing started'),
});

// Stop sensing
TudadaSDK.stopAccelerometerSensor({
  success: () => console.log('Sensing stopped'),
});

// Remove event listener
TudadaSDK.offAccelerometerChange();