Personalizacja za pomocą zdjęć

Uwaga: ta funkcja jest dostępna w wersji 4 i nowszych formatu tarczy zegarka.

Umożliwienie użytkownikowi wybierania zdjęć, które mają być wyświetlane na tarczy zegarka, może pomóc w personalizacji tarczy.

W sekcji Praca z obrazami znajdziesz informacje o tym, jak wyświetlać obrazy na tarczy zegarka. Jeśli chcesz umożliwić użytkownikowi wybór z zakresu predefiniowanych obrazów, użyj ListConfiguration, jak pokazano w sekcji definiowanie konfiguracji użytkownika.

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

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

Symbol configType może mieć wartość SINGLE lub MULTIPLE, co oznacza, czy użytkownik będzie mógł wybrać pojedynczy obraz w komponencie towarzyszącym, czy kolekcję zdjęć.

Obsługa pojedynczego zdjęcia

W przypadku pojedynczego obrazu można go użyć w elemencie PartImage w ten sposób:

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

Zwróć uwagę na znak defaultImageResource, który jest wyświetlany, gdy użytkownik nie wybrał zdjęcia w aplikacji towarzyszącej. Jest to atrybut wymagany.

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

Obsługa wielu zdjęć

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

<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

W przykładzie powyżej widać 2 opcje, które są dostępne podczas korzystania z MULTIPLE:

  1. Atrybut change umożliwia deweloperowi określenie, które zdarzenia powinny powodować przełączanie zdjęć między dostępnymi obrazami.

W powyższym przykładzie określono zarówno TAP, jak i ON_VISIBLE, co oznacza, że zdjęcie zmienia się w odpowiedzi albo na kliknięcie go przez użytkownika albo na jego wyświetlenie.

  1. Atrybut changeAfterEvery ma zastosowanie tylko do zdarzenia ON_VISIBLE change, określając, ile razy zdjęcie powinno stać się widoczne, zanim zostanie zmienione. Może Ci się na przykład wydawać, że zmiana zdjęcia za każdym razem, gdy użytkownik wybudza zegarek, jest zbyt częsta. Wartość domyślna to 3.

Więcej informacji o pracy z PhotosConfiguration znajdziesz w przykładach na GitHubie.