Remarque : Cette fonctionnalité est disponible dans la version 4 et les versions ultérieures du format de cadran.
Permettre à l'utilisateur de sélectionner des photos à inclure sur le cadran peut contribuer à personnaliser l'expérience du cadran.
La section Utiliser des images explique déjà comment afficher des images sur votre cadran. Si vous souhaitez permettre à l'utilisateur de 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 configurables par l'utilisateur dans votre cadran, utilisez l'élément <PhotosConfiguration>, par exemple :
<!-- Under WatchFace element --> <UserConfigurations> <PhotosConfiguration id="photoConfig" configType="SINGLE"/> </UserConfigurations>
configType peut être SINGLE ou MULTIPLE, ce qui indique si l'utilisateur pourra sélectionner une seule image dans l'application associée ou une collection de photos.
Prise en charge d'une seule photo
Pour 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>
Notez l'attribut defaultImageResource, qui s'affiche lorsque l'utilisateur n'a pas sélectionné de photo dans l'application associée et qui est 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.
Prise en charge de 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.
<PartImage x="100" y="250" width="100" height="100"> <Photos change="ON_VISIBLE TAP" changeAfterEvery="5" source="[CONFIGURATION.galleryConfig]" defaultImageResource="default_image"/> </PartImage>
L'exemple précédent montre les deux options introduites lors de l'utilisation de MULTIPLE :
- L'attribut
changepermet au développeur de spécifier les événements qui doivent déclencher le défilement des images disponibles.
Dans l'exemple précédent, TAP et ON_VISIBLE sont tous deux spécifiés, ce qui signifie que la photo change soit lorsque l'utilisateur appuie dessus, soit lorsqu'elle devient visible.
- L'attribut
changeAfterEveryne s'applique qu'à l'événement de modificationON_VISIBLE. Il spécifie le nombre de fois où la photo doit être visible avant d'être modifiée. Par exemple, vous pouvez penser que changer la photo chaque fois que l'utilisateur 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.