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 memberikan sentuhan pribadi pada pengalaman tampilan jam Anda.

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

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

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

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

Mendukung satu foto

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

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

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

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

Mendukung beberapa foto

Penggunaan PhotosConfiguration dengan configType="MULTIPLE" memungkinkan tampilan jam menampilkan foto dari koleksi, yang dapat diputar melalui ketukan atau secara otomatis setelah banyak tampilan dilakukan.

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

Contoh sebelumnya menunjukkan dua opsi yang diperkenalkan saat menggunakan MULTIPLE:

  1. Atribut change memungkinkan developer menentukan peristiwa yang harus menyebabkan foto berputar melalui gambar yang tersedia.

Dalam contoh sebelumnya, TAP dan ON_VISIBLE ditentukan, yang berarti foto berubah sebagai respons baik pengguna mengetuk foto atau sebagai respons terhadap foto yang terlihat.

  1. Atribut changeAfterEvery hanya berlaku untuk peristiwa perubahan ON_VISIBLE, yang menentukan berapa kali foto seharusnya 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 detail selengkapnya tentang cara menggunakan PhotosConfiguration, lihat contoh di GitHub.