Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
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.
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.
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.
Konten dan contoh kode di halaman ini tunduk kepada lisensi yang dijelaskan dalam Lisensi Konten. Java dan OpenJDK adalah merek dagang atau merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-27 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-07-27 UTC."],[],[],null,["# About complications\n\nA\n[complication](https://en.wikipedia.org/wiki/Complication_(horology))\nis any feature that is displayed on a watch face in addition to the time.\nFor example, a battery\nindicator is a complication. The\n[Complications API](/reference/kotlin/androidx/wear/watchface/complications/package-summary)\nis for both watch faces and data source apps.\n\n\nThe rest of this document describes data sources, watch faces, and\ncomplication types.\n\nComplication data source\n------------------------\n\nApps that provide data such as\nbattery level, weather, or step counts to watch faces for\ncomplications are called *complication data sources* . These data\nsources supply raw data\nand are not responsible for controlling how their data is rendered on a\nwatch face.\nTo learn about writing apps that provide data to watch faces, see\n[Expose data to\ncomplications](/training/wearables/exposing-data-complications).\n\nThe following diagram shows how Wear OS by Google mediates the flow of data\nfrom sources to watch faces.\n**Figure 1.** The flow of complication data.\n\nComplications on watch faces\n----------------------------\n\nWatch faces receive data from complication data sources, which lets them\ninclude\ncomplications without needing code for getting the underlying data. Watch\nfaces retain\ncontrol over how the data is rendered, so they can integrate data\nnaturally with their\ndesign. For more information, see the design guide about\n[Complications](/training/wearables/design/complications).\n\nTo learn how to add complications to a watch face, see\n[Add complications to a watch face](/training/wearables/watch-faces/adding-complications).\n\nComplication types\n------------------\n\nComplication types define what kinds of data can be shown in a\ncomplication or supplied by\na data source. For example, use the `SHORT_TEXT` type when the\ndata consists\nprimarily of a short string. A\n[`ComplicationData`](/reference/androidx/wear/watchface/complications/data/ComplicationData) object always has a single\ncomplication type that defines required and optional fields. A required\nfield\nrepresents the primary piece of data; most types take their name from\nthe required field.\n\nData sources use complication types differently from watch faces:\n\n- A data source chooses the types of complication data to supply, including which optional fields of those types to supply, and how many different types can be supported. For example, a step-count source might support the `RANGED_VALUE` and `SHORT_TEXT` types, and a next-meeting source might support the `SHORT_TEXT` and `LONG_TEXT` types.\n- You can choose how many complications to include in your watch face and the complication types to support. For example, a dial complication on a watch face might support the `SHORT_TEXT`, `ICON`, and `RANGED_VALUE` types. A gauge on the watch face might support only the `RANGED_VALUE` type.\n\nTo learn more about different complication types and fields supported by\neach type, see\n[Complication types](/training/wearables/watch-faces/adding-complications#types-fields)."]]
