Personaliza con fotos

Nota: Esta función está disponible en la versión 4 y versiones posteriores de Watch Face Format.

Permitir que el usuario seleccione fotos para incluirlas en la cara de reloj puede ayudar a darle un toque personal a la experiencia de la cara de reloj.

En la sección Cómo trabajar con imágenes, ya se explica cómo mostrar imágenes en la cara de reloj. Si quieres permitir que el usuario elija entre una variedad de imágenes predefinidas, usa un ListConfiguration como se muestra en la sección Define configuraciones de usuario.

Para usar imágenes en la cara de reloj que el usuario pueda configurar, usa el <PhotosConfiguration> elemento, por ejemplo:

<!-- Under WatchFace element -->
<UserConfigurations>
    <PhotosConfiguration id="photoConfig" configType="SINGLE"/>
</UserConfigurations>
watchface_photos.xml

El configType puede ser SINGLE o MULTIPLE, lo que indica si el usuario podrá seleccionar una sola imagen dentro de la app complementaria o una colección de fotos.

Cómo admitir una sola foto

En el caso de una sola imagen, la foto se puede usar dentro de un elemento PartImage de la siguiente manera:

<PartImage x="100" y="50" width="100" height="100">
    <Photos source="[CONFIGURATION.photoConfig]" defaultImageResource="default_image"/>
</PartImage>
watchface_photos.xml

Ten en cuenta el defaultImageResource, que se muestra cuando el usuario no seleccionó una foto en la app complementaria y es un atributo obligatorio.

Si el usuario desea seleccionar una foto diferente, debe usar la app complementaria para reemplazar la selección existente por otra.

Cómo admitir varias fotos

El uso de PhotosConfiguration con configType="MULTIPLE" permite que la cara de reloj muestre una foto de una colección, que se puede recorrer presionando o automáticamente después de que se hayan realizado tantas vistas.

<PartImage x="100" y="250" width="100" height="100">
    <Photos change="ON_VISIBLE TAP" changeAfterEvery="5"
        source="[CONFIGURATION.galleryConfig]" defaultImageResource="default_image"/>
</PartImage>
watchface_photos_multi.xml

En el ejemplo anterior, se muestran las dos opciones que se introducen cuando se usa MULTIPLE:

  1. El atributo change permite que el desarrollador especifique qué eventos deben hacer que la foto recorra las imágenes disponibles.

En el ejemplo anterior, se especifican TAP y ON_VISIBLE, lo que significa que la foto cambia en respuesta ya sea a que un usuario presione la foto o en respuesta a que la foto se vuelva visible.

  1. El atributo changeAfterEvery solo se aplica al evento de cambio ON_VISIBLE, y especifica cuántas veces debe haber sido visible la foto antes de que se cambie. Por ejemplo, es posible que consideres que cambiar la foto cada vez que el usuario activa el reloj es demasiado frecuente. El valor predeterminado aquí es 3.

Para obtener más detalles sobre cómo trabajar con PhotosConfiguration, consulta las muestras en GitHub.