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.
Recursos relacionados
Consulta los siguientes recursos relacionados: