Schema dei tratti OpenClose per la 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 parzialmente o potenzialmente in più di una direzione.
ATTRIBUTES del dispositivo
I dispositivi con questo trait potrebbero segnalare i seguenti attributi nell'ambito dell'operazione SYNC
. Per scoprire di più sulla gestione degli intent SYNC
, consulta fulfillment dell'intent.
Attributi | Tipo | Descrizione |
---|---|---|
discreteOnlyOpenClose |
Booleano |
(Valore predefinito: Se impostato su true, indica che il dispositivo deve essere completamente aperto o chiuso (ovvero, non supporta valori compresi tra 0% e 100%). |
openDirection |
Matrice |
Elenco delle indicazioni stradali supportate in cui è possibile aprire o chiudere il dispositivo. Includi questo attributo se il dispositivo supporta l'apertura e la chiusura in più di una direzione. |
[item, ...] |
String |
Direzione supportata. Valori supportati:
|
commandOnlyOpenClose |
Booleano |
(Valore predefinito: Indica se il dispositivo supporta l'uso di una comunicazione unidirezionale (true) o bidirezionale (false). Imposta questo attributo su true se il dispositivo non può rispondere a un intent QUERY o a uno stato del report per questo trait. |
queryOnlyOpenClose |
Booleano |
(Valore predefinito: Indica se è possibile eseguire query sul dispositivo solo per informazioni sullo stato e non può essere controllato. I sensori che possono solo segnalare lo stato aperto devono impostare questo campo su true. |
Esempi
Dispositivo con apertura/chiusura semplice.
{ "discreteOnlyOpenClose": true }
Dispositivo dall'alto verso il basso e dal basso verso l'alto. Può essere aperto in entrambe le direzioni.
{ "openDirection": [ "UP", "DOWN" ] }
Dispositivo con solo comando.
{ "commandOnlyOpenClose": false }
Dispositivo STATES
Le entità con questo trait possono segnalare i seguenti
stati nell'ambito dell'operazione QUERY
. Per scoprire di più sulla gestione degli intent QUERY
, consulta fulfillment dell'intent.
Il payload contiene uno dei seguenti valori:
Apertura/chiusura singola direzione
Stati | Tipo | Descrizione |
---|---|---|
openPercent |
Number |
Obbligatorio. Indica la percentuale di apertura di un dispositivo, dove 0 è chiuso e 100 è completamente aperto. |
Apertura/chiusura in più direzioni
Stati | Tipo | Descrizione |
---|---|---|
openState |
Matrice |
Obbligatorio. Elenco di stati per ogni direzione aperta supportata. |
[item, ...] |
Oggetto |
Stato attuale per la direzione aperta specificata. |
openPercent |
Number |
Obbligatorio. Indica la percentuale di apertura di un dispositivo, dove 0 è chiuso e 100 è completamente aperto. |
openDirection |
String |
Obbligatorio. La direzione in cui viene aperto il dispositivo. Valori supportati:
|
Esempi
Dispositivo con apertura/chiusura semplice.
{ "openPercent": 100 }
Apri il dispositivo del 30% verso il basso e del 50% verso l'alto.
{ "openState": [ { "openPercent": 30, "openDirection": "DOWN" }, { "openPercent": 50, "openDirection": "UP" } ] }
COMMANDS dispositivo
I dispositivi con questa caratteristica potrebbero rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE
. Per scoprire di più sulla gestione degli intent EXECUTE
, consulta fulfillment dell'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 |
String |
Direzione di apertura. Presente solo se il dispositivo supporta più direzioni, come indicato dall'attributo Valori supportati:
|
followUpToken |
String |
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 abbassando del 50%.
{ "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 questo trait possono restituire il seguente
payload della risposta di follow-up nell'ambito dell'operazione EXECUTE
. Per scoprire di più sull'implementazione delle risposte di follow-up, consulta Notifiche per le azioni per la smart home.
Il payload contiene uno dei seguenti valori:
Operazione riuscita
Campi | Tipo | Descrizione |
---|---|---|
followUpToken |
String |
Obbligatorio. Token fornito nella richiesta EXECUTE originale. |
status |
String |
Obbligatorio. Risultato della richiesta. Valori supportati:
|
openPercent |
Number |
Obbligatorio. Indica la percentuale di apertura di un dispositivo, dove 0 è chiuso e 100 è completamente aperto. |
Non riuscita
Campi | Tipo | Descrizione |
---|---|---|
followUpToken |
String |
Obbligatorio. Token fornito nella richiesta EXECUTE originale. |
status |
String |
Obbligatorio. Risultato della richiesta. Valori supportati:
|
errorCode |
String |
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 caso di successo)
{ "OpenClose": { "priority": 0, "followUpResponse": { "openPercent": 100, "status": "SUCCESS", "followUpToken": "1234" } } }
Apri la porta del garage. (risposta di follow-up per caso di errore)
{ "OpenClose": { "priority": 0, "followUpResponse": { "errorCode": "lockedState", "status": "FAILURE", "followUpToken": "1234" } } }
action.devices.commands.OpenCloseRelative
Regola lo stato di apertura/chiusura del dispositivo in base allo stato attuale. Questo comando è disponibile solo se il criterio commandOnlyOpenClose
è impostato su false
.
{ "commandOnlyOpenClose": false }
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
openRelativePercent |
Number |
Obbligatorio. La percentuale esatta per modificare lo stato di apertura/chiusura. I comandi relativi ambiziosi verranno convertiti in un parametro percentuale esatto (ad esempio, "Apri le veneziane un po' di più" e "Apri le veneziane del 5%"). |
openDirection |
String |
Direzione di apertura. Presente solo se il dispositivo supporta più direzioni, come indicato dall'attributo Valori supportati:
|
Esempi
Apri un po' il dispositivo
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": 5 } }
Chiudi il dispositivo del 10% in più
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": -10 } }
Apri il dispositivo il 50% in più, 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
Espressioni di esempio
de-DE
- Bitte öffne die Jalousien auf 30%
- Fensterläden um 25 % schliessen
- Ist die Jalousie zu?
- Mach den Rollladen zu
- Mach die Rollos auf
- schließe die Rollläden ein bisschen mehr
- Öffne die Jalousien um 25%
en-US
- Are the blinds in the kitchen open
- Close the blinds 25% in my room
- Close the door more
- Just close the front door
- open the blinds in my room
- open the blinds to 25%
- open the door by 25%
es-ES
- abre la ventana del salón
- cerrar persianas del dormitorio un 20%
- cierra la cortina del salón
- cierra mucho más la ventana
- está abierta la puerta
- quiero que subas la persiana al 25%
- sube un 20% las persianas
fr-FR
- baisse les stores de 10%
- 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 de 25%
- ouvre les stores à 25%
hi-IN
- कृपया 25% पर्दे को खुला रखो
- क्या मैंने सामने वाला दरवाजा खुला छोड दिया?
- पर्दे को 25% बंद करोगे
- पर्दे खोलो
- ब्लाइंड 25% खुले पर सेट कर दीजिए
- ब्लाइंड को थोड़ा और बंद कर दिजिए
- ब्लाइंड बंद करें
it-IT
- abbassa un po' di più le tapparelle
- apri la serranda
- apri la tapparella al 30%
- apri le serrande del 30%
- chiudi le serrande
- chiudi le tende del 25%
- è 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 voor 25% dicht
- doe het raam ietsje meer dicht
- is de voordeur open
- open de gordijnen
- sluit het gordijn
- zet de luxaflex voor 50% 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 a 50%
- abrir as cortinas
- abrir as cortinas na sala em 30%
- fecha a persiana por favor
- fecha um bocado a janela
- fechar as cortinas em 25%
- fechar um pouco mais as cortinas
sv-SE
- Dra upp persiennerna
- Dra upp persiennerna till 25%
- stäng persiennen i mitt rum 25%
- stäng persiennerna
- är ytterdörren öppen?
- öppna persiennerna med 25%