Personalisasi dengan foto

Catatan: Fitur ini tersedia di Format Tampilan Jam versi 4 dan yang lebih tinggi.

Mengizinkan pengguna memilih foto untuk disertakan di tampilan jam dapat membantu menghadirkan sentuhan pribadi pada pengalaman tampilan jam Anda.

Bagian bekerja dengan gambar sudah membahas cara menampilkan gambar di tampilan jam. Jika Anda ingin mengizinkan pengguna memilih dari berbagai gambar yang telah ditentukan sebelumnya, gunakan ListConfiguration seperti yang ditunjukkan di bagian tentukan konfigurasi pengguna.

Untuk menggunakan gambar di tampilan jam yang dapat dikonfigurasi pengguna, gunakan elemen <PhotosConfiguration>, misalnya:

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

configType dapat berupa SINGLE atau MULTIPLE yang menunjukkan apakah pengguna dapat memilih satu gambar dalam pendamping atau koleksi foto.

Mendukung satu foto

Untuk kasus satu gambar, foto dapat digunakan dalam elemen PartImage sebagai berikut:

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

Perhatikan defaultImageResource, yang ditampilkan saat pengguna belum memilih foto di aplikasi pendamping dan merupakan atribut wajib.

Jika pengguna ingin memilih foto lain, mereka harus menggunakan pendamping untuk mengganti pilihan yang ada dengan pilihan lain.

Mendukung beberapa foto

Menggunakan PhotosConfiguration dengan configType="MULTIPLE" memungkinkan tampilan jam menampilkan foto dari koleksi, yang dapat diubah dengan mengetuk atau secara otomatis setelah beberapa kali dilihat.

<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

Contoh sebelumnya menunjukkan dua opsi yang diperkenalkan saat menggunakan MULTIPLE:

  1. Atribut change memungkinkan developer menentukan peristiwa yang harus menyebabkan foto berganti-ganti melalui gambar yang tersedia.

Dalam contoh sebelumnya, TAP dan ON_VISIBLE ditentukan, yang berarti foto berubah sebagai respons baik saat pengguna mengetuk foto maupun sebagai respons saat foto menjadi terlihat.

  1. Atribut changeAfterEvery hanya berlaku untuk peristiwa perubahan ON_VISIBLE, yang menentukan berapa kali foto harus terlihat sebelum foto diubah. Misalnya, Anda mungkin merasa bahwa mengubah foto setiap kali pengguna mengaktifkan smartwatch terlalu sering. Nilai default di sini adalah 3.

Untuk mengetahui detail selengkapnya tentang cara menggunakan PhotosConfiguration, lihat contoh di GitHub.