Guide du lave-linge pour maison connectée
action.devices.types.WASHER : les lave-linge sont dotés de fonctionnalités de démarrage et d'arrêt indépendantes de l'allumage ou de l'arrêt de la machine. Certains lave-linge sont équipés de boutons d'alimentation séparés, et d'autres non. Certaines peuvent être suspendues et réactivées pendant le lavage.
Ils disposent également de différents modes, et chacun possède ses propres paramètres. Ils sont spécifiques au lave-linge et sont interprétés sous une forme généralisée.
Ce type indique que l'appareil obtient l'icône du lave-linge, ainsi que des synonymes et des alias associés.
Pour voir un exemple de contrôle d'une machine à laver avec la maison connectée de Google, consultez l'atelier de programmation sur le lave-linge connecté.
Fonctionnalités de l'appareil
Consultez la documentation sur les caractéristiques correspondantes pour connaître les détails de la mise en œuvre, tels que les attributs et les états que votre service doit accepter, et pour savoir comment créer des réponses EXECUTE et QUERY.
Caractéristiques obligatoires
Ces caractéristiques et commandes sont requises, le cas échéant.
Caractéristiques recommandées
Ces caractéristiques sont recommandées, le cas échéant pour votre appareil. Cependant, vous êtes libre de combiner toutes les caractéristiques disponibles pour mieux correspondre aux fonctionnalités existantes de votre produit.
-
action.devices.traits.Modes -
action.devices.traits.OnOff -
action.devices.traits.RunCycle -
action.devices.traits.Toggles
Exigences de qualité
- Latence:elle doit être inférieure ou égale à 3 000 ms.
- Fiabilité:elle doit être supérieure ou égale à 97%.
Exemple d'appareil: lave-linge simple
Cette section contient des exemples de charges utiles d'intents 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.
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
Activé
Pour en savoir plus sur les paramètres de 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
}
}
]
}
}
Arrêter
Pour en savoir plus sur les paramètres de 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
}
}
]
}
}
Modes de définition
Pour en savoir plus sur les paramètres de 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"
}
}
}
]
}
}