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 |
energyStorageDistanceUnitForUX |
Chaîne |
(Par défaut : Sera utilisé dans les réponses à l'utilisateur. Valeurs acceptées :
|
isRechargeable |
Booléen |
(Par défaut : Défini sur "true" si cet appareil est rechargeable. Cela indique que l'appareil peut signaler l'état |
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 :
|
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 :
|
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 :
|
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é.