Bienvenue dans le Centre des développeurs Google Home, la nouvelle destination pour apprendre à développer des actions pour la maison connectée. Remarque : Vous continuerez à créer des actions dans la console Actions.
Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Schéma des caractéristiques de transaction StateState pour les maisons connectées

action.devices.traits.SensorState : cette caractéristique couvre à la fois la mesure quantitative et l'état qualitatif.

Appareil : ATTRIBUTES

Les appareils associés à cette caractéristique peuvent signaler les attributs suivants dans le cadre de l'opération SYNC. Pour en savoir plus sur la gestion des intents SYNC, consultez la page Traitement des intents.

Attributs Type Description
sensorStatesSupported Array

Obligatoire.

Chaque objet représente les fonctionnalités d'état des capteurs compatibles avec cet appareil. Chaque capteur doit être doté d'une capacité au moins descriptive ou numérique. Les capteurs peuvent également signaler les deux, auquel cas la valeur numérique sera privilégiée.

[item, ...] Objet

Fonctionnalités de capteurs compatibles.

Nécessite au moins un article.

name Chaîne

Obligatoire.

Type de capteur compatible. Consultez le tableau "Capteurs compatibles".

descriptiveCapabilities Objet

Description des fonctionnalités du capteur.

availableStates Array

Obligatoire.

Liste des états disponibles pour l'appareil. L'état "inconnu" est implicitement accepté lorsque le capteur ne renvoie pas de valeur.

[item, ...] Chaîne

Valeur d'état descriptif acceptée.

Nécessite au moins un article.

numericCapabilities Objet

Description des valeurs numériques possibles que le capteur peut signaler.

rawValueUnit Chaîne

Obligatoire.

Unité numérique acceptée.

Pour en savoir plus sur les différentes fonctionnalités et différents types de capteurs compatibles avec cette caractéristique, consultez la page Capteurs compatibles.

Exemples

Capteur qui indique une valeur descriptive de l'état.

{
  "sensorStatesSupported": [
    {
      "name": "AirQuality",
      "descriptiveCapabilities": {
        "availableStates": [
          "healthy",
          "moderate",
          "unhealthy",
          "very unhealthy"
        ]
      }
    }
  ]
}

Capteur qui indique une valeur d'état numérique.

{
  "sensorStatesSupported": [
    {
      "name": "CarbonMonoxideLevel",
      "numericCapabilities": {
        "rawValueUnit": "PARTS_PER_MILLION"
      }
    }
  ]
}

Capteur qui indique une valeur descriptive et numérique d'état.

{
  "sensorStatesSupported": [
    {
      "name": "SmokeLevel",
      "numericCapabilities": {
        "rawValueUnit": "PARTS_PER_MILLION"
      },
      "descriptiveCapabilities": {
        "availableStates": [
          "smoke detected",
          "high",
          "no smoke detected"
        ]
      }
    }
  ]
}

Capteurs compatibles

Les tableaux suivants répertorient les types de capteurs compatibles et les fonctionnalités qui leur sont associées.

Qualité de l'air

Nom Fonctionnalités de description Capacités numériques

Valeurs acceptées :

AirQuality

Valeurs acceptées :

healthy
moderate
unhealthy
unhealthy for sensitive groups
very unhealthy
hazardous
good
fair
poor
very poor
severe
unknown

Valeurs acceptées :

AQI

Monoxyde de carbone

Nom Fonctionnalités de description Capacités numériques

Valeurs acceptées :

CarbonMonoxideLevel

Valeurs acceptées :

carbon monoxide detected
high
no carbon monoxide detected
unknown

Valeurs acceptées :

PARTS_PER_MILLION

Niveau de fumée

Nom Fonctionnalités de description Capacités numériques

Valeurs acceptées :

SmokeLevel

Valeurs acceptées :

smoke detected
high
no smoke detected
unknown

Valeurs acceptées :

PARTS_PER_MILLION

Nettoyage des filtres

Nom Fonctionnalités de description Capacités numériques

Valeurs acceptées :

FilterCleanliness

Valeurs acceptées :

clean
dirty
needs replacement
unknown
Non compatible.

Fuite d'eau

Nom Fonctionnalités de description Capacités numériques

Valeurs acceptées :

WaterLeak

Valeurs acceptées :

