Schéma de trait EnergyStorage pour la maison connectée

action.devices.traits.EnergyStorage : cette caractéristique appartient aux appareils pouvant stocker de l'énergie dans une batterie et éventuellement se recharger, ou aux appareils pouvant recharger un autre appareil.

ATTRIBUTS de l'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 Valeur booléenne

Obligatoire.

"True" si cet appareil ne prend en charge que les requêtes sur les niveaux d'énergie stockés et, éventuellement, l'état de charge actif (en fonction de l'attribut isRechargeable), mais ne permet pas de démarrer et d'arrêter la recharge.
energyStorageDistanceUnitForUX String

(Par défaut : "KILOMETERS")

Sera utilisé dans les réponses envoyées à l'utilisateur.

Valeurs acceptées :

KILOMETERS
MILES
isRechargeable Valeur booléenne

(Par défaut : false)

Définissez cette valeur sur "true" si cet appareil est rechargeable. Cela indique que l'appareil peut signaler l'état capacityUntilFull, isCharging et éventuellement isPluggedIn, et qu'il peut accepter la commande Charge.

Exemples

Appareil rechargeable

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

Appareil rechargeable qui affiche le niveau de charge actuel en miles

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

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

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

ÉTATS DE L'APPAREIL

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

États Type Description
descriptiveCapacityRemaining String

Obligatoire.

Description qualitative du niveau de capacité énergétique. Notez que cette valeur s'applique lorsque les données de capacité numérique ne sont pas disponibles. Si des données numériques sur la capacité sont également disponibles, elles seront privilégiées plutôt que descriptives, dans la mesure du possible.

Valeurs acceptées :

CRITICALLY_LOW
LOW
MEDIUM
HIGH
FULL
capacityRemaining Array

Tableau de paires d'unité/valeur contenant des informations sur la capacité énergétique actuelle de l'appareil. Par exemple : Combien de kilomètres mon <appareil> a-t-il actuellement parcouru ? ou Quel est le pourcentage de charge de mon <appareil> ?
[item, ...] Objet

Capacité restante sous forme de paire d'unité et de valeur.
rawValue Entier

Obligatoire.

Valeur de la capacité.
unit String

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 la charge complète de l'appareil <device>
[item, ...] Objet

Capacité jusqu'à la recharge.
rawValue Entier

Obligatoire.

Valeur de la capacité.
unit String

Obligatoire.

Unité de capacité.

Valeurs acceptées :

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
isCharging Valeur booléenne

Indique si l'appareil est actuellement en charge.
isPluggedIn Valeur booléenne

Indique si l'appareil est actuellement branché. L'appareil peut être branché, mais ne se recharge pas.

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

COMMANDES DE L'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émarrez ou arrêtez la recharge.

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

Paramètres

Paramètres Type Description
charge Valeur booléenne

Obligatoire.

"True" pour démarrer la recharge, "false" pour arrêter la recharge.

Exemples

Lancer la commande de recharge

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

Commande d'arrêt de la recharge

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

ERREURS de l'appareil

Consultez la liste complète des erreurs et exceptions.

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