걸음수 가져오기 | 날짜, 위치, 건강 데이터 | Appbox SDK 가이드
걸음수 가져오기
오늘, 이번 주, 이번 달 기준으로 걸음 수를 조회할 수 있으며, 이를 건강 관리, 운동 기록, 목표 달성 기능 등에 활용할 수 있습니다. 앱에서 사용자의 활동 현황을 직접 보여주거나 보상, 챌린지, 미션 시스템과 연동해 활용할 수 있습니다.
디바이스의 걸음수 가져오기
AppboxSDK.health.getStep(...)
Javascript
1
// 걸음수
2
AppboxSDK.health.getStep(
3
{
4
fromDate: "20250201",
5
toDate: "20250405"
6
}, (err, data) => {
7
if (err) {
8
console.error(
"걸음수 실패:",
"code:", err.code,
"message:", err.message
);
9
} else {
10
console.log(
"걸음수 데이터 OK:",
data.result
);
11
}
12
});
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 | |
|---|---|---|---|---|
| fromDate | 필수 | 시작일(부터). yyyyMMdd | ||
| toDate | 필수 | 종료일(까지). yyyyMMdd. 시작일이 종료일보다 뒤면 SDK 가 바로 VALIDATION 오류를 돌려줍니다 | ||
건강데이터 엑섹스 하려면 사용자가 최초 한번은 시스템 권한이 승인되어야 합니다. Android 는 권한을 거부하면 err.code=-7000 을 돌려줍니다. iOS 는 거부 여부를 앱에 알려 주지 않아 보통 빈 배열 [] 로 성공합니다.
Response 항목 정의
| Response 결과값 | |
|---|---|
| data.result |
[ { date: "2025-01-01", step: 1210 }, { date: "2025-01-02", step: 4290 }, ..... ] 날짜는 문자열(yyyy-MM-dd, 한국 시간). 기록이 없는 날은 빠지고, Android 는 순서를 보장하지 않습니다
|
| err.code | 에러코드 (-7000 : 권한 없음(Android), -7001 : 지원 안 하는 기기, -7002 : Health Connect 미설치(Android), -2000, -2001, -3001 : 날짜 빠짐, 형식 오류, -8000 : 시간 초과(Android 15초)) |
| err.message | 에러 메시지 |