Guide du lave-linge pour maison connectée
action.devices.types.WASHER : les fonctionnalités de démarrage et d'arrêt des lave-linge peuvent être lancées ou arrêtées indépendamment du mode activé ou éteint (certains lave-linge sont équipés d'un bouton Marche/Arrêt séparé, d'autres non). Certaines peuvent être mises en pause et réactivées pendant le lavage.
Les lave-linge disposent également de différents modes, chacun étant associé à ses propres paramètres. Ils sont spécifiques au lave-linge et sont interprétés de façon généralisée.
Ce type indique que l'appareil dispose de l'icône Lave-linge et d'autres des synonymes et des alias.
Pour voir un exemple illustrant comment contrôler un lave-linge avec la maison connectée Google, consultez le atelier de programmation lave-linge connecté.
Fonctionnalités de l'appareil
Reportez-vous à la documentation des caractéristiques correspondantes pour les détails de mise en œuvre, tels que les attributs et les états que votre service doit prendre en charge, et comment créer des réponses EXECUTE et QUERY.
Caractéristiques requises
Ces caractéristiques et commandes sont nécessaires, s'il s'agit
appareil. Si votre appareil ne prend pas en charge ces caractéristiques, saisissez le code d'erreur de
functionNotSupported dans une réponse QUERY ou EXECUTE. Voir
Erreurs et exceptions.
Caractéristiques recommandées
Ces caractéristiques sont recommandées, si elles s'appliquent à votre appareil. Cependant, vous êtes libre de combiner toutes les caractéristiques disponibles pour les faire correspondre au mieux la fonctionnalité du produit.
-
action.devices.traits.Modes -
action.devices.traits.OnOff -
action.devices.traits.RunCycle -
action.devices.traits.Toggles
Exigences de qualité
- Latence:la latence doit être inférieure ou égale à 3 000 ms.
- La fiabilité doit être supérieure ou égale à 97%.
Exemple d'appareil: lave-linge simple
Cette section contient des exemples de charges utiles d'intent représentant un "laveur" commun en fonction du type d'appareil et des caractéristiques 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 changements.
Exemple de réponse SYNC
<ph type="x-smartling-placeholder">{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.WASHER", "traits": [ "action.devices.traits.OnOff", "action.devices.traits.RunCycle", "action.devices.traits.StartStop", "action.devices.traits.Modes" ], "name": { "name": "Simple washer" }, "willReportState": true, "attributes": { "availableModes": [ { "name": "load_key", "name_values": [ { "name_synonym": [ "Load", "Size", "Load size" ], "lang": "en" } ], "settings": [ { "setting_name": "small_key", "setting_values": [ { "setting_synonym": [ "Small", "Half" ], "lang": "en" } ] }, { "setting_name": "large_key", "setting_values": [ { "setting_synonym": [ "Large", "Full" ], "lang": "en" } ] } ], "ordered": true } ], "pausable": true }, "deviceInfo": { "manufacturer": "smart-home-inc", "model": "hs1234", "hwVersion": "3.2", "swVersion": "11.4" } } ] } }
Exemple de réponse QUERY
<ph type="x-smartling-placeholder">{ "requestId": "6894439706274654514", "inputs": [ { "intent": "action.devices.QUERY", "payload": { "devices": [ { "id": "123" } ] } } ] }
{ "requestId": "6894439706274654514", "payload": { "devices": { "123": { "status": "SUCCESS", "online": true, "on": true, "isRunning": true, "isPaused": false, "currentRunCycle": [ { "currentCycle": "rinse", "nextCycle": "spin", "lang": "en" } ], "currentTotalRemainingTime": 600, "currentCycleRemainingTime": 300, "currentModeSettings": { "load_key": "small_key" } } } } }
Exemples de commandes EXECUTE
OnOff
Pour en savoir plus sur
les paramètres de commande,
consultez les
action.devices.traits.OnOff
référence.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OnOff", "params": { "on": true } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "on": true } } ] } }
StartStop
Pour en savoir plus sur
les paramètres de commande,
consultez les
action.devices.traits.StartStop
référence.
{ "requestId": "6894439706274654518", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.StartStop", "params": { "start": true } } ] } ] } } ] }
{ "requestId": "6894439706274654518", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "isRunning": true, "isPaused": false } } ] } }
SetModes
Pour en savoir plus sur
les paramètres de commande,
consultez les
action.devices.traits.Modes
référence.
{ "requestId": "6894439706274654522", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.SetModes", "params": { "updateModeSettings": { "load_key": "large_key" } } } ] } ] } } ] }
{ "requestId": "6894439706274654522", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "currentModeSettings": { "load_key": "large_key" } } } ] } }