Apple 지갑 및 건강 앱에 추가하기 지침

최소 iOS 호환성 확인하기

사용자의 기기가 구현된 프레임워크를 지원하는 최소 iOS 버전이 설치된 iPhone인지 확인합니다. 이 기능은 구현된 프레임워크를 지원하지 않는 iOS 버전이 설치된 기기 또는 iPad에서는 작동하지 않습니다.

SMART Health Cards 프레임워크의 경우 지원되는 최소 버전은 iOS 15.1이고, EU Digital COVID Certificate 프레임워크의 경우 지원되는 최소 버전은 iOS 15.4입니다. 호환성을 보장하기 위해 다음 확인 절차를 구현하십시오.

• iOS 앱: HKHealthStore.isHealthDataAvailable을 사용하여 HealthKit 사용 가능 여부를 확인하고 NSProcessInfo.operatingSystemVersion을 사용하여 iOS 버전을 확인합니다.
• 웹 페이지: 브라우저 사용자 에이전트를 확인합니다. 이 기기 유형에 대한 사용자 에이전트의 예는 Mozilla/5.0(iPhone; CPU iPhone OS 15_1(예: Mac OS X)) AppleWebKit/605.1.15(KHTML(예: Gecko)) 등입니다.
• 이메일:
• SMART Health Cards 프레임워크: iOS 15.1 이후 버전을 실행하는 기기에서만 버튼이 작동됨을 알리는 문구를 Apple 지갑 및 건강 앱에 추가하기 버튼 근처에 배치합니다.
• EU Digital COVID Certificate 프레임워크: iOS 15.4 이후 버전을 실행하는 기기에서만 버튼이 작동됨을 알리는 문구를 Apple 지갑 및 건강 앱에 추가하기 버튼 근처에 배치합니다.

QR 코드 URL 변환하기

앱, 웹 페이지 또는 이메일에 Apple 지갑 및 건강 앱에 추가하기 버튼을 구현하려면 고유한 QR 코드 각각에 맞게 URL을 변환하고 이를 지갑 및 건강 앱에 추가 버튼의 URL로 포함합니다.

SMART Health Cards 프레임워크
맨 앞의 shc:/를 https://redirect.health.apple.com/SMARTHealthCard/#로 대체합니다. shc:/ 이후의 긴 숫자 문자열에는 백신 접종 기록 데이터가 포함되므로 이 과정을 진행하는 동안 해당 문자열이 수정 또는 변경되어서는 안 됩니다.

EU Digital COVID Certificate 프레임워크
맨 앞의 HC1:을 https://redirect.health.apple.com/EU-DCC/#으로 대체합니다. HC1: 이후의 긴 영숫자 문자열은 URL로 인코딩되고(참고: https://www.rfc-editor.org/rfc/rfc3986#section-3.5) 추가되어야 합니다.

변환된 URL 확인하기

Apple 지갑 및 건강 앱에 추가하기 버튼은 변환된 URL을 iOS가 자동으로 인식하는 직접 링크로 호출하여 사용자에게 건강 앱에 백신 접종 기록을 추가하고 지갑 앱에서 백신 접종 카드를 생성하라는 메시지를 표시해야 합니다. 해당 앱, 웹 페이지 또는 이메일에서 버튼을 탭할 수 있는지 확인합니다.

현지화

Apple이 제공한 현지화된 아트워크만 사용하십시오. 현지화된 버전을 자체 제작하지 마십시오. Apple은 현지 의료 기관에서 이 기능을 지원하는 지역에 대해 현지화된 버전의 버튼을 제공합니다.

Apple 앱 지칭하기

Apple 지갑 또는 지갑이라는 이름 사용하기

• 헤드라인이나 문구에서 Apple 지갑 또는 지갑이라는 현지화된 명칭을 사용합니다. Apple의 A는 항상 대문자로 표기하고 A 다음 철자는 모두 소문자로 표기합니다. Apple 지갑은 두 단어로 적어야 합니다.
• 헤드라인에 모두 대문자를 사용해야 하는 경우 헤드라인에 포함된 Apple 지갑을 모두 대문자로 표기할 수 있습니다.
• 앱을 처음 언급할 때는 Apple의 지갑 앱 또는 Apple 지갑으로 지칭하고, 그 다음부터는 지갑만 사용해도 됩니다.
• 미국 내 커뮤니케이션의 경우 광고 문구에서 Apple을 처음 지칭할 때는 등록 상표 기호(®)를 사용합니다.

Apple 건강 또는 건강이라는 이름 사용하기

• Apple 건강 앱 또는 Apple의 건강 앱을 지칭할 수 있습니다. 첫 번째 언급 후에는 건강 앱이라고 지칭할 수 있습니다. Apple의 A는 대문자로 표기하고 이후 문자는 모두 소문자로 표기하며, 건강(Health)의 H는 대문자로 표기하고 이후 문자는 모두 소문자로 표기합니다.
• Apple 건강 데이터라고 지칭하지 마십시오. 건강 데이터는 Apple이 아닌 사용자의 소유입니다.