Schema tratto OpenHome smart home
action.devices.traits.OpenClose
: questa caratteristica appartiene ai dispositivi che supportano l'apertura e la chiusura e, in alcuni casi, l'apertura e la chiusura parziale o potenzialmente in più direzioni.
ATTRIBUTE del dispositivo
I dispositivi con questa caratteristica potrebbero segnalare i seguenti
attributi come parte dell'operazione SYNC
. Per scoprire di più sulla gestione degli intent SYNC
, consulta Soddisfazione degli intent.
Attributi | Tipo | Descrizione |
---|---|---|
discreteOnlyOpenClose |
Booleano |
(Valore predefinito: Se impostato su true, il dispositivo deve essere completamente aperto o completamente chiuso, ovvero non supporta valori compresi tra 0% e 100%. |
openDirection |
Array |
Elenco di indicazioni stradali supportate in cui il dispositivo può aprire o chiudere. Includi questo attributo se il dispositivo supporta l'apertura e la chiusura in più direzioni. |
[item, ...] |
Stringa |
Direzione supportata. Valori supportati:
|
commandOnlyOpenClose |
Booleano |
(Valore predefinito: Indica se il dispositivo supporta la comunicazione unidirezionale (vero) o bidirezionale (falso). Imposta questo attributo su true se il dispositivo non può rispondere a un intent QUERY o a uno stato del report per questa caratteristica. |
queryOnlyOpenClose |
Booleano |
(Valore predefinito: Indica se il dispositivo può essere oggetto di query solo per informazioni sullo stato e non può essere controllato. Questo campo deve essere impostato su true per i sensori che possono segnalare solo lo stato di apertura. |
Esempi
Semplice dispositivo a chiusura ravvicinata.
{ "discreteOnlyOpenClose": true }
Dispositivo dall'alto verso il basso. Può essere aperto in entrambe le direzioni.
{ "openDirection": [ "UP", "DOWN" ] }
Dispositivo solo con comandi.
{ "commandOnlyOpenClose": false }
STATEs dispositivo
Le entità con questa caratteristica possono segnalare i seguenti stati nell'ambito dell'operazione QUERY
. Per scoprire di più sulla gestione degli intent QUERY
, consulta Soddisfazione degli intent.
Il payload contiene uno dei seguenti valori:
Apertura e chiusura in una sola direzione
Stati | Tipo | Descrizione |
---|---|---|
openPercent |
Number |
Obbligatorio. Indica la percentuale di apertura di un dispositivo, dove 0 è chiuso e 100 è completamente aperto. |
Apertura e chiusura in più direzioni
Stati | Tipo | Descrizione |
---|---|---|
openState |
Array |
Obbligatorio. Elenco di stati per ciascuna direzione di apertura supportata. |
[item, ...] |
Oggetto |
Stato attuale per la direzione di apertura specificata. |
openPercent |
Number |
Obbligatorio. Indica la percentuale di apertura di un dispositivo, dove 0 è chiuso e 100 è completamente aperto. |
openDirection |
Stringa |
Obbligatorio. Direzione di apertura del dispositivo. Valori supportati:
|
Esempi
Semplice dispositivo a chiusura ravvicinata.
{ "openPercent": 100 }
Apri il dispositivo del 30% verso il basso e del 50% verso il basso.
{ "openState": [ { "openPercent": 30, "openDirection": "DOWN" }, { "openPercent": 50, "openDirection": "UP" } ] }
comandi del dispositivo
I dispositivi con questa caratteristica possono rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE
. Per scoprire di più sulla gestione degli intent EXECUTE
, consulta Soddisfazione degli intent.
action.devices.commands.OpenClose
Imposta lo stato di apertura/chiusura del dispositivo.
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
openPercent |
Number |
Obbligatorio. Indica la percentuale di apertura di un dispositivo, dove 0 è chiuso e 100 è completamente aperto. |
openDirection |
Stringa |
Direzione di apertura. Presente solo se il dispositivo supporta più direzioni, come indicato dall'attributo Valori supportati:
|
followUpToken |
Stringa |
Token fornito da Google per la risposta di follow-up. |
Esempi
Apri il dispositivo.
{ "command": "action.devices.commands.OpenClose", "params": { "openPercent": 100, "followUpToken": "123" } }
Apri il dispositivo il 50% in meno.
{ "command": "action.devices.commands.OpenClose", "params": { "openPercent": 50, "openDirection": "DOWN", "followUpToken": "456" } }
Errori correlati
Si è verificato un errore durante l'impostazione dello stato di apertura/chiusura del dispositivo.
Valori supportati:
lockedState
deviceJammingDetected
Risposte di follow-up
I dispositivi con questa caratteristica possono restituire il seguente
payload di risposta di follow-up nell'ambito dell'operazione EXECUTE
. Per scoprire di più sull'implementazione delle risposte successive, consulta Notifiche per le azioni relative alla smart home.
Il payload contiene uno dei seguenti valori:
Operazione riuscita
Campi | Tipo | Descrizione |
---|---|---|
followUpToken |
Stringa |
Obbligatorio. Token fornito nella richiesta EXECUTE originale. |
status |
Stringa |
Obbligatorio. Risultato della richiesta. Valori supportati:
|
openPercent |
Number |
Obbligatorio. Indica la percentuale di apertura di un dispositivo quando 0 è chiuso e 100 è completamente aperto. |
Non riuscita
Campi | Tipo | Descrizione |
---|---|---|
followUpToken |
Stringa |
Obbligatorio. Token fornito nella richiesta EXECUTE originale. |
status |
Stringa |
Obbligatorio. Risultato della richiesta. Valori supportati:
|
errorCode |
Stringa |
Obbligatorio. Il valore può essere qualsiasi codice di errore per questa caratteristica, ad esempio |
Esempi
Apri la porta del garage. (risposta di follow-up per la richiesta di successo)
{ "OpenClose": { "priority": 0, "followUpResponse": { "openPercent": 100, "status": "SUCCESS", "followUpToken": "1234" } } }
Apri la porta del garage. (risposta di follow-up per la richiesta di assistenza non riuscita)
{ "OpenClose": { "priority": 0, "followUpResponse": { "errorCode": "lockedState", "status": "FAILURE", "followUpToken": "1234" } } }
action.devices.commands.OpenCloseRelative
Regola lo stato di apertura/chiusura del dispositivo rispetto allo stato attuale. Questo comando è disponibile solo se commandOnlyOpenClose
è impostato su false
.
{ "commandOnlyOpenClose": false }
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
openRelativePercent |
Number |
Obbligatorio. La percentuale esatta di modifica dello stato di apertura/chiusura. I comandi relativi grandi vengono convertiti in un parametro percentuale esatto (ad esempio, "Apri le veneziane un po' di più" rispetto a "Apri le veneziane del 5%"). |
openDirection |
Stringa |
Direzione di apertura. Presente solo se il dispositivo supporta più direzioni, come indicato dall'attributo Valori supportati:
|
Esempi
Apri ancora un po' il dispositivo
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": 5 } }
Chiudi il dispositivo il 10% in più
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": -10 } }
Apri il dispositivo di almeno il 50% verso il basso.
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": 50, "openDirection": "DOWN" } }
Errori correlati
Si è verificato un errore durante l'impostazione dello stato di apertura/chiusura del dispositivo.
Valori supportati:
lockedState
deviceJammingDetected
Esempi di frasi
de-DE
-
Bitte öffne
die Jalousien auf30% -
Fensterläden um25 % schliessen -
Ist
die Jalousie zu? -
Mach
den Rollladen zu -
Mach
die Rollos auf -
schließe
die Rollläden ein bisschen mehr -
Öffne
die Jalousien um25%
en-US
-
Are
the blinds in the kitchen open -
Close
the blinds 25% inmy room -
Close
the door more -
Just close
the front door -
open
the blinds in my room -
open
the blinds to25% -
open
the door by25%
es-ES
-
abre
la ventana del salón -
cerrar
persianas del dormitorio un20% -
cierra
la cortina del salón -
cierra
mucho másla ventana -
está abierta
la puerta -
quiero que subas
la persiana al25% -
sube un
20% las persianas
fr-FR
-
baisse
les stores de10% -
est-ce que
la porte d'entrée est ouverte -
ferme
les stores -
ferme
un peu les stores -
ouvre
les stores -
ouvre
les stores de la chambre de25% -
ouvre
les stores à25%
hi-IN
-
कृपया
25% पर्दे को खुला रखो -
क्या मैंने
सामने वाला दरवाजा खुला छोड दिया? -
पर्दे को25% बंद करोगे -
पर्दे खोलो -
ब्लाइंड 25% खुले पर सेट कर दीजिए -
ब्लाइंड कोथोड़ा और बंद कर दिजिए -
ब्लाइंड बंद करें
it-IT
-
abbassa
un po' di piùle tapparelle -
apri
la serranda -
apri
la tapparella al30% -
apri
le serrande del30% -
chiudi
le serrande -
chiudi
le tende del25% -
è aperta
la porta d'ingresso
ja-JP
-
25% にブラインド を開けて -
25% ブラインド を閉めてください -
25% ブラインド 開けて -
ブラインド 閉めて -
ブラインド 開けて -
少し ブラインド を閉じて -
玄関のドア は開いてますか
ko-KR
-
문 살짝만 닫아 줘 -
블라인드 25% 열어 줘 -
블라인드 25% 까지 열어 줘 -
블라인드 30프로 닫아 -
블라인드 닫아 줘 -
블라인드 열어 줘 -
안방 문 열렸어
nl-NL
-
doe
de gordijnen 25% open -
doe
de jaloezieën voor25% dicht -
doe
het raam ietsje meer dicht -
is
de voordeur open -
open
de gordijnen -
sluit
het gordijn -
zet
de luxaflex voor50% open
pt-BR
-
Abrir
janela 50% -
As cortinas estão abertas? -
Fecha
a persiana toda -
Fechar
a janela 10% -
a cortina do quarto está aberta? -
abra
a persiana até30% -
abre
as cortinas -
abre
as cortinas a50% -
abrir
as cortinas -
abrir
as cortinas na sala em30% -
fecha
a persiana por favor -
fecha
um bocado a janela -
fechar
as cortinas em25% -
fechar
um pouco maisas cortinas
sv-SE
-
Dra
upp persiennerna -
Dra
upp
persiennerna till25% -
stäng
persiennen i mitt rum 25% -
stäng
persiennerna -
är
ytterdörren öppen? -
öppna
persiennerna med25%