Personnaliser avec des photos

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Remarque: Cette fonctionnalité est disponible à partir de la version 4 de Watch Face Format.

Permettre à l'utilisateur de sélectionner des photos à inclure sur le cadran peut contribuer à personnaliser l'expérience.

La section Utiliser des images explique déjà comment afficher des images dans votre cadran. Si vous souhaitez autoriser l'utilisateur à choisir parmi une gamme d'images prédéfinies, utilisez un ListConfiguration, comme indiqué dans la section Définir des configurations utilisateur.

Pour utiliser des images dans votre cadran que l'utilisateur peut configurer, utilisez l'élément <PhotosConfiguration>, par exemple:

<UserConfigurations>
  <PhotosConfiguration id="photoConfig" configType="SINGLE"/>
</UserConfigurations>

configType peut être SINGLE ou MULTIPLE, ce qui indique si l'utilisateur peut sélectionner une seule image dans l'annonce associée ou une collection de photos.

Prendre en charge une seule photo

Dans le cas d'une seule image, la photo peut être utilisée dans un élément PartImage comme suit:

<PartImage ...>
  <Photos source="[CONFIGURATION.photoConfig]" defaultImageResource="default_image"/>
</PartImage>

Notez defaultImageResource, qui s'affiche lorsque l'utilisateur n'a pas sélectionné de photo dans l'application associée et qui est un attribut obligatoire.

Si l'utilisateur souhaite sélectionner une autre photo, il doit utiliser l'application associée pour remplacer la sélection existante par une autre.

Prendre en charge plusieurs photos

L'utilisation de PhotosConfiguration avec configType="MULTIPLE" permet au cadran d'afficher une photo d'une collection, qui peut être parcourue en appuyant dessus ou automatiquement après un certain nombre de vues.

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

L'exemple précédent montre les deux options introduites lors de l'utilisation de MULTIPLE:

1. L'attribut change permet au développeur de spécifier les événements qui doivent entraîner la rotation des images disponibles dans la photo.

Dans l'exemple précédent, TAP et ON_VISIBLE sont tous deux spécifiés, ce qui signifie que la photo change soit en réponse à un appui de l'utilisateur sur la photo soit en réponse à la visibilité de la photo.

1. L'attribut changeAfterEvery ne s'applique qu'à l'événement de modification ON_VISIBLE, qui spécifie le nombre de fois où la photo doit être devenue visible avant d'être modifiée. Par exemple, vous pouvez penser que le changement de photo à chaque fois que l'utilisateur active sa montre est trop fréquent. La valeur par défaut est ici 3.

Pour en savoir plus sur l'utilisation de PhotosConfiguration, consultez les exemples sur GitHub.