Health | Appbox iOS SDK 가이드
Health
Health runtime 확인
Health runtime 확인
AppBox.isHealthAvailable() -> Bool
Swift
1
guard AppBox.isHealthAvailable() else {
2
return
3
}
1
if (![AppBox isHealthAvailable]) {
2
return;
3
}
Request 항목 정의
Response 항목 정의
| Response 결과값 | |
|---|---|
Bool | Health runtime 포함 여부. 즉시 반환됩니다 |
true는 HealthKit 권한 허용 상태를 의미하지 않습니다. HealthKit capability와 NSHealthShareUsageDescription을 별도로 설정합니다. 실제 호출 전 AppBoxInitResult.health.status도 확인합니다.
걸음 수 조회
걸음 수 조회
AppBox.getHealthSteps(fromDate: String, toDate: String, completion: @escaping ([AppBoxDailyStep]?, NSError?) -> Void)
Swift
1
AppBox.getHealthSteps(
2
fromDate: "2026-07-01",
3
toDate: "2026-07-07"
4
) { steps, error in
5
if let error {
6
let code = AppBoxHealthErrorCode(rawValue: error.code) ?? .unknown
7
handleHealthError(code)
8
return
9
}
10
11
for item in steps ?? [] {
12
showSteps(date: item.date, step: item.step)
13
}
14
}
1
[AppBox getHealthStepsFromDate:@"2026-07-01"
2
toDate:@"2026-07-07"
3
completion:^(NSArray<AppBoxDailyStep *> *steps, NSError *error) {
4
if (error != nil) {
5
AppBoxHealthErrorCode code = (AppBoxHealthErrorCode)error.code;
6
[self handleHealthError:code];
7
return;
8
}
9
10
for (AppBoxDailyStep *item in steps ?: @[]) {
11
[self showStepsWithDate:item.date step:item.step];
12
}
13
}];
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
fromDate | 필수 | 조회 시작일. yyyy-MM-dd 형식 | - |
toDate | 필수 | 조회 종료일. yyyy-MM-dd 형식 | - |
completion | 필수 | 조회 결과 callback | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
steps | 날짜 오름차순의 AppBoxDailyStep 배열 |
steps[].date | 일자 문자열 |
steps[].step | 해당 일자의 걸음 수 |
error | 날짜, 권한, 기능 지원 또는 HealthKit 조회 실패 원인 |
별도의 Health 권한 요청 함수는 없습니다. 이 함수가 필요한 읽기 권한을 요청합니다.
- 앱 시작 직후가 아니라 사용자가 걸음 수 기능을 선택한 화면에서 호출합니다.
- 시작일과 종료일을 포함하며 기록이 없는 날짜는 0으로 채우지 않고 배열에서 빠집니다.
- 조회 범위는 기기 local time zone으로 해석하지만 반환 날짜 key는 KST를 사용합니다. UTC+9보다 동쪽인 기기에서는 반환 날짜가 하루 앞당겨질 수 있습니다.
- 오류 domain은
kr.co.mobpa.appbox.health입니다. - 건강 데이터는 필요한 기간만 조회하고 로그나 분석 도구에 기록하지 않습니다.