Guide du lave-linge pour maison connectée
action.devices.types.WASHER : Les lave-linge peuvent être dotés d'une fonctionnalité de démarrage et d'arrêt indépendamment de l'allumage ou de l'arrêt (certains lave-linge disposent 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 plusieurs modes, chacun possédant ses propres paramètres associés. Ils sont spécifiques au lave-linge et sont interprétés de manière générale.
Ce type indique que l'appareil reçoit l'icône du lave-linge, ainsi que des synonymes et alias associés.
Pour voir comment contrôler un lave-linge avec Google Smart Home, consultez l'atelier de programmation sur le lave-linge connecté.
Fonctionnalités de l'appareil
Reportez-vous à la documentation sur les caractéristiques 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 caractéristiques et commandes sont requises, si applicables à votre appareil. 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.
Traits recommandés
Ces caractéristiques sont recommandées, si elles s'appliquent à votre appareil. Cependant, vous êtes libre de combiner toutes les caractéristiques disponibles pour qu'elles correspondent au mieux aux fonctionnalités de votre produit.
-
action.devices.traits.Modes -
action.devices.traits.OnOff -
action.devices.traits.RunCycle -
action.devices.traits.Toggles
Exigences de qualité
- Latence:doit être inférieure ou égale à 3 000 ms.
- Fiabilité:la valeur 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 "lave-linge" 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 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.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
{
"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 la commande, consultez la documentation de référence sur
action.devices.traits.OnOff.
{
"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 la commande, consultez la documentation de référence sur
action.devices.traits.StartStop.
{
"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 la commande, consultez la documentation de référence sur
action.devices.traits.Modes.
{
"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"
}
}
}
]
}
}