> ## Documentation Index
> Fetch the complete documentation index at: https://docs.habitify.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Health Connect

Health Connect는 이미 사용 중인 앱과 기기(시계, 피트니스 앱, 수면 추적기)의 건강 및 피트니스 데이터를 한곳에 모아 관리하는 Google의 플랫폼입니다.

Habitify를 Health Connect에 연결하면 추적을 자동화할 수 있습니다. 걸음 수나 수면 같은 습관을 직접 체크하는 대신, Habitify가 다른 앱과 기기에서 이미 기록 중인 데이터를 읽어 진행 상황을 대신 기록합니다.

## Health Connect와 동기화되는 습관 추가하기

[https://drive.google.com/file/d/1oP2yN1sxBiho9PIVNXX-foM2swvoxlek/preview](https://drive.google.com/file/d/1oP2yN1sxBiho9PIVNXX-foM2swvoxlek/preview)

1. **일지**에서 화면 오른쪽 아래 날짜 표시줄의 \*\*+\*\*를 탭합니다.
2. **새로운 습관 생성** 또는 **나쁜 습관 없애기**를 선택합니다.
3. 습관 템플릿 화면 상단의 탭 중에서 **Health Connect**를 탭합니다.
4. Habitify가 Health Connect에서 가져올 수 있는 모든 활동 및 데이터 유형 목록에서 원하는 데이터 옵션 하나를 탭하여 선택합니다.
5. **접근 허용**을 탭합니다.\
   다음 화면의 **Habitify의 읽기 허용** 섹션에서 토글 버튼을 **켠** 다음 아래의 **허용** 버튼을 탭합니다.
6. 권한을 허용한 후 **게속** 버튼을 탭합니다.
7. 평소처럼 습관의 세부 정보를 설정하고 원하는 경우 목표를 조정합니다.
8. 모든 설정을 마치면 오른쪽 위 모서리의 **저장** 버튼을 탭합니다.

습관을 만들고 나면 Health Connect에 연결된 습관을 쉽게 알아볼 수 있습니다. 일지의 일 보기에서 작은 Health Connect 아이콘이 표시되므로 직접 추적하는 습관과 한눈에 구분됩니다.

## 작동 방식

습관이 연결되면 매일의 작동 방식은 간단합니다.

* Health Connect 데이터가 Habitify에 자동으로 동기화됩니다. 기록된 값이 습관의 목표에 도달하면 Habitify가 습관을 **완료됨**으로 표시하므로 좋은 습관을 직접 체크인할 필요가 없습니다.
* 동기화된 데이터로는 포착할 수 없는 내용을 기록하고 싶다면, 해당 날짜의 습관을 직접 **건너뜀** 또는 **실패**로 표시할 수도 있습니다.
* **단방향 동기화만 지원합니다.** 데이터는 Health Connect에서 Habitify로만 이동합니다.

## 자주 묻는 질문

> [accordion] **Health Connect의 칼로리 데이터가 제대로 동기화되지 않습니다. 어떻게 해야 하나요?**
>
> Health Connect 카테고리에서 습관을 만들거나 편집하면 칼로리와 관련된 세 가지 옵션 중 하나를 선택하라는 메시지가 표시됩니다. 각 옵션이 기기에 요청하는 데이터는 다음과 같습니다.
>
> 1. **"에너지 섭취량" - 섭취한 양:** 영양 섭취 칼로리(먹은 칼로리)를 동기화합니다. 식사 추적, 식단 목표 유지 또는 칼로리 적자/잉여 루틴 모니터링에 가장 적합합니다.
>
> 2. **"칼로리 소모하기" - 운동 중 소모한 양:** 활동 칼로리 소모량(신체 활동만)을 동기화합니다. 일일 운동, 운동 꾸준함, 활동량 목표를 추적하는 데 가장 적합합니다.
>
> 3. **"칼로리 추적하기" - 총소모량:** 총칼로리 소모량(활동량 + 기초 대사량)을 동기화합니다. 체중을 관리하거나 전반적인 신진대사를 추적하기 위해 일일 총에너지 소비량(TDEE)을 모니터링하는 데 가장 적합합니다.
>
> 동기화된 진행 상황이 잘못 표시된다면(예: 음식 섭취량을 추적하려 했지만 "칼로리 추적하기"를 선택한 경우), 목표에 맞는 올바른 옵션을 선택하여 새 습관을 만드는 것이 좋습니다.

> [accordion] **Habitify에 Health Connect 데이터가 중복으로 표시됩니다. 어떻게 해야 하나요?**
>
> Health Connect는 공유 데이터 계층이므로 휴대전화의 여러 앱이 데이터를 쓸 수 있습니다. 두 앱이 같은 유형의 데이터(예: 수면)를 모두 기록하면, 같은 날 밤의 기록이라도 Health Connect는 이를 **별도의 기록**으로 저장합니다.
>
> Android 기기에서 다음 두 항목이 동시에 활성화되어 있을 때 가장 흔하게 발생합니다.
>
> * **Google Fit**
> * **기기 자체에 내장된 건강/피트니스 추적 기능**(휴대전화 제조사에 따라 다르며 기본적으로 켜져 있는 경우가 많음)
>
> Health Connect 자체 요약 화면에서는 이러한 항목을 하나로 병합해 표시하기도 하므로 중복을 확인하기 어려울 수 있습니다. 하지만 Habitify는 원본 기록을 읽기 때문에 두 기록을 모두 가져옵니다.
>
> **해결 방법**
>
> 1. Android 기기에서 **설정 → Health Connect → 앱 권한**을 엽니다.
> 2. 앱 목록을 살펴보고 중복되는 데이터 유형(예: 수면)에 **쓰기 권한**이 있는 앱을 찾습니다.
> 3. 같은 데이터 유형에 대한 쓰기 권한을 가진 앱이 둘 이상이면 그중 하나의 쓰기 권한을 끕니다. Google Fit이 포함되어 있다면 Google Fit을 비활성화하는 것이 좋습니다. 이는 많은 기기에서 더 이상 필요하지 않은 기존 연동 방식이기 때문입니다.
> 4. 한 번의 동기화 주기가 지날 때까지 기다린 다음 Habitify를 다시 확인합니다. 수정하기 전에 생성된 기존 중복 항목은 소급하여 병합되지 않지만, 이후에 생성되는 새 항목은 중복 없이 기록됩니다.

> [accordion] **Habitify가 Health Connect의 데이터를 동기화하지 않습니다. 어떻게 해야 하나요?**
>
> Health Connect 권한은 앱 단위뿐 아니라 **데이터 유형별**로 부여됩니다. 원본 앱(예: Google Health에 데이터를 전송하는 Withings)을 연결했다고 해서 Habitify가 해당 앱의 모든 데이터 유형에 자동으로 접근할 수 있는 것은 아닙니다. 한 데이터 유형(예: 걸음 수)은 승인되었지만 다른 유형(예: 체중)은 승인되지 않은 경우가 흔합니다.
>
> **해결 방법**
>
> 1. **설정 → Health Connect → Habitify**를 엽니다(앱 권한 아래).
> 2. Habitify가 접근할 수 있는 데이터 유형 목록을 확인합니다.
> 3. 습관이 추적하는 특정 데이터 유형(예: **체중**, **수면**, **걸음 수**)의 토글이 명확하게 **켜져** 있는지 확인합니다.
> 4. 꺼져 있었다면 켠 다음 Habitify를 다시 열어 새 동기화를 시작합니다.

> [accordion] **Health Connect의 걸음 수가 Habitify에 다른 값으로 동기화되는 이유는 무엇인가요?**
>
> 일반적으로 **Health Connect**가 휴대전화의 여러 앱이나 하드웨어 소스(예: Google Fit, Samsung Health, 스마트워치 앱, 휴대전화 내장 만보기)에서 걸음 수 데이터를 동시에 수신할 때 발생합니다. 우선순위가 지정된 기본 소스 없이 Health Connect가 이러한 항목을 결합하면 Habitify에 두 배로 집계된 걸음 수를 전송할 수 있습니다.
>
> **해결 방법:**
>
> Android의 Health Connect 설정에서 걸음 수 데이터의 기본 소스를 하나로 지정하면 해결할 수 있습니다.
>
> 1. Android 기기의 **설정** 앱을 엽니다.
> 2. **Health Connect**를 검색하여 선택합니다.
> 3. **데이터 및 액세스**(또는 **데이터 관리**)를 탭합니다.
> 4. **데이터 소스 및 우선순위**를 선택합니다.
> 5. **활동**을 탭한 다음 **걸음 수**를 선택합니다.
> 6. **앱 소스** 아래의 목록을 확인합니다.
>    * **소스 순서 변경:** 기본 걸음 수 추적기(예: Samsung Health 또는 Google Fit)를 목록 맨 위로 끌어 Health Connect에서 우선하도록 설정합니다.
>
>    * **중복 소스 제거:** 걸음 수 합계에 포함하지 않을 보조 앱을 끄거나 제거합니다.
>
> > ***참고:***\_ Health Connect에서 소스 우선순위를 업데이트한 후 수정된 걸음 수가 Habitify에 동기화되기까지 잠시 걸릴 수 있습니다.\_


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.