Guida al blocco della smart home
action.devices.types.LOCK
: le serrature possono bloccare, sbloccare e segnalare uno stato di blocco.
Questo tipo indica che sul dispositivo viene mostrata l'icona lucchetto 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.
Requisiti di qualità
- Latenza: il valore deve essere inferiore o uguale a 2000 ms.
- Affidabilità: deve essere superiore o uguale al 97%.
Dispositivo di esempio: semplice blocco
Questa sezione contiene alcuni payload di esempio che rappresentano un "blocco" 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.LOCK", "traits": [ "action.devices.traits.LockUnlock" ], "name": { "name": "Simple lock" }, "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, "isLocked": true, "isJammed": false } } } }
Comandi ESEGUI di esempio
Sblocco con serratura
Per ulteriori dettagli sui parametri di comando, consulta il riferimento
action.devices.traits.LockUnlock
.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.LockUnlock", "params": { "lock": true } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "isLocked": true, "isJammed": false } } ] } }