À propos des complications

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.

Flux de données Complications
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.

Pour découvrir comment ajouter des complications à un cadran, consultez la section Ajouter des complications à un cadran.

Types de 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.