Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Une complication est une fonctionnalité qui s'affiche sur un cadran en plus de l'heure.
Par exemple, un indicateur de batterie est une complication. L'API Complications est destinée aux cadrans et aux applications de sources de données.
Le reste de ce document décrit les sources de données, les cadrans et les types de complications.
Source des données de complication
Les applications qui fournissent des données telles que le niveau de la batterie, la météo ou le nombre de pas aux cadrans pour les complications sont appelées sources de données de complications. Ces sources fournissent des données brutes et ne contrôlent pas le rendu de leurs données sur un cadran.
Pour en savoir plus sur l'écriture d'applications qui fournissent des données aux cadrans, consultez la section Fournir des données aux complications.
Le schéma suivant montre comment Wear OS by Google assure la médiation du flux de données entre les sources et les cadrans.
Figure 1 : Flux des données de complication
Complications sur les cadrans
Les cadrans reçoivent des données provenant de sources de données de complication, ce qui leur permet d'inclure des complications sans avoir besoin de code pour obtenir les données sous-jacentes. Ils gardent le contrôle sur le rendu des données, afin de les intégrer naturellement à leur conception. Pour en savoir plus, consultez le guide de conception sur les complications.
Les types de complications définissent les types de données qui peuvent être affichées dans une complication ou fournies par une source de données. Par exemple, utilisez le type SHORT_TEXT lorsque les données sont principalement constituées d'une chaîne courte. Un objet ComplicationData comporte toujours un type de complication unique qui définit les champs obligatoires et facultatifs. Un champ obligatoire représente l'élément de données principal. La plupart des types utilisent leur nom dans le champ obligatoire.
Les sources de données utilisent les types de complications différemment des cadrans :
Une source de données choisit les types de données de complication à fournir (y compris les champs facultatifs des types de données à fournir) et le nombre de types différents pouvant être acceptés. Par exemple, une source de décompte du nombre de pas peut prendre en charge les types RANGED_VALUE et SHORT_TEXT, et une source d'organisation de réunion peut prendre en charge les types SHORT_TEXT et LONG_TEXT.
Vous pouvez choisir le nombre de complications à inclure dans votre cadran et les types de complications à prendre en charge. Par exemple, une complication de pavé numérique sur un cadran peut prendre en charge les types SHORT_TEXT, ICON et RANGED_VALUE.
Une jauge de cadran peut n'accepter que le type RANGED_VALUE.
Pour en savoir plus sur les différents types de complications et les champs compatibles avec chaque type, consultez la section Types de complications.
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/27 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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)."]]
