걸음수 가져오기 | 날짜, 위치, 건강 데이터 | 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 에러 메시지





www.naver.com
QR 코드를 촬영하면 입력하신 주소의
앱 예시 화면을 테스트할 수 있습니다.
* 스캔 후 바로 앱 다운로드 이동합니다.