Mit Fotos personalisieren

Hinweis: Diese Funktion ist in Version 4 und höher des Watch Face Format verfügbar.

Wenn Nutzer Fotos für das Zifferblatt auswählen können, können sie es personalisieren.

Im Abschnitt Bilder verwenden wird bereits beschrieben, wie Sie Bilder auf Ihrem Zifferblatt anzeigen. Wenn Sie Nutzern die Möglichkeit geben möchten, aus einer Reihe von vordefinierten Bildern auszuwählen, verwenden Sie eine ListConfiguration, wie im Abschnitt Nutzerkonfigurationen definieren beschrieben.

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

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

Der configType kann entweder SINGLE oder MULTIPLE sein. Er gibt an, ob der Nutzer ein einzelnes Bild in der Companion-App oder eine Fotosammlung auswählen kann.

Einzelnes Foto unterstützen

Im Fall eines einzelnen Bildes 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 defaultImageResource. Dieses wird angezeigt, wenn der Nutzer in der Companion-App kein Foto ausgewählt hat. Es ist ein Pflichtattribut.

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

Mehrere Fotos unterstützen

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

<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 durchlaufen werden soll.

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

  1. Das Attribut changeAfterEvery gilt nur für das Änderungsereignis ON_VISIBLE. Es gibt an, wie oft das Foto sichtbar sein muss, bevor es geändert wird. Möglicherweise ist es zu häufig, das Foto jedes Mal zu ändern, wenn der Nutzer seine Uhr aufweckt. Der Standardwert ist 3.

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