단축어 및 App Intents
사용 가능한 Intent
섹션 제목: “사용 가능한 Intent”내보내기 프로필
섹션 제목: “내보내기 프로필”Health.md의 iPhone 또는 Android 앱에서 저장된 내보내기 프로필을 만들고 관리할 수 있습니다. Apple 플랫폼의 프로필 관리는 현재 iPhone에 대해서만 문서화되어 있으며, iPad 또는 macOS에서의 사용 가능 여부는 주장하지 않습니다.
네 개의 내보내기 인텐트 모두 선택적 프로필 매개변수를 받습니다. 프로필이 있으면 비워 둘 때 활성 프로필을 사용하고, 프로필이 없는 레거시 모드에서는 앱의 현재 내보내기 설정을 사용합니다. 저장된 프로필 이름을 전달하면 앱이 현재 표시하는 것과 관계없이 해당 프로필의 동결된 구성(지표 선택, 형식, 대상)으로 실행됩니다.
앱에서 첫 내보내기 프로필을 만들면 프로필이 설정되지 않은 단축어는 앱의 현재 설정 대신 활성 프로필의 저장된 설정으로 내보냅니다. 이전 동작에 의존하는 경우 단축어를 특정 프로필에 고정하거나(또는 프로필을 0개로 유지) 명시적으로 유지하세요. 더 이상 존재하지 않는 프로필 이름은 잘못된 내보내기 대신 명확한 오류로 실패합니다.
iOS 또는 macOS에서 단축어 앱을 여세요. + 버튼을 탭해 새 단축어를 만든 다음 "Health.md" 또는 위에 나열된 Intent 제목을 검색하세요. 각 Intent는 건강 카테고리에 있습니다.
대부분의 Intent에는 openAppWhenRun = false가 설정되어 있어 앱을 열거나 UI를 표시하지 않고 백그라운드에서 실행됩니다. 자동화, 집중 모드 필터, ‘Siri야’ 호출 및 동작 버튼에서 사용할 수 있습니다.
Apple은 iPhone이 잠겨 있는 동안 HealthKit 데이터를 보호하며, 잠긴 후 약 10분이 지나면 앱의 접근을 차단합니다. 잠겨 있을 때 실행 허용을 사용하면 단축어가 동작을 시작할 수 있지만 HealthKit 데이터 보호를 우회하지는 않습니다. 단축어의 Health.md 앱 콘텐츠 권한도 이를 우회하지 않습니다.
HealthKit을 사용할 수 없으면 Health.md는 요청된 날짜를 대기 상태로 보존하고 건강 데이터 내보내기에 주의 필요 알림을 보냅니다. iPhone의 잠금을 해제한 다음 알림을 탭하거나 Health.md를 열어 다시 시도하세요. 휴대전화가 잠긴 상태로 유지되는 동안에는 완전 무인 내보내기를 보장할 수 없습니다.
사용법: 완료 확인이 포함된 일일 내보내기
섹션 제목: “사용법: 완료 확인이 포함된 일일 내보내기”- 개인용 자동화 → 특정 시간 → 오전 8:00처럼 잠금 해제된 iPhone을 평소 사용하는 시간을 선택합니다.
- 어제의 건강 데이터 내보내기 Intent를 추가합니다.
- 마지막 내보내기 상태 가져오기 Intent를 추가합니다.
- 결과를 포함하는 알림 표시를 추가합니다.
대기 상태 참고: 마지막 내보내기 상태 가져오기는 가장 최근에 기록된 내보내기 기록 항목을 읽습니다. 이번 실행에서 잠긴 HealthKit 데이터가 감지되면 대기 중인 요청을 재시도할 때까지 이전 내보내기가 계속 표시될 수 있습니다. 대기 중인 작업은 Health.md의 복구 알림으로 가장 확실하게 확인할 수 있습니다.
사용법: 과거 데이터 한 번에 채우기
섹션 제목: “사용법: 과거 데이터 한 번에 채우기”- 단축어를 만듭니다.
- 날짜 범위의 건강 데이터 내보내기에서 시작 = 2024-01-01, 종료 = 2024-12-31로 설정합니다.
- 단축어에서 실행합니다. 1년 전체를 순회하며 하루에 파일 하나를 씁니다. 연간 전체 데이터를 처리하는 데 몇 분이 걸릴 수 있습니다.
사용법: 휴가 중 예약 일시 중지
섹션 제목: “사용법: 휴가 중 예약 일시 중지”- 집중 모드 필터: 휴가 집중 모드가 켜지면 활성화 = false로 설정한 예약된 내보내기 켜기 또는 끄기를 실행합니다.
- 집중 모드가 꺼지면 활성화 = true로 설정해 다시 실행합니다.
Intent는 앱 내 HealthKit 권한과 보관함 선택을 그대로 사용합니다. 이 기기에서 앱을 한 번 이상 열어 설정하지 않았다면 명확한 오류와 함께 실패합니다.