Personnaliser avec des photos

Remarque : Cette fonctionnalité est disponible dans la version 4 et les versions ultérieures du format du cadran.

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

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 les configurations utilisateur.

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

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

La valeur configType peut être SINGLE ou MULTIPLE, selon que l'utilisateur pourra 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 x="100" y="50" width="100" height="100">
    <Photos source="[CONFIGURATION.photoConfig]" defaultImageResource="default_image"/>
</PartImage>
watchface_photos.xml

Notez le 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.

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 sur l'écran ou automatiquement après un certain nombre de vues.

<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

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

  1. L'attribut change permet au développeur de spécifier les événements qui doivent faire défiler les images disponibles.

Dans l'exemple précédent, TAP et ON_VISIBLE sont spécifiés, ce qui signifie que la photo change soit lorsqu'un utilisateur appuie dessus, soit lorsqu'elle devient visible.

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

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