对于规范市场,手机应用是用户与应用互动的主要方式。
设置表盘
当用户在手机应用中选择表盘时,后续设置表盘的流程分为两部分:
- 安装:使用通过
MessageClient
启动的表盘推送功能安装表盘。此步骤非常简单,可以使用addWatchFace
或updateWatchFace
,通过手机上的MessageClient
触发。 - 激活: 将已安装的表盘主题设为当前表盘主题。此步骤有多种可能的路径,具体取决于权限状态:
- 您可能无需执行任何操作。应用商店可能已控制当前表盘主题。
- 无需用户干预。应用拥有设置有效表盘主题的必要权限,可以直接使用
setWatchFaceAsActive()
进行设置。 - 可能需要提供指导,说明如何接受权限请求,或者如何使用长按手势或通过配套应用手动设置表盘主题。
安装响应
为了方便 激活阶段,安装阶段应将以下信息从手表返回到手机:
- 安装尝试的结果
isWatchFaceActive()
的结果 - 用于确定应用是否已拥有当前表盘。setWatchFaceAsActive()
是否已在过去被调用过 - Wear OS 应用应在本地跟踪并持久保存此信息。此 API 调用只能使用一次。
启用
安装完成后,响应可能会表明应用已具有有效的表盘。不过,如果不支持,应用可以选择显示一个用于将表盘主题设为当前表盘主题的按钮。
情形 1:设置当前表盘主题的所有尝试均已用尽
如果安装的响应表明之前已调用过 setWatchFaceAsActive()
,则该按钮应引导用户前往手机上的指导界面,向用户展示如何触摸并按住表盘,以手动将其设置为所需的主题。
场景 2 - 尝试设置当前表盘主题
手机应指示手表检查必要的 SET_PUSHED_WATCH_FACE_AS_ACTIVE
权限:
- 如果用户已授予该权限,请继续调用 setWatchFaceAsActive()。
- 如果用户之前拒绝了该权限,手表应将此情况传回手机,以便在手机上显示说明界面,说明需要该权限的原因以及如何手动授予该权限。
如果之前未请求过该权限,手表应指示手机显示一个教育时刻,引导用户了解如何在手表上接受权限,然后手表应继续请求该权限。
- 如果用户授予权限,手表应随后调用
setWatchFaceAsActive()
。 - 否则,手表应指示手机显示一个教育屏幕,说明需要该权限的原因以及如何手动授予该权限。
- 如果用户授予权限,手表应随后调用