Personalizacja za pomocą zdjęć

Uwaga: ta funkcja jest dostępna w wersji 4 lub nowszej formatu tarczy zegarka.

Umożliwienie użytkownikowi wybierania zdjęć do umieszczenia na tarczy zegarka może pomóc w spersonalizowaniu tarczy.

W sekcji praca z obrazami znajdziesz informacje o wyświetlaniu obrazów na tarczy zegarka. Jeśli chcesz, aby użytkownik mógł wybierać spośród zdefiniowanych obrazów, użyj ListConfiguration, jak pokazano w sekcji Definiowanie konfiguracji użytkownika.

Aby na tarczy zegarka używać obrazów, które użytkownik może skonfigurować, użyj elementu <PhotosConfiguration>, na przykład:

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

Wartość configType może być równa SINGLE lub MULTIPLE, co wskazuje, czy użytkownik będzie mógł wybrać pojedynczy obraz w ramach aplikacji towarzyszącej, czy kolekcji zdjęć.

Obsługa pojedynczego zdjęcia

W przypadku pojedynczego obrazu zdjęcie można użyć w elemencie PartImage w następujący sposób:

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

Zwróć uwagę na element defaultImageResource, który jest wymagany i wyświetla się, gdy użytkownik nie wybrał zdjęcia w aplikacji towarzyszącej.

Jeśli użytkownik chce wybrać inne zdjęcie, musi użyć aplikacji towarzyszącej, aby zastąpić dotychczasowy wybór innym.

Obsługa wielu zdjęć

Użycie PhotosConfiguration z configType="MULTIPLE" pozwala tarczy zegarka wyświetlać zdjęcie z kolekcji, które można przewijać przez dotknięcie lub automatycznie po określonej liczbie wyświetleń.

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

Poprzedni przykład pokazuje 2 opcje, które są dostępne podczas korzystania z funkcji MULTIPLE:

  1. Atrybut change pozwala deweloperowi określić, jakie zdarzenia powinny powodować przewijanie zdjęć w ramach dostępnych obrazów.

W powyższym przykładzie są określone zarówno TAP, jak i ON_VISIBLE, co oznacza, że zdjęcie zmienia się w odpowiedzi na kliknięcie przez użytkownika lub w odpowiedzi na to, że stało się widoczne.

  1. Atrybut changeAfterEvery ma zastosowanie tylko do zdarzenia zmiany ON_VISIBLE i określa, ile razy zdjęcie powinno być widoczne przed jego zmianą. Możesz na przykład uznać, że zmiana zdjęcia za każdym razem, gdy użytkownik włączy zegarek, jest zbyt częsta. Wartość domyślna to 3.

Więcej informacji o używaniu funkcji PhotosConfiguration znajdziesz w przykładach na GitHubie.