为手机应用配置表盘推送

对于规范市场，手机应用是用户与应用互动的主要方式。

设置表盘

当用户在手机应用中选择表盘时，后续设置表盘的流程分为两部分：

1. 安装：使用通过 MessageClient 启动的表盘推送功能安装表盘。此步骤非常简单，可以使用 addWatchFace 或 updateWatchFace，通过手机上的 MessageClient 触发。
2. 激活： 将已安装的表盘主题设为当前表盘主题。此步骤有多种可能的路径，具体取决于权限状态：
   • 您可能无需执行任何操作。应用商店可能已控制当前表盘主题。
   • 无需用户干预。应用拥有设置有效表盘主题的必要权限，可以直接使用 setWatchFaceAsActive() 进行设置。
   • 可能需要提供指导，说明如何接受权限请求，或者如何使用长按手势或通过配套应用手动设置表盘主题。

安装响应

为了方便 激活阶段，安装阶段应将以下信息从手表返回到手机：

• 安装尝试的结果
• isWatchFaceActive() 的结果 - 用于确定应用是否已拥有当前表盘。
• setWatchFaceAsActive() 是否已在过去被调用过 - Wear OS 应用应在本地跟踪并持久保存此信息。此 API 调用只能使用一次。

启用

安装完成后，响应可能会表明应用已具有有效的表盘。不过，如果不支持，应用可以选择显示一个用于将表盘主题设为当前表盘主题的按钮。

情形 1：设置当前表盘主题的所有尝试均已用尽

如果安装的响应表明之前已调用过 setWatchFaceAsActive()，则该按钮应引导用户前往手机上的指导界面，向用户展示如何触摸并按住表盘，以手动将其设置为所需的主题。

场景 2 - 尝试设置当前表盘主题

手机应指示手表检查必要的 SET_PUSHED_WATCH_FACE_AS_ACTIVE 权限：

• 如果用户已授予该权限，请继续调用 setWatchFaceAsActive()。
• 如果用户之前拒绝了该权限，手表应将此情况传回手机，以便在手机上显示说明界面，说明需要该权限的原因以及如何手动授予该权限。

• 如果之前未请求过该权限，手表应指示手机显示一个教育时刻，引导用户了解如何在手表上接受权限，然后手表应继续请求该权限。

  • 如果用户授予权限，手表应随后调用 setWatchFaceAsActive()。
  • 否则，手表应指示手机显示一个教育屏幕，说明需要该权限的原因以及如何手动授予该权限。