在 Wear OS 上提供配置活动

有些表盘支持配置参数，以便用户自定义表盘的外观和行为。例如，有些表盘允许用户选择自定义背景颜色。其他用于显示两个不同时区的表盘则允许用户选择他们感兴趣的时区。

支持配置参数的表盘允许用户通过活动自定义表盘。用户可以在可穿戴设备上启动可穿戴配置活动。如果已安装，他们也可以从手持设备应用启动伴侣配置活动。此外，对于 Wear OS 3 设备，用户可以在设备伴侣应用中配置表盘。

注意：设备伴侣应用上的配置适用于目标 API 级别 30 及更高版本的设备。手持设备应用上的配置适用于所有设备。

使用编辑器会话

我们强烈建议您支持在智能手表上进行配置，以便用户无需伴侣设备即可自定义其表盘。

为此，表盘可以提供配置 Activity，并允许用户使用从 EditorSession.createOnWatchEditorSession 返回的 EditorSession 更改设置。当用户进行更改时，调用 EditorSession.renderWatchFaceToBitmap 会在编辑器 Activity 中提供表盘的实时预览。

为配置活动指定意图

如果您的表盘包含配置活动，并且您正在从设备伴侣应用配置表盘，请将以下元数据条目添加到可穿戴应用清单文件中的服务声明中

<service>
    <meta-data
        android:name="com.google.android.wearable.watchface.wearableConfigurationAction"
        android:value="androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR" />
    <meta-data
        android:name="com.google.android.wearable.watchface.companionBuiltinConfigurationEnabled"
        android:value="true" />
</service>

配置活动为此意图注册意图过滤器，当用户想要配置您的表盘时，系统会触发此意图。

如果您的表盘仅包含伴侣配置活动或可穿戴配置活动，您只需要包含上一个示例中对应的元数据条目。

创建可穿戴配置活动

可穿戴配置活动为表盘提供有限的自定义选项，因为在小屏幕上导航复杂的菜单很困难。在您的可穿戴配置活动中，提供二元选择和少量选择来定制表盘的主要方面。

要创建可穿戴配置活动，请在您的可穿戴应用模块中添加一个新活动，并在可穿戴应用清单文件中声明以下意图过滤器

<activity
    android:name=".DigitalWatchFaceWearableConfigActivity"
    android:label="@string/digital_config_name">
    <intent-filter>
        <action android:name="androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR" />
        <category android:name=
        "com.google.android.wearable.watchface.category.WEARABLE_CONFIGURATION" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

此意图过滤器中的操作名称必须是 androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR。

在您的配置活动中，构建一个简单的 UI，为用户提供自定义表盘的选项。

创建伴侣配置活动

伴侣配置活动让用户可以访问表盘的完整配置选项，因为在手持设备的较大屏幕上与复杂菜单交互更容易。例如，手持设备上的配置活动允许您向用户提供精美的颜色选择器，以选择表盘的背景颜色。

注意：配置活动只能为运行 Android 的手持设备（如手机、平板电脑和可折叠设备）编写。

要创建伴侣配置活动，请在您的手持应用模块中添加一个新活动，并在手持应用清单文件中声明以下意图过滤器

<activity
    android:name=".DigitalWatchFaceCompanionConfigActivity"
    android:label="@string/app_name">
    <intent-filter>
        <action android:name=
            "com.example.android.wearable.watchface.CONFIG_DIGITAL" />
        <category android:name=
        "com.google.android.wearable.watchface.category.COMPANION_CONFIGURATION" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

在您的配置活动中，构建一个 UI，提供选项来定制表盘的所有可配置元素。用户做出选择后，使用 Wearable Data Layer API 将配置更改传达给表盘活动。

请参阅以下相关资源