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();