Personaliza con fotos

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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 deseas permitir que el usuario elija entre un rango de imágenes predefinidas, usa un ListConfiguration como se muestra en la sección Define la configuración del usuario.

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

<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 elemento complementario 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 ...>
  <Photos source="[CONFIGURATION.photoConfig]" defaultImageResource="default_image"/>
</PartImage>

Observa el defaultImageResource, que se muestra cuando el usuario no seleccionó una foto en el elemento complementario y es un atributo obligatorio.

Si el usuario desea seleccionar una foto diferente, debe usar el elemento complementario 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 con un toque o automáticamente después de que se hayan realizado muchas vistas.

<Photos change="ON_VISIBLE TAP" changeAfterEvery="5"
    source="[CONFIGURATION.photoConfig]" defaultImageResource="default_image"/>

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 cambie entre las imágenes disponibles.

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

1. El atributo changeAfterEvery solo se aplica al evento de cambio ON_VISIBLE y especifica cuántas veces la foto debería haberse vuelto visible 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.