配置手机应用以进行表盘推送

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

设置表盘

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

  1. 安装：使用表盘推送安装表盘，通过 MessageClient 启动。此步骤很简单，使用 addWatchFace 或 updateWatchFace，由手机通过 MessageClient 触发到手表。
  2. 激活：将已安装的表盘设置为活动状态。此步骤有几种可能的路径，具体取决于权限状态
    • 可能无需任何操作。市场可能已经控制了活动表盘。
    • 可能无需用户干预。应用具有设置活动表盘所需的权限，并且可以使用 setWatchFaceAsActive() 直接进行设置。
    • 可能需要指导，无论是关于如何接受权限请求，还是如何通过长按手势或通过配套应用手动设置表盘。

安装响应

为便于激活阶段，安装阶段应从手表向手机返回以下信息

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

激活

安装后，响应可能表明应用已经拥有活动表盘。但是，如果不是，则应用可以选择显示一个按钮来将表盘设置为活动状态。

场景 1：所有设置活动表盘的尝试均已用尽

如果安装响应表明过去已经调用了 setWatchFaceAsActive()，则该按钮应导致手机上显示一个教育屏幕，向用户展示如何触摸并按住表盘以手动将其设置为他们想要的表盘。

场景 2 - 尝试设置活动表盘

手机应指示手表检查所需的 SET_PUSHED_WATCH_FACE_AS_ACTIVE 权限

  • 如果用户已经授予，则继续调用 setWatchFaceAsActive()。
  • 如果用户之前拒绝了该权限，手表应将此信息传回手机，手机上可以显示一个教育屏幕，解释需要该权限以及如何手动授予。

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

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