Guida alle scene per la smart home
action.devices.types.SCENE
: nel caso delle scene, il tipo viene mappato 1:1 sul tratto, dato che non si combinano con altri tratti per formare dispositivi compositi. Le scene devono sempre avere nomi forniti dagli utenti. Ogni scena ha il proprio dispositivo virtuale, con i propri nomi.
Questo tipo indica che sul dispositivo viene mostrata l'icona della scena e alcuni sinonimi e alias correlati.
Per ulteriori informazioni, consulta la Caratteristiche della scena.
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 3000 ms.
- Affidabilità: deve essere superiore o uguale al 97%.
Dispositivo di esempio: scena semplice
Questa sezione contiene alcuni payload di esempio che rappresentano una "Scena" 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.SCENE", "traits": [ "action.devices.traits.Scene" ], "name": { "name": "Simple scene" }, "willReportState": true, "attributes": { "sceneReversible": 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 } } } }
Comandi ESEGUI di esempio
ActivateScene
Per ulteriori dettagli sui parametri di comando, consulta il riferimento
action.devices.traits.Scene
.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.ActivateScene", "params": { "deactivate": false } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true } } ] } }