Questa pagina è stata tradotta dall'API Cloud Translation.

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: `false`) 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: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`
`commandOnlyOpenClose`	Booleano	(Valore predefinito: `false`) 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: `false`) 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

Stati	Tipo	Descrizione
`openPercent`	Number	Obbligatorio. Indica la percentuale di apertura di un dispositivo, dove 0 è chiuso e 100 è completamente aperto.

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: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`

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

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 `openDirection`, e una direzione viene specificata dall'utente. Valori supportati: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`
`followUpToken`	Stringa	Token fornito da Google per la risposta di follow-up.

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 openDirection, e una direzione viene specificata dall'utente.

Valori supportati:

UP
DOWN
LEFT
RIGHT
IN
OUT

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"
  }
}

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

Campi	Tipo	Descrizione
`followUpToken`	Stringa	Obbligatorio. Token fornito nella richiesta EXECUTE originale.
`status`	Stringa	Obbligatorio. Risultato della richiesta. Valori supportati: `SUCCESS`
`openPercent`	Number	Obbligatorio. Indica la percentuale di apertura di un dispositivo quando 0 è chiuso e 100 è completamente aperto.

followUpToken

Stringa

Obbligatorio.

Token fornito nella richiesta EXECUTE originale.

status

Stringa

Obbligatorio.

Risultato della richiesta.

Valori supportati:

SUCCESS

openPercent

Number

Obbligatorio.

Indica la percentuale di apertura di un dispositivo quando 0 è chiuso e 100 è completamente aperto.

Non riuscita

Campi Tipo Descrizione

Campi	Tipo	Descrizione
`followUpToken`	Stringa	Obbligatorio. Token fornito nella richiesta EXECUTE originale.
`status`	Stringa	Obbligatorio. Risultato della richiesta. Valori supportati: `FAILURE`
`errorCode`	Stringa	Obbligatorio. Il valore può essere qualsiasi codice di errore per questa caratteristica, ad esempio `lockedState`.

followUpToken

Stringa

Obbligatorio.

Token fornito nella richiesta EXECUTE originale.

status

Stringa

Obbligatorio.

Risultato della richiesta.

Valori supportati:

FAILURE

errorCode

Stringa

Obbligatorio.

Il valore può essere qualsiasi codice di errore per questa caratteristica, ad esempio lockedState.

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.

Questo comando richiede i seguenti attributi:

{
  "commandOnlyOpenClose": false
}

Parametri

Parametri Tipo Descrizione

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 `openDirection`, e una direzione viene specificata dall'utente. Valori supportati: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`

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 openDirection, e una direzione viene specificata dall'utente.

Valori supportati:

UP
DOWN
LEFT
RIGHT
IN
OUT

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"
  }
}

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 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%

ERRORI del dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.

Schema tratto OpenHome smart home

ATTRIBUTE del dispositivo

Esempi

STATEs dispositivo

Apertura e chiusura in una sola direzione

Apertura e chiusura in più direzioni

Esempi

comandi del dispositivo

action.devices.commands.OpenClose

Parametri

Esempi

Errori correlati

Risposte di follow-up

Operazione riuscita

Non riuscita

Esempi

action.devices.commands.OpenCloseRelative

Parametri

Esempi

Errori correlati

Esempi di frasi

de-DE

en-US

es-ES

fr-FR

hi-IN

it-IT

ja-JP

ko-KR

nl-NL

pt-BR

sv-SE

ERRORI del dispositivo

`action.devices.commands.OpenClose`

`action.devices.commands.OpenCloseRelative`