Personalizacja za pomocą zdjęć

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

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

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>, na przykład:

<!-- 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 zdjęcie można wykorzystać 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 pokazano 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żesz na przykład uznać, ż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.