Mit Fotos personalisieren

Hinweis: Diese Funktion ist ab Version 4 des Zifferblattformats verfügbar.

Wenn Nutzer Fotos für das Zifferblatt auswählen können, wird es persönlicher.

Im Abschnitt Mit Bildern arbeiten wird bereits beschrieben, wie du Bilder auf deinem Zifferblatt anzeigen kannst. Wenn Sie dem Nutzer die Auswahl aus einer Reihe vordefinierter Bilder ermöglichen möchten, verwenden Sie ein ListConfiguration, wie im Abschnitt Nutzerkonfigurationen definieren beschrieben.

Wenn Sie in Ihrem Zifferblatt Bilder verwenden möchten, die der Nutzer konfigurieren kann, verwenden Sie das Element <PhotosConfiguration>, z. B.:

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

Der configType kann entweder SINGLE oder MULTIPLE sein. Das gibt an, ob der Nutzer ein einzelnes Bild im Companion oder eine Sammlung von Fotos auswählen kann.

Einzelnes Foto unterstützen

Wenn nur ein Bild verwendet wird, kann das Foto in einem PartImage-Element wie folgt verwendet werden:

<PartImage x="100" y="50" width="100" height="100">
    <Photos source="[CONFIGURATION.photoConfig]" defaultImageResource="default_image"/>
</PartImage>
watchface_photos.xml

Beachten Sie das defaultImageResource, das angezeigt wird, wenn der Nutzer kein Foto in der Companion-App ausgewählt hat. Es ist ein erforderliches Attribut.

Wenn der Nutzer ein anderes Foto auswählen möchte, muss er die Companion-App verwenden, um die vorhandene Auswahl durch ein anderes Foto zu ersetzen.

Unterstützung mehrerer Fotos

Mit PhotosConfiguration und configType="MULTIPLE" kann auf dem Zifferblatt ein Foto aus einer Sammlung angezeigt werden, das entweder durch Tippen oder automatisch nach einer bestimmten Anzahl von Aufrufen gewechselt werden kann.

<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

Das vorherige Beispiel zeigt die beiden Optionen, die bei Verwendung von MULTIPLE eingeführt werden:

  1. Mit dem Attribut change kann der Entwickler angeben, durch welche Ereignisse das Foto durch die verfügbaren Bilder wechseln soll.

Im vorherigen Beispiel sind sowohl TAP als auch ON_VISIBLE angegeben. Das bedeutet, dass sich das Foto entweder oder ändert, wenn ein Nutzer darauf tippt oder wenn es sichtbar wird.

  1. Das Attribut changeAfterEvery gilt nur für das Ereignis ON_VISIBLE und gibt an, wie oft das Foto sichtbar sein muss, bevor es geändert wird. Vielleicht finden Sie es beispielsweise zu häufig, wenn sich das Foto jedes Mal ändert, wenn der Nutzer seine Smartwatch aktiviert. Der Standardwert ist 3.

Weitere Informationen zur Verwendung von PhotosConfiguration finden Sie in den Beispielen auf GitHub.