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 se recharger, ou aux appareils qui peuvent charger un autre appareil.

ATTRIBUTS D'appareils

Les appareils présentant cette caractéristique peuvent signaler les éléments suivants : dans le cadre de l'opération SYNC. Pour apprendre Pour en savoir plus sur la gestion des intents SYNC, consultez Traitement des intents.

Attributs	Type	Description
queryOnlyEnergyStorage	Valeur booléenne	Obligatoire. "True" si cet appareil n'accepte 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éfini sur "true" si cet appareil est rechargeable. Cela indique que l'appareil peut indiquer l'état capacityUntilFull, isCharging et éventuellement 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 permettant uniquement de signaler le niveau de facturation actuel

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

STATES de l'appareil

Les entités présentant cette caractéristique peuvent signaler les éléments suivants : dans le cadre de l'opération QUERY. Pour apprendre 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 option est utilisée lorsqu'il n'existe pas 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, dans la mesure du 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 de kilomètres mon <device> actuellement ou Quel est le pourcentage de charge de mon <device> ont
[item, ...]	Objet	Capacité restante dans la paire unité/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: Combien de temps reste-t-il avant <device> est complètement chargée.
[item, ...]	Objet	Capacité avant charge
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 en charge.
isPluggedIn	Valeur booléenne	Indique si l'appareil est actuellement branché. L'appareil peut être branché, mais ne se recharge pas 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 permettant uniquement de signaler le niveau de facturation actuel

{
  "descriptiveCapacityRemaining": "LOW"
}

COMMANDS d'appareils

Les appareils présentant cette caractéristique peuvent répondre aux éléments suivants : dans le cadre de l'opération EXECUTE. Pour apprendre 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	Valeur booléenne	Obligatoire. "True" pour commencer la recharge, "false" pour arrêter la recharge.

Exemples

Lancer la commande de recharge

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

Commande permettant d'arrêter la recharge

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

Erreurs d'appareil

Voir la liste complète les erreurs et les exceptions.

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