SourceType

Valeur d'une source de données, qui met à jour la valeur en temps réel qui apparaît sur le cadran.

Introduit dans Wear OS 4.

Heure et jour

Le format de cadran accepte les sources de données suivantes en fonction de l'heure et du jour :

UTC_TIMESTAMP
Nombre de millisecondes écoulées depuis minuit UTC le 1er janvier 1970.
MILLISECOND
Valeur entière représentant le champ de milliseconde d'un objet ZonedDateTime pour l'heure actuelle. Cette valeur est toujours comprise entre 0 et 999 inclus.
SECOND
Valeur entière représentant le champ de secondes d'un objet ZonedDateTime pour l'heure actuelle. Cette valeur est toujours comprise entre 0 et 59 inclus.
SECOND_Z
Chaîne représentant le champ de secondes d'un objet ZonedDateTime pour l'heure actuelle, avec des zéros au début pour obtenir une valeur de deux caractères. Cette valeur est toujours comprise entre 00 et 59 inclus.
SECOND_MILLISECOND
Valeur à virgule flottante combinant les champs de secondes et de millisecondes d'un objet ZonedDateTime qui représente l'heure actuelle. Cette valeur est toujours comprise entre 0.0 et 59.999 inclus.
SECONDS_IN_DAY
Nombre de secondes écoulées au cours de la journée en fonction des valeurs définies pour HOUR_0_23, MINUTE et SECOND. Cette valeur est toujours comprise entre 0 et 86399 (24 $ x 60 x 60 - 1 $), inclus.
MINUTE
Valeur entière représentant le champ de minutes d'un objet ZonedDateTime pour l'heure actuelle. Cette valeur est toujours comprise entre 0 et 59 inclus.
MINUTE_Z
Chaîne représentant le champ de minutes d'un objet ZonedDateTime pour l'heure actuelle, avec des zéros au début pour obtenir une valeur de deux caractères. Cette valeur est toujours comprise entre 00 et 59 inclus.
MINUTE_SECOND
Valeur à virgule flottante combinant les champs de minutes et de secondes d'un objet ZonedDateTime qui représente l'heure actuelle. Cette valeur est toujours comprise entre 0.0 et $ 59 \frac{59}{60} $, inclus.
HOUR_0_11
Composante de 12 heures pour l'heure actuelle, représentée par une valeur comprise entre 0 et 11 inclus. Si CLOCK_HOUR_OF_AMPM est 12 (dans 12:34 PM, par exemple), cette valeur est convertie en 0.
HOUR_0_11_Z
Chaîne représentant la composante de 12 heures pour l'heure actuelle (de 00 à 11 inclus) utilisant le fuseau horaire actuel de l'appareil Wear OS. Si cette valeur est inférieure à 10, elle est précédée d'un zéro.
HOUR_0_11_MINUTE
Valeur à virgule flottante combinant un champ CLOCK_HOUR_OF_AMPM modifié et le champ de minutes d'un objet ZonedDateTime représentant l'heure actuelle. Cette valeur est toujours comprise entre 0.0 et $ 11 \frac{59}{60} $, inclus.
HOUR_1_12
Composante de 12 heures pour l'heure actuelle, représentée par une valeur comprise entre 1 et 12 inclus. Si HOUR_OF_DAY est 0, comme dans 0:12 (12:12 du matin), cette valeur est convertie en 12.
HOUR_1_12_Z
Chaîne représentant la composante de 12 heures pour l'heure actuelle (de 01 à 12 inclus) utilisant le fuseau horaire actuel de l'appareil Wear OS. Si cette valeur est inférieure à 10, elle est précédée d'un zéro.
HOUR_1_12_MINUTE
Valeur à virgule flottante combinant les champs CLOCK_HOUR_OF_AMPM et minutes d'un objet ZonedDateTime qui représente l'heure actuelle. Cette valeur est toujours comprise entre 1.0 et $ 12 \frac{59}{60} $, inclus.
HOUR_0_23
Composante de 24 heures pour l'heure actuelle, représentée par une valeur comprise entre 0 et 23 inclus. Si cette valeur est 24, comme dans 24:13 (12:13 du matin le jour suivant), elle est convertie en 0.
HOUR_0_23_Z
Chaîne représentant la composante de 24 heures pour l'heure actuelle (de 00 à 23 inclus) utilisant le fuseau horaire actuel de l'appareil Wear OS. Si cette valeur est inférieure à 10, elle est précédée d'un zéro.
HOUR_0_23_MINUTE
Valeur à virgule flottante combinant les champs d'heure et de minutes d'un objet ZonedDateTime représentant l'heure actuelle. Cette valeur est toujours comprise entre 0.0 et $ 23 \frac{59}{60} $, inclus.
HOUR_1_24
Composante de 24 heures pour l'heure actuelle, représentée par une valeur comprise entre 1 et 24 inclus. Si cette valeur est 0, comme dans 0:12 (12:12 du matin, par exemple), cette valeur est convertie en 24.
HOUR_1_24_Z
Chaîne représentant la composante de 12 heures pour l'heure actuelle (de 01 à 24 inclus) utilisant le fuseau horaire actuel de l'appareil Wear OS. Si cette valeur est inférieure à 10, elle est précédée d'un zéro.
HOUR_1_24_MINUTE
Valeur à virgule flottante combinant un champ d'heure modifié et le champ de minutes d'un objet ZonedDateTime représentant l'heure actuelle. Cette valeur est toujours comprise entre 1.0 et $ 24 \frac{59}{60} $, inclus.
DAY
Valeur entière représentant le champ de jour d'un objet ZonedDateTime pour la date actuelle. Cette valeur est toujours comprise entre 1 et 31 inclus.
DAY_Z
Chaîne représentant le champ de jour d'un objet ZonedDateTime pour la date actuelle, avec des zéros au début pour obtenir une valeur de deux caractères. Cette valeur est toujours comprise entre 01 et 31 inclus.
DAY_HOUR
Valeur à virgule flottante qui combine les champs de jour du mois et d'heure d'un objet ZonedDateTime qui représente la date et l'heure actuelles. Cette valeur est toujours comprise entre 1.0 et $ 31 \frac{23}{24} $, inclus.
DAY_0_30
Version modifiée de la valeur getDayOfMonth() d'un objet ZonedDateTime représentant la date actuelle, soustraite de 1. Cette valeur est toujours comprise entre 0 et 30 inclus.
DAY_0_30_HOUR
Valeur à virgule flottante combinant un champ de jour modifié et le champ d'heure d'un objet ZonedDateTime représentant la date et l'heure actuelles. Cette valeur est toujours comprise entre 0.0 et $ 30 \frac{23}{24} $, inclus.
DAY_OF_YEAR
Nombre de jours qui ont commencé depuis le début de l'année civile. Cette valeur est toujours comprise entre 1 et 366 inclus, et a une valeur maximale de 365 pendant les années non bissextiles.
DAY_OF_WEEK
Version modifiée de la valeur getDayOfWeek() à partir d'un objet ZonedDateTime représentant la date actuelle. Le format du cadran attribue la valeur 1 au dimanche et la valeur 7 au samedi.
DAY_OF_WEEK_F
Jour actuel de la semaine, sous forme de chaîne complète (par exemple, Sunday et Monday).
DAY_OF_WEEK_S
Jour actuel de la semaine, sous forme de chaîne abrégée (par exemple, Sun et Mon).
MONTH
Valeur entière représentant le champ de mois d'un objet ZonedDateTime pour la date actuelle. Cette valeur est toujours comprise entre 1 et 12 inclus.
MONTH_Z
Chaîne représentant le champ de mois d'un objet ZonedDateTime pour la date actuelle, avec des zéros au début pour obtenir une valeur de deux caractères. Cette valeur est toujours comprise entre 01 et 12 inclus.
MONTH_F
Mois en cours de l'année, représenté par une chaîne complète (par exemple, January et December).
MONTH_S
Mois en cours de l'année, représenté par une chaîne abrégée (par exemple, Jan et Dec).
DAYS_IN_MONTH
Nombre de jours dans le mois en cours. Cette valeur est 28 ou 29 en février, 30 en avril, juin, septembre et novembre, et 31 pour tous les autres mois du calendrier grégorien.
MONTH_DAY
Valeur à virgule flottante combinant le champ de mois de l'année et le champ modifié de jour du mois d'un objet ZonedDateTime représentant la date actuelle. Cette valeur est toujours comprise entre 1.0 et $ 12 \frac{29}{30} $, inclus.
MONTH_0_11
Version modifiée de la valeur getMonthValue() à partir d'un objet ZonedDateTime représentant la date actuelle. Cette valeur attribue 0 à janvier et 11 à décembre.
MONTH_0_11_DAY
Valeur à virgule flottante combinant un champ modifié de mois de l'année et le champ modifié de jour du mois d'un objet ZonedDateTime représentant la date actuelle. Cette valeur est toujours comprise entre 0.0 et $ 11 \frac{29}{30} $, inclus.
YEAR
Valeur entière représentant le champ d'année d'un objet ZonedDateTime pour la date actuelle. Cette valeur est toujours comprise entre 1902 et 2100 inclus.
YEAR_S
Entier à deux chiffres représentant les deux derniers chiffres de l'année en cours. Par exemple, la valeur pour 2023 est 23.
YEAR_MONTH
Valeur à virgule flottante combinant le champ d'année et le champ modifié de jour du mois d'un objet ZonedDateTime représentant la date actuelle. Janvier 2023 est représenté par 2023.0 et décembre 2023 par $ 2023 \frac {11}{12} $.
YEAR_MONTH_DAY
Valeur à virgule flottante combinant le champ de l'année, un champ modifié de mois de l'année et le champ modifié de jour du mois d'un objet ZonedDateTime représentant la date actuelle. Le 1er janvier 2023 est représenté par2023.0, et le 31 décembre 2023 par $ 2023 \frac{11 \frac{29}{30}}{12} \approx 2023.9972 $.
WEEK_IN_MONTH
Entier qui reflète la valeur ALIGNED_WEEK_OF_MONTH d'un objet ChronoField représentant la date actuelle. Cette valeur est toujours comprise entre 0 et 5 inclus.
WEEK_IN_YEAR
Entier qui reflète la valeur ALIGNED_WEEK_OF_YEAR d'un objet ChronoField représentant la date actuelle. Cette valeur est toujours comprise entre 1 et 53 inclus.
IS_24_HOUR_MODE
Valeur booléenne équivalente à la valeur renvoyée actuelle pour is24HourFormat(), en fonction des paramètres régionaux et des préférences choisis par l'utilisateur.
IS_DAYLIGHT_SAVING_TIME
Valeur booléenne équivalente à l'appel de inDaylightTime() sur l'objet TimeZone pour les paramètres régionaux actuels, et à la transmission d'un objet Date qui contient l'heure actuelle. Indique si le fuseau horaire actuellement défini respecte désormais l'heure d'été.
TIMEZONE
Chaîne équivalant à l'appel de getDisplayName() sur l'objet TimeZone pour les paramètres régionaux actuels. Renvoie le nom complet du fuseau horaire, par exemple "Eastern Standard Time" pour le fuseau horaire de New York pendant l'hiver.
TIMEZONE_ABB
Chaîne équivalant à l'appel d'une version surchargée de getDisplayName() sur l'objet TimeZone pour les paramètres régionaux actuels, où le style donné est SHORT. Renvoie un nom de fuseau horaire abrégé, par exemple "EST" pour le fuseau horaire de New York pendant l'hiver.
TIMEZONE_ID
Chaîne équivalant à l'appel de getId() sur l'objet TimeZone pour les paramètres régionaux actuels. Renvoie une valeur d'ID de fuseau horaire de l'IANA, telle que America/New_York pour le fuseau horaire de New York.
TIMEZONE_OFFSET
Chaîne équivalant à l'appel de getRawOffset() sur l'objet TimeZone pour les paramètres régionaux actuels. Cette valeur est toujours comprise entre -12 et +14 inclus. Renvoie la valeur à ajouter à l'heure UTC pour obtenir l'heure standard pour le fuseau horaire actuel (non corrigée pour l'heure d'été).
TIMEZONE_OFFSET_DST
Chaîne équivalant à la transmission de la date actuelle en getOffset() sur l'objet TimeZone pour les paramètres régionaux actuels. Cette valeur est toujours comprise entre -12 et +14 inclus. Renvoie la valeur à ajouter à UTC pour obtenir l'heure locale actuelle, en prenant en compte l'heure d'été si nécessaire.
AMPM_STATE
Entier indiquant si l'heure actuelle est antérieure à midi, correspond à midi ou après midi. Les valeurs possibles sont 0 pour le matin et 1 pour l'après-midi.
AMPM_POSITION

Entier qui indique où l'indicateur AM ou PM doit apparaître dans une chaîne de temps. Contient l'une des valeurs suivantes :

  • 0 signifie qu'AM ou PM doit apparaître au début de la chaîne (par exemple, AM 12:03).
  • 1 signifie qu'AM ou PM doit apparaître à la fin de la chaîne, par exemple 12:03 AM.
  • -1 signifie que l'endroit où AM ou PM doit apparaître dans la chaîne est inconnu.
AMPM_STRING

Chaîne de deux caractères indiquant si l'heure actuelle correspond au matin ou à l'après-midi. La valeur est "AM" ou "PM".

Phase lunaire

Le format de cadran accepte les sources de données suivantes en fonction de la phase lunaire :

MOON_PHASE_POSITION
Valeur entière indiquant le nombre de jours ayant commencé depuis la dernière nouvelle lune. Cette valeur est toujours comprise entre 0 et 28 inclus.
MOON_PHASE_TYPE

Entier qui encode la phase lunaire actuelle. Les valeurs possibles sont les suivantes :

  • 0 pour la dernière nouvelle lune
  • 1 pour le premier croissant de lune
  • 2 pour le premier quartier de lune
  • 3 pour une lune gibbeuse croissante
  • 4 pour une pleine lune
  • 5 pour une lune gibbeuse décroissante
  • 6 pour le dernier quartier de lune
  • 7 pour le dernier croissant de lune
