Guide du chargeur pour la maison connectée
action.devices.types.CHARGER
: les interactions avec les chargeurs peuvent inclure le démarrage et l'arrêt de la charge, et la vérification du niveau de charge actuel, de la capacité restante et de la capacité restante jusqu'à ce que les valeurs soient pleines.
Ce type indique que l'appareil obtient l'icône Chargeur, ainsi que certains synonymes et alias associés.
Fonctionnalités de l'appareil
Reportez-vous à la documentation sur les fonctionnalités correspondantes pour obtenir des détails sur l'implémentation, tels que les attributs et les états que votre service doit prendre en charge, et pour découvrir comment créer des réponses EXECUTE et QUERY.
Traits obligatoires
Ces traits et commandes sont requis, le cas échéant. Si votre appareil n'est pas compatible avec ces traits, saisissez le code d'erreur de functionNotSupported
dans une réponse QUERY ou EXECUTE. Pour en savoir plus, consultez la section Erreurs et exceptions.
Exigences de qualité
- La latence doit être inférieure ou égale à 800 ms.
- Fiabilité: la valeur doit être supérieure ou égale à 97%.
Exemple d'appareil: chargeur simple
Cette section contient des exemples de charges utiles d'intent représentant un "chargeur" courant en fonction du type d'appareil et des caractéristiques décrites ci-dessus. Si vous ajoutez ou supprimez des caractéristiques dans votre implémentation, modifiez vos réponses en conséquence pour refléter ces modifications.
Exemple de réponse SYNC
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.CHARGER", "traits": [ "action.devices.traits.EnergyStorage" ], "name": { "name": "Simple charger" }, "willReportState": true, "attributes": { "isRechargeable": true, "queryOnlyEnergyStorage": false }, "deviceInfo": { "manufacturer": "smart-home-inc", "model": "hs1234", "hwVersion": "3.2", "swVersion": "11.4" } } ] } }
Exemple de réponse QUERY
{ "requestId": "6894439706274654514", "inputs": [ { "intent": "action.devices.QUERY", "payload": { "devices": [ { "id": "123" } ] } } ] }
{ "requestId": "6894439706274654514", "payload": { "devices": { "123": { "status": "SUCCESS", "online": true, "descriptiveCapacityRemaining": "MEDIUM", "capacityRemaining": [ { "unit": "PERCENTAGE", "rawValue": 50 } ], "capacityUntilFull": [ { "unit": "SECONDS", "rawValue": 3600 } ], "isCharging": true } } } }
Exemples de commandes EXECUTE
Charge
Pour en savoir plus sur les paramètres de la commande, consultez la documentation de référence sur
action.devices.traits.EnergyStorage
.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.Charge", "params": { "charge": false } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "capacityRemaining": [ { "unit": "PERCENTAGE", "rawValue": 50 } ], "isCharging": false } } ] } }