为手机应用配置表盘推送

对于规范的购物平台，手机应用是用户与应用互动的主要方式。

设置表盘

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

  1. 安装：使用通过 MessageClient 发起的表盘推送功能安装表盘。此步骤很简单，只需使用 addWatchFace 或 updateWatchFace，通过 MessageClient 从手机触发到手表即可。
  2. 激活：将已安装的表盘主题设为当前表盘主题。此步骤有多个可能的路径，具体取决于权限状态：
    • 您可能无需执行任何操作。购物平台可能已经控制了当前表盘。
    • 可能无需用户干预。该应用具有设置当前表盘主题的必要权限，并且可以直接使用 setWatchFaceAsActive() 执行此操作。
    • 您可能需要相关指南，了解如何接受权限请求，或如何使用长按手势或通过配套应用手动设置表盘。

安装响应

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

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

提升活跃度

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

场景 1：尝试设置当前表盘的所有尝试均已耗尽

如果安装响应表明 setWatchFaceAsActive() 在过去已被调用，则该按钮应将用户定向到手机上的教程界面，向用户展示如何轻触并按住表盘以手动将其设置为所需的表盘。

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

手机应指示手表检查是否具有必要的 SET_PUSHED_WATCH_FACE_AS_ACTIVE 权限：

  • 如果用户已授予此权限，请继续调用 setWatchFaceAsActive()。
  • 如果用户之前拒绝了该权限，手表应将此信息传回给手机，手机上会显示一个说明屏幕，说明需要该权限以及如何手动授予该权限。

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

    • 如果用户授予权限，手表应调用 setWatchFaceAsActive()。
    • 否则，手表应指示手机显示一个说明为何需要该权限以及如何手动授予该权限的说明界面。