앱 개발

걸음 수 기능, 안드로이드와 iOS에서 어디서 가져오나

걸음 수 기능, 안드로이드와 iOS에서 어디서 가져오나

걸음 수 기능, 안드로이드와 iOS에서 어디서 가져오나

안드로이드 걸음 센서 값은 재부팅하면 0이 되고, Recording API는 10일, iOS CMPedometer는 7일까지만 기록을 남깁니다. 걸음 수 기능을 기획할 때 플랫폼별 데이터 출처를 고르는 기준과 보관 기간 차이를 다룹니다.

안드로이드 걸음 센서 값은 재부팅하면 0이 되고, Recording API는 10일, iOS CMPedometer는 7일까지만 기록을 남깁니다. 걸음 수 기능을 기획할 때 플랫폼별 데이터 출처를 고르는 기준과 보관 기간 차이를 다룹니다.

7분 소요

7분 소요

기획서에 "오늘 걸음 수 표시"라고 한 줄 적으면 개발자는 바로 되묻습니다. 휴대폰 센서에서 직접 셀지, 운영체제가 모아 둔 기록을 읽을지, 삼성 헬스나 애플워치 기록까지 합칠지에 따라 쓰는 기술이 다르고, 지난 기록을 며칠까지 볼 수 있는지도 달라지기 때문입니다. 안드로이드는 세 가지, iOS는 두 가지 길이 있고 각각 공식 문서에 적힌 제약이 분명합니다.

걸음 수 기능, 안드로이드와 iOS에서 어디서 가져오나 대표 이미지

안드로이드에는 길이 세 개 있습니다

첫째는 휴대폰 안의 걸음 센서를 앱이 직접 읽는 방법입니다. 안드로이드 4.4(API 19)부터 있는 `TYPE_STEP_COUNTER` 센서는 휴대폰을 마지막으로 켠 뒤부터 쌓인 걸음 수를 돌려줍니다. 오늘 0시 기준 값이 아니라 부팅 이후 누적 값이라서, 앱이 자정 무렵의 값을 따로 저장해 두고 빼야 오늘 걸음 수가 나옵니다. 휴대폰을 껐다 켜면 0부터 다시 시작하니 이것도 앱이 처리해야 합니다. 안드로이드 센서 문서에는 앱이 센서 등록을 유지하고 있어야만 걸음을 센다고 적혀 있습니다.

둘째는 Recording API on mobile입니다. 구글이 Google Fit 대신 내놓은 기록 기능으로, 구글 계정 로그인 없이 휴대폰 안에 걸음 수를 기록해 줍니다. 앱이 "기록 시작"을 요청한 시점부터 쌓이고, 최대 10일치만 남습니다. 기록을 해제하면 모아 둔 데이터도 읽을 수 없게 됩니다. 그래서 문서는 주기적으로 값을 가져가 앱 서버에 저장하는 방식을 예로 듭니다.

셋째는 헬스 커넥트입니다. 여러 건강 앱과 기기의 기록을 한곳에 모아 두는 안드로이드의 건강 데이터 저장소입니다. 안드로이드 14부터 운영체제에 들어 있고, 13 이하에서는 사용자가 플레이 스토어에서 헬스 커넥트 앱을 설치해야 합니다. 그 앱도 안드로이드 9 이상에서만 돌아갑니다. 다른 건강 앱이나 웨어러블 앱이 헬스 커넥트에 넣어 둔 걸음 수까지 받을 수 있다는 점이 다른 두 방법과의 차이입니다.

안드로이드 걸음 수 출처 비교
걸음 센서
  • 재부팅 후 누적 값
  • 앱이 기준값 저장
  • 다른 앱 기록 못 받음
Recording API
  • 최대 10일 보관
  • 구글 계정 불필요
  • 기록 시작 이후만
헬스 커넥트
  • 권한 받기 전 30일까지
  • 다른 앱, 기기 기록 포함
  • 13 이하는 앱 설치 필요

