Beberapa tampilan jam mendukung parameter konfigurasi sehingga pengguna dapat menyesuaikan tampilan jam dan perilakunya. Misalnya, beberapa tampilan jam memungkinkan pengguna memilih warna latar belakang kustom. Tampilan jam lainnya yang memberi tahu waktu untuk dua zona waktu berbeda memungkinkan pengguna memilih zona waktu mana yang mereka minati.
Tampilan jam yang mendukung parameter konfigurasi memungkinkan pengguna menyesuaikan tampilan jam menggunakan aktivitas. Pengguna bisa memulai aktivitas konfigurasi wearable di perangkat wearable. Mereka juga dapat memulai aktivitas konfigurasi pendamping dari aplikasi genggam, jika sudah diinstal. Selain itu, pengguna dapat mengonfigurasi tampilan jam di aplikasi pendamping perangkat untuk perangkat Wear OS 3.
Catatan: Konfigurasi pada aplikasi pendamping perangkat tersedia di perangkat yang menargetkan API level 30 dan yang lebih tinggi. Konfigurasi pada aplikasi perangkat genggam tersedia di semua perangkat.
Menggunakan sesi editor
Sebaiknya Anda mendukung konfigurasi di smartwatch agar pengguna dapat menyesuaikan tampilan jam tanpa memerlukan perangkat pendamping.
Untuk mendukung hal ini, tampilan jam dapat menyediakan konfigurasi Activity
dan memungkinkan
pengguna mengubah setelan menggunakan EditorSession
yang ditampilkan dari
EditorSession.createOnWatchEditorSession
.
Saat pengguna membuat perubahan, memanggil
EditorSession.renderWatchFaceToBitmap
akan menyediakan pratinjau langsung tampilan jam di editor Activity
.
Menetapkan intent untuk aktivitas konfigurasi
Jika tampilan jam menyertakan aktivitas konfigurasi, dan Anda mengonfigurasi tampilan jam dari aplikasi pendamping perangkat, tambahkan entri metadata berikut ke deklarasi layanan di file manifes aplikasi wearable:
<service> <meta-data android:name="com.google.android.wearable.watchface.wearableConfigurationAction" android:value="androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR" /> <meta-data android:name="com.google.android.wearable.watchface.companionBuiltinConfigurationEnabled" android:value="true" /> </service>
Aktivitas konfigurasi mendaftarkan filter intent untuk intent ini, dan sistem akan mengaktifkan intent ini saat pengguna ingin mengonfigurasi tampilan jam Anda.
Jika tampilan jam hanya menyertakan aktivitas konfigurasi pendamping atau wearable, Anda cukup menyertakan entri metadata yang sesuai dari contoh sebelumnya.
Membuat aktivitas konfigurasi wearable
Aktivitas konfigurasi wearable memberikan pilihan penyesuaian yang terbatas untuk tampilan jam, karena menu yang kompleks akan sulit dibuka pada layar yang kecil. Dalam aktivitas konfigurasi wearable Anda, sediakan pilihan biner dan beberapa pilihan saja untuk menyesuaikan aspek utama tampilan jam Anda.
Untuk membuat aktivitas konfigurasi wearable, tambahkan aktivitas baru ke modul aplikasi wearable dan deklarasikan filter intent berikut dalam file manifes aplikasi wearable:
<activity android:name=".DigitalWatchFaceWearableConfigActivity" android:label="@string/digital_config_name"> <intent-filter> <action android:name="androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR" /> <category android:name= "com.google.android.wearable.watchface.category.WEARABLE_CONFIGURATION" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
Nama tindakan dalam filter intent ini harus berupa
androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR
.
Dalam aktivitas konfigurasi Anda, build UI sederhana yang menyediakan pilihan bagi pengguna untuk menyesuaikan tampilan jam Anda.
Membuat aktivitas konfigurasi pendamping
Aktivitas konfigurasi pendamping memberi pengguna akses ke sekumpulan lengkap pilihan konfigurasi untuk tampilan jam. Hal ini karena interaksi dengan menu yang kompleks lebih mudah dilakukan pada layar perangkat genggam yang lebih besar. Misalnya, aktivitas konfigurasi di perangkat genggam memungkinkan Anda untuk menampilkan pemilih warna yang lengkap sehingga pengguna dapat memilih warna latar tampilan jam.
Catatan: Aktivitas konfigurasi hanya dapat ditulis untuk perangkat genggam yang menjalankan Android, seperti ponsel, tablet, dan perangkat foldable.
Untuk membuat aktivitas konfigurasi pendamping, tambahkan aktivitas baru ke modul aplikasi genggam Anda dan deklarasikan filter intent berikut dalam file manifes aplikasi genggam:
<activity android:name=".DigitalWatchFaceCompanionConfigActivity" android:label="@string/app_name"> <intent-filter> <action android:name= "com.example.android.wearable.watchface.CONFIG_DIGITAL" /> <category android:name= "com.google.android.wearable.watchface.category.COMPANION_CONFIGURATION" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </activity>
Dalam aktivitas konfigurasi Anda, buatlah UI yang menyediakan opsi untuk menyesuaikan semua elemen yang dapat dikonfigurasi pada tampilan jam Anda. Setelah pengguna membuat pilihan, gunakan Wearable Data Layer API untuk mengomunikasikan perubahan konfigurasi ke aktivitas tampilan jam.
Referensi terkait
Lihat referensi terkait berikut ini: