Guida al passaggio della smart home
action.devices.types.SWITCH
: è possibile attivare e disattivare un dispositivo base nella smart home.
Questo tipo indica che il dispositivo riceve l'icona Switch e alcuni sinonimi e alias correlati.
Funzionalità dispositivo
Fai riferimento alla documentazione delle caratteristiche corrispondente per i dettagli dell'implementazione, come attributi e stati che il servizio deve supportare e come creare risposte EXECUTE e QUERY.
Caratteristiche obbligatorie
Questi tratti e comandi sono obbligatori, se applicabili al tuo dispositivo. Se il tuo dispositivo non supporta queste caratteristiche, inserisci il codice di errore functionNotSupported
in una risposta QUERY o EXECUTE. Per ulteriori informazioni, consulta Errori ed eccezioni.
Tratti consigliati
Queste caratteristiche sono consigliate, se applicabili al tuo dispositivo. Tuttavia, puoi combinare tutte le caratteristiche disponibili per trovare la corrispondenza con le tue funzionalità esistenti del prodotto.
Requisiti di qualità
- Latenza: il valore deve essere inferiore o uguale a 700 ms.
- Affidabilità: deve essere superiore o uguale al 97%.
Dispositivo di esempio: sensore semplice
Questa sezione contiene alcuni payload di esempio che rappresentano un "Switch" comune in base al tipo di dispositivo e alle caratteristiche di cui sopra. Se aggiungi o rimuovi delle 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.SWITCH", "traits": [ "action.devices.traits.OnOff" ], "name": { "name": "Simple switch" }, "willReportState": 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 } } } }
Comandi ESEGUI di esempio
On-Off
Per ulteriori dettagli sui parametri di comando, 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 } } ] } }