Tentang detail

Detail adalah setiap fitur yang ditampilkan pada tampilan jam selain waktu. Misalnya, indikator baterai termasuk detail. Complications API digunakan untuk aplikasi sumber data dan tampilan jam.

Bagian lain dari dokumen ini menjelaskan sumber data, tampilan jam, dan jenis detail.

Sumber data detail

Aplikasi yang menyediakan data seperti level baterai, cuaca, atau jumlah langkah untuk detail tampilan jam disebut sumber data detail. Sumber data ini memberikan data mentah dan tidak bertanggung jawab mengontrol cara data tersebut ditampilkan pada tampilan jam. Untuk mempelajari cara menulis aplikasi yang menyediakan data ke tampilan jam, lihat Mengekspos data ke detail.

Diagram berikut menunjukkan bagaimana Wear OS by Google memediasi alur data dari sumber ke tampilan jam.

Alur data detail
Gambar 1. Alur data detail.

Detail pada tampilan jam

Tampilan jam menerima data dari sumber data detail, yang memungkinkan tampilan jam menyertakan detail tanpa memerlukan kode untuk mendapatkan data yang mendasarinya. Tampilan jam mempertahankan kontrol atas cara data dirender sehingga dapat mengintegrasikan data secara natural dengan desainnya. Untuk mengetahui informasi selengkapnya, lihat panduan desain tentang Detail.

Catatan: Pada versi Wear OS mendatang, tampilan jam harus menggunakan Format Tampilan Jam untuk mendukung detail yang berisi data pengguna. Sebaiknya perbarui tampilan jam untuk menggunakan Format Tampilan Jam. Pelajari perubahan pada detail ini lebih lanjut.

Untuk mempelajari cara menambahkan detail ke tampilan jam, lihat Menambahkan detail ke tampilan jam.

Jenis detail

Jenis detail menentukan jenis data yang dapat ditampilkan pada detail atau disediakan oleh sumber data. Misalnya, gunakan jenis SHORT_TEXT jika sebagian besar data terdiri dari string pendek. Objek ComplicationData selalu memiliki satu jenis detail yang menentukan kolom wajib dan opsional. Kolom wajib diisi menunjukkan bagian utama data. Sebagian besar jenis mengambil namanya dari kolom wajib diisi.

Sumber data menggunakan jenis detail secara berbeda dari tampilan jam:

  • Sumber data memilih jenis data detail yang akan disediakan, termasuk kolom opsional mana dari jenis tersebut yang akan disediakan, dan berapa banyak jenis berbeda yang dapat didukung. Misalnya, sumber jumlah langkah mungkin mendukung jenis RANGED_VALUE dan SHORT_TEXT, dan sumber rapat berikutnya mungkin mendukung jenis SHORT_TEXT dan LONG_TEXT.
  • Anda dapat memilih banyaknya detail yang disertakan dalam tampilan jam dan jenis detail yang didukung. Misalnya, detail tombol pada tampilan jam mungkin mendukung jenis SHORT_TEXT, ICON, dan RANGED_VALUE. Ukuran pada tampilan jam mungkin hanya mendukung jenis RANGED_VALUE.

Untuk mempelajari lebih lanjut berbagai jenis detail dan kolom yang didukung oleh setiap jenis, lihat Jenis detail.