MOON_PHASE_TYPE_STRING

Chaîne représentant la phase lunaire actuelle. Les valeurs possibles sont les suivantes :

  • Nouvelle lune, lorsque moins de 0,5 jour s'est écoulé ou lorsque plus de 27,5 jours se sont écoulés depuis la dernière nouvelle lune.
  • Croissant du soir : au moins 0,5 jour, mais moins de 6,5 jours après la dernière nouvelle lune.
  • Premier quartier, lorsqu'au moins 6,5 jours, mais moins de 7,5 jours se sont écoulés depuis la dernière nouvelle lune.
  • Lune gibbeuse décroissante : au moins 7,5 jours mais moins de 13,5 jours se sont écoulés depuis la dernière nouvelle lune.
  • Pleine lune, lorsqu'au moins 13,5 jours, mais moins de 14,5 jours se sont écoulés depuis la dernière nouvelle lune.
  • Lune gibbeuse décroissante, lorsqu'au moins 14,5 jours, mais moins de 20,5 jours se sont écoulés depuis la dernière nouvelle lune.
  • Dernier quartier, lorsqu'au moins 20,5 jours, mais moins de 21,5 jours se sont écoulés depuis la dernière nouvelle lune.
  • Dernier croissant, lorsqu'au moins 21,5 jours, mais moins de 27,5 jours se sont écoulés depuis la dernière nouvelle lune.

