Menyediakan aktivitas konfigurasi pada Wear OS

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.

Lihat referensi terkait berikut ini: