产品新闻

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

阅读用时：3 分钟
查看 Garan Jenkin 的个人资料
Garan Jenkin 开发者关系工程师

 

 

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

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

Androidify 表盘主题

由于 Androidify 公仔具有高度个性化特征，因此最适合在表盘上展示。它不仅是最常看到的界面，也是最能体现个人风格的界面，可让您展现自己的个性。

demonstration.gif

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

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

概要设计

image.png

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

为了实现端到端体验，需要将多种技术组合在一起，如上图所示。

首先，用户头像会与预先存在的表盘格式模板相结合，然后打包到 APK 中。这是经过验证的 - 原因稍后会说明！- 并发送到手表。

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

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

创建表盘模板

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

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 方法，具体取决于具体情况：Watch Face Push 定义了“槽”的概念，即给定应用在任何时间可以安装的表盘数量。对于 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 创作的精彩作品！

作者：
继续阅读