Personaliza con fotos

Nota: Esta función está disponible en la versión 4 y posteriores del Formato de caras de relojes.

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 tu cara de 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 las opciones de configuración del usuario.

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>

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

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>

Ten en cuenta el atributo defaultImageResource, que se muestra cuando el usuario no seleccionó una foto en el dispositivo complementario 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.

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

En el ejemplo anterior, se muestran las dos opciones que se presentan 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 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 haberse vuelto visible la foto antes de que se cambie. Por ejemplo, tal vez 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 los ejemplos en GitHub.