Schéma du rapport d'état de la maison connectée

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

Un appareil spécifique peut signaler son état actuel, ainsi que l'état de tous les appareils associés au sein d'un groupe. Par exemple, l'appareil cible peut être un système de sécurité dont les appareils associés représentent des capteurs individuels. StatusReport sert d'agrégation pour la création de rapports sur l'état collectif, mais ne remplace pas les adressages individuels. Tout appareil auquel l'Assistant Google peut accéder doit être signalé en tant qu'appareil distinct dans la réponse SYNC.

Attributs d'appareil

Aucun.

Device STATES

Les entités dotées de cette caractéristique peuvent signaler les états suivants dans le cadre de l'opération QUERY. Pour en savoir plus sur la gestion des intents QUERY, consultez la section Traitement des intents.

États Type Description
currentStatusReport Array

Obligatoire.

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

[item, ...] Objet

État actuel.

blocking Booléen

"True" si l'erreur ou l'état actuel bloque l'exécution des autres commandes.

deviceTarget String

ID de l'appareil cible.

priority Entier

Spécifie la priorité de cet état. Plus la valeur est faible, plus la priorité est élevée (la priorité la plus élevée étant 0). Google signale l'état d'erreur ou d'exception, de la priorité la plus haute à la plus basse. Selon la surface, Google peut ne signaler que les erreurs ou les exceptions à priorité élevée.

statusCode String

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

Exemples

Mon système de sécurité est-il en bon état ?

{
  "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"
    }
  ]
}

COMMANDS d'appareil

Aucun.

ERREURS sur l'appareil

Consultez la liste complète des erreurs et exceptions.