Schéma du trait StatusReport pour la maison connectée

action.devices.traits.StatusReport : ce trait indique l'état actuel d'un appareil spécifique ou d'un groupe d'appareils connectés.

Un appareil spécifique peut indiquer son état actuel, ainsi que celui de tous les appareils associés d'un groupe. Par exemple, l'appareil cible peut être un système de sécurité, et les appareils associés peuvent représenter des capteurs individuels. StatusReport sert d'agrégation pour indiquer l'état collectif, mais ne remplace pas l'adressage individuel. Tout appareil accessible par l'Assistant Google doit être indiqué comme un appareil distinct dans la SYNC réponse.

ATTRIBUTS de l'appareil

Aucune.

ÉTATS de l'appareil

Les entités avec ce trait peuvent indiquer les états suivants dans le cadre de l'opération QUERY. Pour en savoir plus sur la gestion des intents QUERY, consultez Exécution des intents.

États Type Description
currentStatusReport Array

Obligatoire.

États d'erreur ou d'exception actuels de l'appareil et de tous les ID d'appareils associés.

[item, ...] Objet

État actuel.

blocking Valeur booléenne

Vrai si l'erreur ou l'état actuel empêche l'exécution d'autres commandes.

deviceTarget String

ID de l'appareil cible.

priority Entier

Indique la priorité de cet état. Plus la valeur est faible, plus la priorité est élevée. La priorité la plus élevée est 0. Google indique l'état d'erreur ou d'exception de la priorité la plus élevée à la plus faible. Selon la surface, Google peut n'indiquer que les erreurs ou exceptions de haute priorité.

Valeur minimale : 0.

statusCode String

État actuel de l'appareil. Consultez la liste complète des erreurs et exceptions.

Exemples

Mon système de sécurité fonctionne-t-il ?

{
  "currentStatusReport": [
    {
      "blocking": false,
      "deviceTarget": "alarm_1",
      "priority": 0,
      "statusCode": "lowBattery"
    },
    {
      "blocking": false,
      "deviceTarget": "front_window_1",
      "priority": 1,
      "statusCode": "deviceOpen"
    },
    {
      "blocking": false,
      "deviceTarget": "back_window_2",
      "priority": 1,
      "statusCode": "deviceOpen"
    },
    {
      "blocking": true,
      "deviceTarget": "alarm_2",
      "priority": 0,
      "statusCode": "needsSoftwareUpdate"
    }
  ]
}

COMMANDES de l'appareil

Aucune.

ERREURS de l'appareil

Consultez la liste complète des erreurs et exceptions.