세 방법 모두 안드로이드 10부터는 `ACTIVITY_RECOGNITION`(신체 활동) 권한을 사용자에게 받아야 합니다. 안드로이드 10 변경 사항 문서를 보면 기본 센서 가운데 이 권한이 필요한 것은 걸음 센서 두 종류뿐입니다. 헬스 커넥트는 여기에 더해 걸음 수 읽기 권한(`READ_STEPS`)을 헬스 커넥트 화면에서 따로 받습니다.

Google Fit으로 만든 앱은 옮겨야 합니다

몇 년 전에 만든 건강 앱이라면 안드로이드 걸음 수를 Google Fit API로 받고 있을 가능성이 높습니다. 구글 지원 종료 안내에 따르면 2024년 5월 1일부터 새 개발자는 Google Fit API를 신청할 수 없고, 서버에서 쓰던 Fit REST API까지 포함해 2026년에 지원이 끝납니다. REST API는 같은 기능의 대체품이 없다고 문서에 적혀 있습니다. 서버가 구글 계정으로 사용자 걸음 수를 직접 가져가던 구조라면 앱이 헬스 커넥트나 Recording API에서 읽어 서버로 올리는 구조로 바꿔야 합니다.

유지보수 중인 앱의 개선 범위를 정할 때 이 항목이 빠져 있으면, 어느 날 안드로이드 걸음 수만 0으로 나오는 문의를 받게 됩니다.

iOS에는 길이 두 개 있습니다

첫째는 Core Motion의 CMPedometer입니다. 아이폰이 움직임 센서로 센 걸음 수를 앱이 읽습니다. 별도 설정 없이 바로 쓸 수 있지만, 시스템이 보관하는 기록은 최근 7일치뿐입니다. 8일 전 기록을 요청하면 남아 있는 범위만 돌아옵니다. 앱 설정 파일에 동작 기록을 쓰는 이유 문구(`NSMotionUsageDescription`)가 없으면 이 기능을 호출하는 순간 앱이 종료됩니다.

둘째는 HealthKit입니다. 아이폰 건강 앱에 쌓인 기록을 읽는 방법으로, 아이폰 자체 기록과 애플워치, 다른 운동 앱이 넣은 기록이 모두 들어 있습니다. 걸음 수를 하루 단위로 합칠 때는 원본 기록을 직접 더하지 않고 통계 쿼리를 쓰는데, 이 부분은 걸음 수가 건강 앱과 다르게 나오는 이유 글에서 따로 다룹니다.

구분 CMPedometer HealthKit
데이터 범위 아이폰이 직접 센 걸음 아이폰, 애플워치, 다른 앱 기록
지난 기록 최근 7일 건강 앱에 남아 있는 기간
권한 문구 NSMotionUsageDescription NSHealthShareUsageDescription
권한 거부 확인 상태 확인 가능 읽기 거부 여부를 앱이 알 수 없음

마지막 줄이 기획에 영향이 큽니다. HealthKit은 사용자가 읽기 권한을 거부했는지 앱에 알려 주지 않습니다. 애플 개인정보 보호 문서에 따르면 거부한 경우에도 앱에는 데이터가 없는 것처럼 보입니다. "권한이 꺼져 있어요" 안내 화면을 정확히 띄울 수 없으니, 걸음 수가 0으로 나올 때 건강 앱 설정을 확인해 보라는 안내를 넣는 식으로 기획합니다.

실제 앱은 두 가지를 섞어 씁니다

출시되는 걸음 수 앱은 한 가지 출처만 쓰는 경우가 드뭅니다. 안드로이드에서 헬스 커넥트를 기본으로 쓰더라도 빈틈이 있기 때문입니다.

헬스 커넥트가 휴대폰 자체 걸음 수를 직접 기록하는 기능은 안드로이드 14 이상, 그중에서도 시스템 확장 버전 20 이상인 기기에서만 동작합니다. 안드로이드 13 이하 휴대폰에서는 다른 운동 앱이나 웨어러블 앱이 헬스 커넥트에 기록을 넣어 주지 않으면 걸음 수가 비어 있습니다. 운동 앱을 하나도 쓰지 않는 사용자라면 권한을 다 받아도 0보가 나옵니다. 이런 기기에서는 Recording API로 휴대폰 걸음을 따로 기록해 채웁니다. Recording API 문서도 13 이하 사용자에게는 헬스 커넥트와 함께 쓰는 방법을 안내합니다.

