Personaliza con fotos

Nota: Esta función está disponible en la versión 4 y posteriores del formato de cara de reloj.

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 carátula del reloj. Si quieres permitir que el usuario elija entre un rango de imágenes predefinidas, usa un ListConfiguration como se muestra en la sección define user configurations.

Para usar imágenes en tu cara de reloj que el usuario pueda configurar, usa el elemento <PhotosConfiguration>, 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 del compañero o una colección de fotos.

Admite 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 el compañero y es un atributo obligatorio.

Si el usuario desea seleccionar otra foto, debe usar el complemento para reemplazar la selección existente por otra.

Admite varias fotos

Usar PhotosConfiguration con configType="MULTIPLE" permite que la carátula del reloj muestre una foto de una colección, que se puede recorrer con un toque o automáticamente después de que se hayan realizado varias 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 el 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 debería haberse hecho visible la foto antes de que se cambie. Por ejemplo, es posible que sientas 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.