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 Alur data detail](https://developer.android.com/static/wear/images/complications-data-flow.png?authuser=6&hl=id)
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.
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
danSHORT_TEXT
, dan sumber rapat berikutnya mungkin mendukung jenisSHORT_TEXT
danLONG_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
, danRANGED_VALUE
. Ukuran pada tampilan jam mungkin hanya mendukung jenisRANGED_VALUE
.
Untuk mempelajari lebih lanjut berbagai jenis detail dan kolom yang didukung oleh setiap jenis, lihat Jenis detail.