iOS에서는 지난 기록과 하루 합계는 HealthKit에서 읽고, 앱 화면을 보고 있는 동안 숫자가 올라가는 모습은 CMPedometer의 실시간 갱신 기능으로 보여 주는 조합을 자주 씁니다. 두 값을 섞으면 숫자가 잠깐 튀어 보일 수 있으니, 화면을 닫았다 열 때 어느 값으로 맞출지를 기획서에 적어 둡니다.

헬스 커넥트 쪽에서는 앱이 먼저 이 기기에서 헬스 커넥트를 쓸 수 있는지 확인합니다. 쓸 수 없는 상태라면 플레이 스토어 설치 화면으로 보내는 안내가 필요하고, 이 안내 화면이 기획서에 없으면 개발 중에 추가 화면으로 다시 잡히게 됩니다.

기획 단계에서 정할 순서

출처를 고르는 기준은 기술보다 서비스 정책에서 나옵니다. 저희는 상담할 때 아래 순서로 묻습니다.

걸음 수 출처를 정하는 순서
  1. 워치 기록 포함 여부포함하면 헬스 커넥트와 HealthKit
  2. 필요한 지난 기록 기간7일, 10일, 30일 제약 확인
  3. 지원할 최소 OS안드로이드 13 이하 비율 확인
  4. 서버 저장 시점보관 기간 안에 서버로 올리기
  • 워치 기록 포함 여부: 걸음 수 미션 앱 사용자 중에는 휴대폰을 책상에 두고 워치만 차고 걷는 사람이 있습니다. 이 걸음을 인정하려면 휴대폰 센서만으로는 안 됩니다.
  • 지난 기록 기간: 가입 전 한 달 걸음 수로 등급을 매기는 기획이라면 헬스 커넥트의 30일 제한과 CMPedometer의 7일 제한에 걸립니다.
  • 최소 OS: 안드로이드 13 이하 사용자가 많은 서비스라면 헬스 커넥트 앱 설치 안내 화면이 추가됩니다.
  • 서버 저장 시점: 기기 안 기록은 기간이 지나면 사라지니, 포인트나 랭킹처럼 근거가 남아야 하는 기능은 그 전에 서버에 저장해야 합니다.

건강 데이터를 여러 곳에서 받는 앱의 외주 범위를 나누는 방법은 헬스케어 앱 외주 개발 글에, 저희가 만든 건강관리 앱 사례는 헬스케어 앱 개발 페이지에 있습니다.

자주 묻는 질문

안드로이드와 iOS 걸음 수를 같은 기준으로 맞출 수 있나요?

완전히 같게는 어렵습니다. 기기마다 센서 성능이 다르고, 워치 기록을 합치는 규칙도 플랫폼마다 다릅니다. 대신 하루를 나누는 기준 시각과 서버에 저장하는 시점, 중복 처리 방식을 두 플랫폼에서 똑같이 정해 두면 사용자 문의를 줄일 수 있습니다.

앱을 처음 설치한 날, 이전 걸음 수도 보여 줄 수 있나요?

출처에 따라 다릅니다. HealthKit과 헬스 커넥트는 설치 전에 쌓인 기록을 읽을 수 있지만 헬스 커넥트는 기본적으로 권한을 처음 받은 날 기준 30일 전까지입니다. CMPedometer는 7일, Recording API는 기록을 시작한 뒤부터라 설치 이전 기록이 없습니다.

삼성 헬스 걸음 수도 받을 수 있나요?

삼성은 삼성 헬스 앱의 데이터를 읽는 Samsung Health Data SDK를 따로 제공하고, 걸음 수가 읽기 항목에 들어 있습니다. 갤럭시 워치 기록은 짝지어 둔 휴대폰의 삼성 헬스 앱으로 옮겨진다고 문서에 적혀 있습니다. 헬스 커넥트와는 별개의 연동이라 개발 범위와 이용 절차를 따로 확인해야 합니다.

앱 개발이 고민되시나요?
앱 개발이 고민되시나요?

기획부터 출시까지, 모바일파트너스가 함께합니다

다른 아티클 살펴보기

다른 아티클 살펴보기

다른 아티클 살펴보기