Proporcionar actividades de configuración en Wear OS

Algunas caras de reloj admiten parámetros de configuración para permitir que los usuarios personalicen el aspecto y el comportamiento de estas. Por ejemplo, algunas caras de reloj permiten que los usuarios seleccionen un color de fondo personalizado. Otras caras que indican la hora de dos zonas horarias diferentes permiten a los usuarios seleccionar las zonas horarias que les interesan.

Las caras de reloj que admiten parámetros de configuración permiten a los usuarios personalizar una cara de reloj usando una actividad. Los usuarios pueden iniciar la actividad de configuración de wearables en el dispositivo wearable. También pueden iniciar la actividad de configuración complementaria desde la app portátil si está instalada. Además, los usuarios pueden configurar la cara de reloj en la aplicación complementaria para dispositivos Wear OS 3.

Nota: La configuración en la aplicación complementaria del dispositivo está disponible en dispositivos que se orientan al nivel de API 30 y versiones posteriores. La configuración en una app para dispositivos portátiles está disponible en todos los dispositivos.

Cómo usar una sesión de editor

Te recomendamos que permitas la configuración de compatibilidad en el reloj inteligente para que el usuario pueda personalizar su cara de reloj sin necesidad de un dispositivo complementario.

Para ello, una cara de reloj puede proporcionar una Activity de configuración y permitir que el usuario cambie la configuración mediante una EditorSession que muestra EditorSession.createOnWatchEditorSession. A medida que el usuario realiza cambios, la llamada a EditorSession.renderWatchFaceToBitmap proporciona una vista previa en vivo de la cara de reloj en el editor Activity.

Cómo especificar un intent para actividades de configuración

Si tu cara de reloj incluye actividades de configuración y quieres configurarla desde la aplicación complementaria para dispositivos, agrega las siguientes entradas de metadatos a la declaración del servicio en el archivo de manifiesto de la app para wearables:

<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>

Las actividades de configuración registran filtros de intents, y el sistema activa este intent cuando los usuarios quieren configurar tu cara de reloj.

Si tu cara de reloj solo incluye una actividad de configuración complementaria o para wearables, únicamente debes incluir la entrada de metadatos correspondiente del ejemplo anterior.

Cómo crear una actividad de configuración de wearables

Las actividades de configuración de wearables proporcionan un conjunto limitado de opciones de personalización para una cara de reloj, ya que resulta complicado navegar por menús complejos en pantallas más pequeñas. En tu actividad de configuración de wearables, brinda opciones binarias y pocas alternativas de selección para personalizar los aspectos principales de tu cara de reloj.

Para crear una actividad de configuración de wearables, agrega una nueva actividad a tu módulo de app para wearables y declara el siguiente filtro de intents en el archivo de manifiesto de la app para wearables:

<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>

El nombre de la acción en este filtro de intents debe ser androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR.

En tu actividad de configuración, compila una IU simple que proporcione opciones para que los usuarios personalicen tu cara de reloj.

Cómo crear una actividad de configuración complementaria

Las actividades de configuración complementarias permiten que los usuarios accedan al conjunto completo de opciones de configuración para una cara de reloj, ya que es más fácil interactuar con menús complejos en un dispositivo de mano con pantalla más grande. Por ejemplo, una actividad de configuración en un dispositivo de mano te permite presentar a los usuarios selectores de color elaborados para escoger el color de fondo de una cara de reloj.

Nota: Solo se pueden escribir actividades de configuración para dispositivos portátiles con Android, como teléfonos, tablets y dispositivos plegables.

Para crear una actividad de configuración complementaria, agrega una actividad nueva al módulo de tu app para dispositivos de mano y declara el siguiente filtro de intents en el archivo de manifiesto de la app:

<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>

En tu actividad de configuración, compila una IU que proporcione opciones para personalizar todos los elementos configurables de tu cara de reloj. Luego de que los usuarios realicen una selección, usa la API de Wearable Data Layer para comunicar el cambio en la configuración de la actividad de la cara de reloj.

Consulta los siguientes recursos relacionados: