产品资讯

通过 Watch Face Push 功能将 Androidify 带到 Wear OS

阅读用时：3 分钟
Garan Jenkin
开发者关系工程师

 

 

几个月前，我们重新发布了 Androidify，将其作为一款用于生成个性化 Android 机器人的应用。Androidify 使用 Gemini 和 Imagen 将您的自拍照转换为有趣的 Android 机器人。

不过，鉴于 Android 涵盖多种设备规格， 包括我们最新添加的 XR，我们便思考：如何将 Androidify 的乐趣带到 Wear OS？

Androidify 表盘

由于 Androidify 机器人具有高度个性化特征，因此最适合展示它们的地方就是表盘。表盘不仅是最常看到的界面，也是最能代表您个人身份的界面。

demonstration.gif

根据自拍照片生成的个性化 Androidify 表盘

Androidify 现在能够在手机应用中动态生成表盘，然后将其发送到手表，并在手表上自动设置为表盘。所有这些操作都可在几秒钟内完成！

概要设计

image.png

表盘创建和安装的端到端流程

为了实现端到端体验，需要将多种技术组合在一起，如以下高级设计图所示。

首先，系统会将用户的头像与预先存在的表盘格式模板相结合，然后将其打包到 APK 中。出于稍后将说明的原因，系统会对该 APK 进行验证，然后将其发送到手表。

当手表收到表盘时，会使用新的 Watch Face Push API（Wear OS 6 的一部分）来安装和激活表盘。

下面，我们来详细了解一下：

创建表盘模板

表盘是根据模板创建的，而模板本身是在 Watch Face Designer 中设计的。这是我们新推出的 Figma 插件，可让您直接在 Figma 中创建 Watch Face Format 表盘。

image.png

表盘设计器中的 Androidify 表盘模板

该插件支持以多种不同的方式导出表盘，包括以表盘格式 (WFF) 资源的形式导出。然后，这些资源可以轻松地作为 Androidify 应用中的资源进行整合，以动态构建最终的表盘。

打包和验证

将模板和头像组合在一起后，使用 Portable Asset Compiler Kit (Pack) 来组装 APK。

在 Androidify 中，Pack 用作手机上的原生库。如需详细了解 Androidify 如何与 Pack 库交互，请参阅 GitHub 代码库。

在传输之前，系统会通过表盘推送验证器检查 APK，这是最后一步。

此验证器会检查 APK 是否适合安装。这包括检查 APK 的内容以确保它是有效的表盘，以及进行一些性能检查。如果有效，验证器会生成一个令牌。

手表在安装时需要此令牌。

正在发送表盘主题

Wear OS 上的 Androidify 应用使用 WearableListenerService 来监听穿戴式设备数据层上的事件。

手机应用使用 MessageClient 设置流程，然后使用 ChannelClient 传输 APK，从而转移表盘。

在手表上安装表盘

Wear OS 设备收到表盘后，Androidify 应用会使用新的 Watch Face Push API 来安装表盘：

val wfpManager = 

    WatchFacePushManagerFactory.createWatchFacePushManager(context)

val response = wfpManager.listWatchFaces()



try {

    if (response.remainingSlotCount > 0) {

        wfpManager.addWatchFace(apkFd, token)

    } else {

        val slotId = response.installedWatchFaceDetails.first().slotId

        wfpManager.updateWatchFace(slotId, apkFd, token)

    }

} catch (a: WatchFacePushManager.AddWatchFaceException) {

    return WatchFaceInstallError.WATCH_FACE_INSTALL_ERROR

} catch (u: WatchFacePushManager.UpdateWatchFaceException) {

    return WatchFaceInstallError.WATCH_FACE_INSTALL_ERROR

}

Androidify 使用 addWatchFace 或 updateWatchFace 方法，具体取决于应用场景：表盘推送定义了“slot”的概念，即给定应用在任何时间可以安装的表盘数量。对于 Wear OS 6，此值实际上为 1。

Androidify 的方法是，如果有空闲位置，则安装表盘；如果没有，则将任何现有表盘换成新表盘。

设置当前表盘主题

以编程方式安装表盘主题是一大进步，但 Androidify 还希望确保表盘主题是有效表盘主题。

Watch Face Push 功能引入了一项新的运行时权限，必须授予此权限，应用才能实现此功能：

com.google.wear.permission.SET_PUSHED_WATCH_FACE_AS_ACTIVE

获得此权限后，即可调用 wfpManager.setWatchFaceAsActive() 方法，将已安装的表盘主题设为当前表盘主题。

不过，Androidify 必须考虑以下诸多因素：

  • setWatchFaceAsActive 只能使用一次。
  • 用户拒绝授予 SET_PUSHED_WATCH_FACE_AS_ACTIVE 后，无法再次请求该权限。
  • Androidify 可能已在控制当前表盘主题。

如需了解详情，请参阅 Androidify 如何实现设置活跃状态的逻辑。

开始使用 Wear OS 的 Watch Face Push 功能

Watch Face Push 是一项多用途 API，既可用于增强 Androidify，也可用于构建功能齐全的表盘主题市场。

也许您已拥有手机应用，并正在寻找机会进一步吸引和取悦用户？

或者，您是现有的表盘开发者，希望通过发布市场应用来创建自己的社区和图库？

请参阅以下资源：

您还可以观看配套视频，深入了解我们如何将 Androidify 引入 Wear OS！

我们期待看到您使用 Watch Face Push 创作的精彩作品！

作者：

继续阅读