“添加到 Apple 钱包与健康”指南

验证是不是至少装有能保证兼容性的最低 iOS 版本

验证用户的设备是不是 iPhone，而且至少装有支持你所实现框架的最低 iOS 版本。如果设备装有的 iOS 版本不支持你所实现的框架，则这项功能不能在该设备上使用。此外，这项功能也不能在 iPad 上使用。

对于 SMART Health Cards 框架，受支持的最低版本为 iOS 15.1。对于 EU Digital COVID Certificate 框架，受支持的最低版本为 iOS 15.4。请实施以下检查以确保兼容性：

• iOS App：使用 HKHealthStore.isHealthDataAvailable 检查 HealthKit 可用性，并使用 NSProcessInfo.operatingSystemVersion 检查 iOS 版本。
• 网页：查看浏览器用户代理。例如，“Mozilla/5.0 (iPhone; CPU iPhone OS 15_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko)”就是用于此类设备的一个用户代理。
• 电子邮件：
  • SMART Health Cards 框架：在“添加到 Apple 钱包和健康”按钮的旁边，告诉用户，这个按钮只能在运行 iOS 15.1 或更高版本的设备上使用。
  • 对于 EU Digital COVID Certificate 框架：在“添加到 Apple 钱包和健康”按钮的旁边，告诉用户，这个按钮只能在运行 iOS 15.4 或更高版本的设备上使用。

转换二维码 URL

要在 App、网页或电子邮件中实现“添加到 Apple 钱包与健康”按钮，请转换每个唯一二维码的 URL，并将其作为“添加到 Apple 钱包与健康”按钮的 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 将自动识别的直接链接进行调用，以提示用户将疫苗接种记录添加到“健康”并在“钱包”中创建疫苗接种卡。验证你是否可以在相应 App、网页或电子邮件中轻点此按钮。

本地化

仅使用 Apple 提供的本地化图案。请勿自行创建本地化版本。对于这项功能得到了当地医疗保健机构支持的地区，Apple 将为其提供按钮的本地化版本。

提及 Apple App

名称 Apple 钱包 (Apple Wallet) 或钱包 (Wallet) 的使用准则

• 在标题或文案中使用名称Wallet 或 Apple Wallet 时，务必以大写字母 W 后跟小写字母的形式来排印“Wallet”。而提及 Apple 时，请使用大写字母 A 后跟小写字母的形式。Apple Wallet 应设为两个单词。
• 如果标题排印为全大写字母形式，则标题内的 Apple Wallet 也可以采用全大写字母形式。
• 首次提到“钱包”App 时，你可以将它称为“Apple 的‘钱包’App”或“Apple 钱包”。后文中提到时，可简称其为“钱包”。
• 在美国的宣传材料中，正文中首次提到 Apple 时，请加上注册商标符号 (®)。

名称 Apple 健康 (Apple Health) 或健康 (Health) 的使用准则

• 你可以提及 Apple 健康 App 或 Apple 的健康 App。首次提到之后，接下来就可称其为健康 App。提及 Apple 时请使用大写字母 A 后跟小写字母的形式；而 Health 则应使用大写字母 H 后跟小写字母的形式。
• 请勿提及 Apple 健康数据。健康数据属于用户，而不属于 Apple。