leak
no leak
unknown
Non compatible.

Détection de pluie

Nom Fonctionnalités de description Capacités numériques

Valeurs acceptées :

RainDetection

Valeurs acceptées :

rain detected
no rain detected
unknown
Non compatible.

Durée de vie du filtre

Nom Fonctionnalités de description Capacités numériques

Valeurs acceptées :

FilterLifeTime

Valeurs acceptées :

new
good
replace soon
replace now
unknown

Valeurs acceptées :

PERCENTAGE

Durée de vie du filtre calculé

Nom Fonctionnalités de description Capacités numériques

Valeurs acceptées :

PreFilterLifeTime
HEPAFilterLifeTime
Max2FilterLifeTime
Non compatible.

Valeurs acceptées :

PERCENTAGE

Niveau de dioxyde de carbone

Nom Fonctionnalités de description Capacités numériques

Valeurs acceptées :

CarbonDioxideLevel
Non compatible.

Valeurs acceptées :

PARTS_PER_MILLION

Maturité particulaire

Nom Fonctionnalités de description Capacités numériques

Valeurs acceptées :

PM2.5
PM10
Non compatible.

Valeurs acceptées :

MICROGRAMS_PER_CUBIC_METER

composés organiques volatils

Nom Fonctionnalités de description Capacités numériques

Valeurs acceptées :

VolatileOrganicCompounds
Non compatible.

Valeurs acceptées :

PARTS_PER_MILLION

Appareil : STATES

Les entités présentant 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 page Traitement des intents.

États Type Description
currentSensorStateData Array

Obligatoire.

Liste des états actuels des capteurs.

[item, ...] Objet

État actuel du capteur.

name Chaîne

Obligatoire.

Nom de l'état du capteur. Correspond à une valeur de sensorStatesSupported.

currentSensorState Chaîne

Valeur actuelle de l'état descriptif. Correspond à une valeur de sensorStatesSupported.

rawValue Number

Valeur actuelle du capteur numérique.

Pour en savoir plus sur les différentes fonctionnalités et différents types de capteurs compatibles avec cette caractéristique, consultez la page Capteurs compatibles.

Exemples

Capteur qui indique une valeur descriptive de l'état.

{
  "currentSensorStateData": [
    {
      "name": "AirQuality",
      "currentSensorState": "healthy"
    }
  ]
}

Capteur qui indique une valeur d'état numérique.

{
  "currentSensorStateData": [
    {
      "name": "CarbonMonoxideLevel",
      "rawValue": 200
    }
  ]
}

Capteur qui indique une valeur descriptive et numérique d'état.

{
  "currentSensorStateData": [
    {
      "name": "SmokeLevel",
      "currentSensorState": "smoke detected",
      "rawValue": 200
    }
  ]
}

Appareil COMMANDS

Aucune.

NOTIFICATIONS de l'appareil

Les appareils dotés de cette caractéristique peuvent renvoyer la charge utile de notification suivante dans le cadre d'un changement d'état d'un appareil. Pour en savoir plus sur l'implémentation des notifications, consultez Notifications pour les actions de maison connectée.

Champs Type Description
SensorState Objet

Obligatoire.

Charge utile de la notification.

priority Entier

Obligatoire.

Représente le niveau de notification. La valeur actuellement acceptée est 0, ce qui indique que la notification doit être lue à voix haute.

name Chaîne

Obligatoire.

Nom de l'état du capteur. Consultez la liste des types de capteurs compatibles pour les notifications.

currentSensorState Chaîne

Obligatoire.

Valeur actuelle de l'état descriptif. Consultez la liste des types de capteurs compatibles pour les notifications.

La charge utile de la notification peut contenir les types de capteurs suivants:

  • AirQuality
  • CarbonMonoxideLevel
  • SmokeLevel
  • FilterCleanliness
  • WaterLeak
  • RainDetection
  • FilterLifeTime

Pour en savoir plus sur les différentes fonctionnalités compatibles avec chaque type de capteur, consultez la page Capteurs compatibles.

Exemples

Le détecte de la fumée.

{
  "SensorState": {
    "priority": 0,
    "name": "SmokeLevel",
    "currentSensorState": "high"
  }
}

Erreurs liées à l'appareil

Consultez la liste complète des erreurs et exceptions.