Mit Fotos personalisieren

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

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

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

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

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

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

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

Unterstützung für ein einzelnes Foto

Im Fall eines einzelnen Bildes kann das Foto so in einem PartImage-Element verwendet werden:

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

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

Wenn der Nutzer ein anderes Foto auswählen möchte, muss er die vorhandene Auswahl über die Companion App ersetzen.

Unterstützung mehrerer Fotos

Wenn Sie PhotosConfiguration und configType="MULTIPLE" verwenden, kann auf dem Zifferblatt ein Foto aus einer Sammlung angezeigt werden. Sie können dann durch Tippen oder automatisch nach einer bestimmten Anzahl von Aufrufen durch die Fotos scrollen.

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

Das vorherige Beispiel zeigt die beiden Optionen, die bei Verwendung von MULTIPLE angezeigt werden:

1. Mit dem Attribut change kann der Entwickler angeben, welche Ereignisse dazu führen sollen, dass die verfügbaren Bilder im Foto durchlaufen werden.

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

1. Das changeAfterEvery-Attribut gilt nur für das Änderungsereignis ON_VISIBLE. Damit wird angegeben, wie oft das Foto sichtbar sein sollte, bevor es geändert wird. Vielleicht finden Sie es beispielsweise zu häufig, dass das Foto jedes Mal gewechselt wird, wenn der Nutzer die Smartwatch aktiviert. Der Standardwert ist hier 3.

Weitere Informationen zur Arbeit mit PhotosConfiguration finden Sie in den Beispielen auf GitHub.