The Android Developer Challenge is back! Submit your idea before December 2.

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>
    

Masukkan nilai untuk semua entri tersebut, yang didahului oleh nama paket aplikasi Anda. 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 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 tampilan jam.

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 tampilan jam.

Membuat layanan pemroses dalam aplikasi wearable

Untuk menerima parameter konfigurasi yang telah diperbarui dari aktivitas konfigurasi, buatlah layanan yang mengimplementasikan antarmuka WearableListenerService dari Wearable Data Layer API dalam aplikasi wearable Anda. Implementasi tampilan jam Anda dapat menggambar ulang tampilan jam jika parameter konfigurasi berubah.

Untuk detail selengkapnya, lihat class DigitalWatchFaceConfigListenerService dan DigitalWatchFaceService dalam Contoh tampilan jam.