Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

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, dan tampilan jam yang menampilkan waktu untuk dua zona waktu memungkinkan pengguna memilih zona waktu yang ingin mereka gunakan.

Lihat referensi terkait berikut:

Tampilan jam yang mendukung parameter konfigurasi memungkinkan pengguna menyesuaikan tampilan jam menggunakan aktivitas dalam aplikasi wearable, aplikasi genggam, atau keduanya. Pengguna dapat memulai aktivitas konfigurasi wearable di perangkat wearable. Mereka juga dapat memulai aktivitas konfigurasi pendamping dari aplikasi genggam, jika sudah diinstal.

Catatan: Pada Wear 1.x, saat pengguna menginstal aplikasi genggam yang berisi aplikasi wearable, aplikasi wearable tersebut akan otomatis terinstal di jam tangan. Pada Wear 2.0, aplikasi wearable tidak otomatis diinstal di jam tangan. Selain itu, pada Wear 2.0, aplikasi genggam tidak diperlukan. Jika aplikasi genggam ada dan Anda ingin menggunakannya, Anda harus menginstalnya secara terpisah.

Tampilan jam digital dari contoh Tampilan Jam menunjukkan cara mengimplementasikan aktivitas konfigurasi genggam dan wearable, serta cara mengupdate tampilan jam sebagai respons terhadap perubahan konfigurasi.

Menetapkan intent untuk aktivitas konfigurasi

Jika tampilan jam Anda menyertakan aktivitas konfigurasi, tambahkan entri metadata berikut ke deklarasi layanan dalam file manifes aplikasi wearable:

    <service
        android:name=".DigitalWatchFaceService" ... />
        <!-- companion configuration activity -->
        <meta-data
            android:name=
               "com.google.android.wearable.watchface.companionConfigurationAction"
            android:value=
               "com.example.android.wearable.watchface.CONFIG_DIGITAL" />
        <!-- wearable configuration activity -->
        <meta-data
            android:name=
               "com.google.android.wearable.watchface.wearableConfigurationAction"
            android:value=
               "com.example.android.wearable.watchface.CONFIG_DIGITAL" />
        ...
    </service>
    

Berikan nilai untuk entri-entri ini yang didahului dengan nama paket aplikasi Anda. Aktivitas konfigurasi mendaftarkan filter intent untuk intent ini, dan sistem akan mengaktifkan intent ini ketika 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 di atas.

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. Aktivitas konfigurasi wearable sebaiknya menyediakan pilihan biner dan beberapa pilihan 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=
                "com.example.android.wearable.watchface.CONFIG_DIGITAL" />
            <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 sama dengan nama intent yang Anda tetapkan dalam Menetapkan Intent untuk Aktivitas Konfigurasi.

Dalam aktivitas konfigurasi Anda, buat UI sederhana yang menyediakan pilihan bagi pengguna untuk menyesuaikan tampilan jam Anda. Saat pengguna membuat pilihan, gunakan Wearable Data Layer API untuk mengomunikasikan perubahan konfigurasi ke aktivitas tampilan jam.

Untuk detail selengkapnya, lihat class DigitalWatchFaceWearableConfigActivity dan DigitalWatchFaceUtil dalam contoh WatchFace.

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.

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. Saat pengguna membuat pilihan, gunakan Wearable Data Layer API untuk mengomunikasikan perubahan konfigurasi ke aktivitas tampilan jam.

Untuk detail selengkapnya, lihat class DigitalWatchFaceCompanionConfigActivity dalam contoh WatchFace.

Membuat layanan pemroses dalam aplikasi wearable

Untuk menerima parameter konfigurasi terupdate dari aktivitas konfigurasi, buat layanan yang mengimplementasikan antarmuka WearableListenerService dari Wearable Data Layer API di aplikasi wearable. Implementasi tampilan jam Anda dapat menggambar kembali tampilan jam ketika parameter konfigurasi berubah.

Untuk detail selengkapnya, lihat class DigitalWatchFaceConfigListenerService dan DigitalWatchFaceService dalam contoh WatchFace.