Schéma du Trait d'énergie pour la maison connectée

action.devices.traits.EnergyStorage : cette caractéristique est liée aux appareils qui peuvent stocker de l'énergie dans une batterie et, éventuellement, à la recharge, ou aux appareils qui peuvent charger un autre appareil.

ATTRIBUTS de l'appareil

Les appareils disposant de cette caractéristique peuvent signaler les attributs suivants lors de l'opération SYNC. Pour en savoir plus sur la gestion des intents SYNC, consultez Traitement des intents.

Attributs	Type	Description
queryOnlyEnergyStorage	Booléen	Obligatoire. Vrai si cet appareil n'est compatible qu'avec les requêtes sur les niveaux d'énergie stockés et, éventuellement, sur l'état de charge active (selon l'attribut isRechargeable), mais qu'il n'est pas compatible avec le démarrage et l'arrêt de la recharge.
energyStorageDistanceUnitForUX	String	(Par défaut : "KILOMETERS") Sera utilisé dans les réponses à l'utilisateur. Valeurs acceptées : KILOMETERS MILES
isRechargeable	Booléen	(Par défaut : false) Défini sur "true" si cet appareil est rechargeable. Cela indique que l'appareil peut signaler capacityUntilFull, isCharging et éventuellement l'état isPluggedIn, et qu'il peut accepter la commande Charge.

Exemples

Appareil rechargeable

{
  "isRechargeable": true,
  "queryOnlyEnergyStorage": false
}

Appareil rechargeable affichant le niveau de charge actuel en miles

{
  "isRechargeable": true,
  "energyStorageDistanceUnitForUX": "MILES",
  "queryOnlyEnergyStorage": false
}

Appareil non rechargeable qui ne permet de générer des rapports que sur le niveau de charge actuel

{
  "isRechargeable": false,
  "queryOnlyEnergyStorage": true
}

Appareil 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 Traitement des intents.

États	Type	Description
descriptiveCapacityRemaining	String	Obligatoire. Description qualitative du niveau de capacité énergétique. Notez que cette valeur est utilisée en l'absence de données de capacité numérique. Si des données numériques sur la capacité sont également disponibles, elles seront privilégiées plutôt que descriptives lorsque cela est possible. Valeurs acceptées : CRITICALLY_LOW LOW MEDIUM HIGH FULL
capacityRemaining	Array	Tableau de paires unité/valeur qui contiennent des informations sur la capacité énergétique actuelle de l'appareil. Par exemple: Combien de kilomètres dispose de mon <device> ou Quel est le pourcentage de facturation de mon <device>
[item, ...]	Objet	Capacité restante en paire unité/valeur.
rawValue	Entier	Obligatoire. Valeur de capacité.
unit	String	Obligatoire. Unité de capacité. Valeurs acceptées : SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
capacityUntilFull	Array	Tableau de paires unité/valeur qui contiennent des informations sur la capacité jusqu'à ce que l'appareil soit complètement chargé. Par exemple: Combien de temps reste-t-il jusqu'à la recharge complète de <device> ?
[item, ...]	Objet	Capacité jusqu'à la charge complète.
rawValue	Entier	Obligatoire. Valeur de capacité.
unit	String	Obligatoire. Unité de capacité. Valeurs acceptées : SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
isCharging	Booléen	Indique si l'appareil est en charge.
isPluggedIn	Booléen	Indique si l'appareil est actuellement branché. L'appareil peut être branché, mais pas en charge activement.

Exemples

Appareil rechargeable

{
  "descriptiveCapacityRemaining": "HIGH",
  "capacityRemaining": [
    {
      "rawValue": 36000,
      "unit": "SECONDS"
    },
    {
      "rawValue": 90,
      "unit": "PERCENTAGE"
    }
  ],
  "capacityUntilFull": [
    {
      "rawValue": 120,
      "unit": "SECONDS"
    }
  ],
  "isCharging": true,
  "isPluggedIn": true
}

Appareil rechargeable affichant le niveau de charge actuel en miles

{
  "descriptiveCapacityRemaining": "CRITICALLY_LOW",
  "capacityRemaining": [
    {
      "rawValue": 12,
      "unit": "MILES"
    }
  ],
  "capacityUntilFull": [
    {
      "rawValue": 6000,
      "unit": "SECONDS"
    }
  ],
  "isCharging": true,
  "isPluggedIn": true
}

Appareil non rechargeable qui ne permet de signaler que le niveau de charge actuel

{
  "descriptiveCapacityRemaining": "LOW"
}

Appareil COMMANDS

Les appareils disposant de cette caractéristique peuvent répondre aux commandes suivantes dans le cadre de l'opération EXECUTE. Pour en savoir plus sur la gestion des intents EXECUTE, consultez Traitement des intents.

action.devices.commands.Charge

Démarrez ou arrêtez la recharge.

Cette commande nécessite les attributs suivants :

{
  "isRechargeable": true
}

Paramètres

Paramètres	Type	Description
charge	Booléen	Obligatoire. Vrai pour démarrer la charge, faux pour arrêter la charge.

Exemples

Lancer la commande pour recharger la batterie

{
  "command": "action.devices.commands.Charge",
  "params": {
    "charge": true
  }
}

Arrêter la commande de charge

{
  "command": "action.devices.commands.Charge",
  "params": {
    "charge": false
  }
}

ERREURS sur l'appareil

Consultez la liste complète des erreurs et exceptions.

deviceUnplugged: l'utilisateur a essayé de charger un appareil qui n'est pas branché.