Langue

Le format de cadran accepte les sources de données suivantes en fonction de la langue de l'utilisateur :

LANGUAGE_LOCALE_NAME
Chaîne représentant les paramètres régionaux actuels de l'appareil Wear OS, sous la forme d'un code de langue ISO 639-1 à deux caractères, un trait de soulignement et un code régional ISO 3166-1 à deux caractères. La variante anglophone pour les États-Unis est représentée par en_US.

Données de forme physique

Le format de cadran accepte les sources de données suivantes en fonction des données de forme physique de l'utilisateur :

STEP_COUNT
Nombre de pas que l'utilisateur a faits aujourd'hui, d'après les capteurs des appareils Wear OS.
STEP_GOAL
Nombre de pas que l'utilisateur a sélectionnés comme objectif de pas quotidien. Cette valeur n'est jamais inférieure à 1000.
STEP_PERCENT
Entier indiquant la progression de l'utilisateur vers son objectif de pas aujourd'hui, exprimée en pourcentage arrondi. Cette valeur est toujours comprise entre 0 et 100 inclus.
HEART_RATE
Fréquence cardiaque actuelle de l'utilisateur, d'après les capteurs de l'appareil Wear OS. Cette valeur est toujours comprise entre 0 et 240 inclus.
HEART_RATE_Z
Chaîne représentant la fréquence cardiaque de l'utilisateur selon les capteurs d'appareil Wear OS. Cette valeur est complétée par des zéros à gauche pour obtenir une valeur d'au moins deux caractères. Par conséquent, si la fréquence cardiaque mesurée de l'utilisateur est de 65, cette valeur sera 65. Si la fréquence cardiaque mesurée de l'utilisateur est de 0, cette valeur sera 00.

