Schéma du trait de stockage énergétique de la maison connectée

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

Attributs d'appareil

Les appareils dotés de 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 section Traitement des intents.

Attributs Type Description
queryOnlyEnergyStorage Booléen

Obligatoire.

"True" si cet appareil n'accepte que les requêtes sur les niveaux d'énergie stockées et, éventuellement, sur l'état de charge actif (en fonction de l'attribut isRechargeable), mais ne prend pas en charge le démarrage et l'arrêt de la charge.

energyStorageDistanceUnitForUX Chaîne

(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 l'état capacityUntilFull, isCharging et éventuellement isPluggedIn, et 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 uniquement compatible avec le signalement du niveau de charge actuel

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

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
descriptiveCapacityRemaining Chaîne

Obligatoire.

Description qualitative du niveau de capacité énergétique. Notez que cette option s'applique en l'absence de données numériques de capacité. Si des données numériques de capacité sont également disponibles, elles sont privilégiées aux données descriptives lorsque cela est possible.

Valeurs acceptées :

CRITICALLY_LOW
LOW
MEDIUM
HIGH
FULL
capacityRemaining Array

Tableau de paires unité/valeur contenant des informations sur la capacité énergétique actuelle de l'appareil. Par exemple: Combien y a-t-il de kilomètres parcourus sur mon <device> ? ou Quel est le pourcentage de charge de mon <device> ?

[item, ...] Objet

Capacité restante en paire unité/valeur.

rawValue Entier

Obligatoire.

Valeur de la capacité.

unit Chaîne

Obligatoire.

Unité de capacité.

Valeurs acceptées :

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
capacityUntilFull Array

Tableau de paires unité/valeur contenant des informations sur la capacité jusqu'à ce que l'appareil soit complètement chargé. Par exemple: Temps restant avant que <device> soit complètement chargé.

[item, ...] Objet

Capacité jusqu'à la charge.

rawValue Entier

Obligatoire.

Valeur de la capacité.

unit Chaîne

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.

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

COMMANDS d'appareil

Les appareils dotés 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 la section Traitement des intents.

action.devices.commands.Charge

Démarrer ou arrêter la recharge.

Cette commande nécessite les attributs suivants :
{
  "isRechargeable": true
}

Paramètres

Paramètres Type Description
charge Booléen

Obligatoire.

"True" pour commencer la charge, "false" pour arrêter la recharge.

Exemples

Commande "Commencer à charger"

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

Commande "Arrêter la recharge"

{
  "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é.