걸음 수 | Appbox Android SDK 가이드

Android SDK 연동

걸음 수 개요

전제내용
필요 artifactappbox-health
기기 전제Health Connect 설치 + 걸음 수 읽기 권한. 상태는 오류 코드로 구분합니다
웹 브릿지 대응health.getStep: 단, 웹은 날짜 형식이 yyyyMMdd로 다릅니다

걸음 수 조회

기간 내 날짜별 걸음 수를 조회합니다. 건강, 챌린지 기능에서 사용자의 활동량을 보여줄 때 사용합니다.

걸음 수 조회

AppBox.getHealthSteps(activity, fromDate, toDate, callback)

Kotlin
1 AppBox.getHealthSteps(this, "2026-07-01", "2026-07-07") { steps, error ->
2 if (error != null) {
3 val code = (error as? AppBoxHealthException)?.errorCode
4 handleHealthError(code)
5 return@getHealthSteps
6 }
7 steps.orEmpty().forEach { day -> render(day.date, day.step) }
8 }
1 AppBox.getHealthSteps(this, "2026-07-01", "2026-07-07",
2 new AppBoxValueCallback<List<AppBoxDailyStep>>() {
3 @Override
4 public void onComplete(List<AppBoxDailyStep> steps, Throwable error) {
5 if (error != null) {
6 Integer code = (error instanceof AppBoxHealthException)
7 ? ((AppBoxHealthException) error).getErrorCode()
8 : null;
9 handleHealthError(code);
10 return;
11 }
12 if (steps == null) return;
13 for (AppBoxDailyStep day : steps) {
14 render(day.getDate(), day.getStep());
15 }
16 }
17 });

Request 항목 정의

Request 항목필수여부설명기본값
activity필수권한 안내 화면을 표시할 foreground Activity. Application context는 쓸 수 없습니다-
fromDate필수시작일. yyyy-MM-dd-
toDate필수종료일. yyyy-MM-dd-
callback필수AppBoxValueCallback<List<AppBoxDailyStep>>-


Response 항목 정의

Response 결과값
stepsList<AppBoxDailyStep>. 날짜 오름차순. 실패 시 null
steps[].date날짜. yyyy-MM-dd
steps[].step해당 날짜의 걸음 수 합계

오류: AppBoxHealthException.errorCode

코드이 함수에서의 발생 조건사용자 안내
-2001날짜 형식 오류개발 오류. yyyy-MM-dd 확인
-3001시작일이 종료일보다 늦음개발 오류. 기간 확인
-5000appbox-health 없음기능 메뉴 숨김
-7000걸음 수 읽기 권한 거부권한 설정 안내
-7001Health Connect 미지원 기기기능 사용 불가 안내
-7002Health Connect 미설치설치 안내
-8000조회 처리 실패재시도 안내
-9999기타 오류재시도 안내

코드 값은 기기 기능 공통 규칙의 코드 표와 같은 체계입니다.

날짜 형식은 yyyy-MM-dd입니다. Push 수신 목록 조회는 yyyyMMdd로 다릅니다.

  • 시작일과 종료일을 모두 포함합니다.
  • 걸음 기록이 없는 날짜는 결과에 포함되지 않습니다. 빈 목록은 실패가 아닙니다.
  • 존재하지 않는 날짜(예: 2026-02-30)는 조회하지 않고 즉시 실패합니다. 이 검증은 appbox-health 추가 여부와 상관없이 먼저 수행됩니다.
  • 권한이 없으면 SDK가 안내 다이얼로그를 표시하고 Health Connect 설정 화면으로 이동시킨 뒤, 앱으로 돌아오면 한 번 자동으로 다시 시도합니다. 화면이 없는 상태에서는 호출하지 않습니다.
www.naver.com
QR 코드를 촬영하면 입력하신 주소의
앱 예시 화면을 테스트할 수 있습니다.
* 스캔 후 바로 앱 다운로드 이동합니다.