걸음 수 조회 | 걸음 수 | Appbox Android SDK 가이드
걸음 수 조회
걸음 수 조회
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 결과값 | |
|---|---|
steps | List<AppBoxDailyStep>. 날짜 오름차순. 실패 시 null |
steps[].date | 날짜. yyyy-MM-dd |
steps[].step | 해당 날짜의 걸음 수 합계 |
오류: AppBoxHealthException.errorCode
| 코드 | 이 함수에서의 발생 조건 | 사용자 안내 |
|---|---|---|
-2001 | 날짜 형식 오류 | 개발 오류. yyyy-MM-dd 확인 |
-3001 | 시작일이 종료일보다 늦음 | 개발 오류. 기간 확인 |
-5000 | appbox-health 없음 | 기능 메뉴 숨김 |
-7000 | 걸음 수 읽기 권한 거부 | 권한 설정 안내 |
-7001 | Health Connect 미지원 기기 | 기능 사용 불가 안내 |
-7002 | Health Connect 미설치 | 설치 안내 |
-8000 | 조회 처리 실패 | 재시도 안내 |
-9999 | 기타 오류 | 재시도 안내 |
코드 값은 기기 기능 공통 규칙의 코드 표와 같은 체계입니다.
날짜 형식은 yyyy-MM-dd입니다. Push 수신 목록 조회는 yyyyMMdd로 다릅니다.
- 시작일과 종료일을 모두 포함합니다.
- 걸음 기록이 없는 날짜는 결과에 포함되지 않습니다. 빈 목록은 실패가 아닙니다.
- 존재하지 않는 날짜(예:
2026-02-30)는 조회하지 않고 즉시 실패합니다. 이 검증은appbox-health추가 여부와 상관없이 먼저 수행됩니다. - 권한이 없으면 SDK가 안내 다이얼로그를 표시하고 Health Connect 설정 화면으로 이동시킨 뒤, 앱으로 돌아오면 한 번 자동으로 다시 시도합니다. 화면이 없는 상태에서는 호출하지 않습니다.