Guida di asciugatrici smart per la casa
action.devices.types.DRYER
: le asciugatrici hanno una funzionalità di avvio e arresto indipendente dall'accensione o dallo spegnimento. Alcune possono essere messe in pausa e ripristinate durante l'asciugatura.
Gli asciugatrici hanno anche varie modalità e ognuna ha le proprie impostazioni correlate. Questi sono specifici dell'asciugatrice e vengono interpretati in forma generalizzata.
Questo tipo indica che sul dispositivo viene visualizzata l'icona Asciugatrice e alcuni sinonimi e alias correlati.
Funzionalità dispositivo
Fai riferimento alla documentazione delle caratteristiche corrispondente per ulteriori dettagli sull'implementazione, ad esempio attributi e stati che il servizio deve supportare e come creare risposte EXECUTE e QUERY.
Caratteristiche obbligatorie
Questi tratti e comandi sono obbligatori, se pertinenti al tuo dispositivo.
Tratti consigliati
Queste caratteristiche sono consigliate, se applicabili al tuo dispositivo. Tuttavia, puoi modificare e abbinare tutte le caratteristiche disponibili per trovare una corrispondenza ottimale con le tue funzionalità di prodotto esistenti.
-
action.devices.traits.Modes
-
action.devices.traits.OnOff
-
action.devices.traits.RunCycle
-
action.devices.traits.Toggles
Requisiti di qualità
- Latenza: deve essere inferiore o uguale a 3000 ms.
- Affidabilità: deve essere superiore o uguale al 97%.
Dispositivo di esempio: asciugatrice semplice
Questa sezione contiene esempi di payload degli intent che rappresentano una comune "asciugatrice" in base al tipo di dispositivo e alle caratteristiche citate sopra. Se aggiungi o rimuovi caratteristiche nell'implementazione, modifica le risposte di conseguenza per riflettere tali modifiche.
Esempio di risposta SYNC
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.DRYER", "traits": [ "action.devices.traits.OnOff", "action.devices.traits.RunCycle", "action.devices.traits.StartStop", "action.devices.traits.Modes" ], "name": { "name": "Simple dryer" }, "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" } } ] } }
Esempio di risposta 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": "dry", "lang": "en" } ], "currentTotalRemainingTime": 600, "currentCycleRemainingTime": 300, "currentModeSettings": { "load_key": "small_key" } } } } }
Esempi di comandi EXECUTE
Spento
Per ulteriori dettagli sui parametri dei comandi, consulta il riferimento
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 } } ] } }
Avvia/Interrompi
Per ulteriori dettagli sui parametri dei comandi, consulta il riferimento
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 } } ] } }
Imposta modalità
Per ulteriori dettagli sui parametri dei comandi, consulta il riferimento
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" } } } ] } }