Capteurs de l'appareil

Le format de cadran accepte les sources de données suivantes en fonction des capteurs de l'appareil :

ACCELEROMETER_IS_SUPPORTED
Valeur booléenne indiquant si le cadran peut obtenir des données de l'accéléromètre à partir des capteurs de l'appareil Wear OS actuel.
ACCELEROMETER_X
Valeur à virgule flottante qui indique l'accélération linéaire actuelle sur l'axe X, selon l'accéléromètre de l'appareil Wear OS. Les valeurs positives indiquent que, lorsque le cadran pointe vers le ciel ou le plafond, l'appareil Wear OS accélère vers la droite.
ACCELEROMETER_Y
Valeur à virgule flottante qui indique l'accélération linéaire actuelle sur l'axe Y, selon l'accéléromètre de l'appareil Wear OS. Les valeurs positives indiquent que, lorsque le cadran pointe vers le ciel ou le plafond, l'appareil Wear OS accélère dans la direction de 12 heures (en haut) le long du cadran.
ACCELEROMETER_Z

Valeur à virgule flottante qui indique l'accélération linéaire actuelle sur l'axe Z, selon l'accéléromètre de l'appareil Wear OS. Les valeurs positives indiquent que, lorsque le cadran pointe vers le ciel ou le plafond, l'appareil Wear OS accélère vers le ciel ou le plafond.

ACCELEROMETER_ANGLE_X

Valeur à virgule flottante qui indique l'accélération angulaire actuelle, en degrés, par rapport à l'axe X. Cette valeur est toujours comprise dans la plage $ [-90,0, 90,0 $].

ACCELEROMETER_ANGLE_Y

Valeur à virgule flottante qui indique l'accélération angulaire actuelle, en degrés, par rapport à l'axe Y. Cette valeur est toujours comprise dans la plage $ [-90,0, 90,0 $].

ACCELEROMETER_ANGLE_Z

Valeur à virgule flottante qui indique l'accélération angulaire actuelle, en degrés, par rapport à l'axe Z. Cette valeur est toujours comprise dans la plage $ [-90,0, 90,0 $].

ACCELEROMETER_ANGLE_XY

Valeur à virgule flottante correspondant à la somme de ACCELEROMETER_ANGLE_X et ACCELEROMETER_ANGLE_Y

Batterie de l'appareil

Le format de cadran accepte les sources de données suivantes en fonction de l'état actuel de la batterie de l'appareil :

BATTERY_PERCENT
Entier indiquant la charge actuelle de la batterie de l'appareil Wear OS, exprimée en pourcentage. La valeur 100 indique que la batterie est complètement chargée. La valeur 0 indique que le niveau de la batterie est très faible.
BATTERY_CHARGING_STATUS
Valeur booléenne indiquant si la batterie de l'appareil Wear OS est en charge. Si la batterie est complètement chargée, cette valeur indique true.
BATTERY_IS_LOW
Valeur booléenne indiquant si la batterie de l'appareil Wear OS est faible. Le seuil exact dépend du fabricant. Si la batterie est en charge, cette valeur indique false.
BATTERY_TEMPERATURE_CELSIUS
Valeur à virgule flottante qui indique la température de la batterie de l'appareil Wear OS, en degrés Celsius. Pour obtenir cette valeur, la valeur de température brute de la batterie, en dixièmes de degré Celsius, est divisée par 10.
BATTERY_TEMPERATURE_FAHRENHEIT
Valeur à virgule flottante qui indique la température de la batterie de l'appareil Wear OS, en degrés Fahrenheit. Il s'agit d'une conversion à partir des degrés Celsius.

Notifications

Le format de cadran est compatible avec la source de données suivante liée aux notifications de l'appareil :

UNREAD_NOTIFICATION_COUNT
Chaîne représentant le nombre de notifications envoyées à cet appareil Wear OS et que l'utilisateur n'a pas encore lues.