Ti diamo il benvenuto nel Centro sviluppatori Google Home, la nuova destinazione per scoprire come sviluppare azioni per la smart home. Nota: continuerai a creare azioni nella console di Actions.

Questa pagina è stata tradotta dall'API Cloud Translation.

Switch to English

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

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

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

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

String

Direzione di apertura. Presente solo se il dispositivo supporta più direzioni, come indicato dall'attributo openDirection, e una direzione è specificata dall'utente.

Valori supportati:

UP
DOWN
LEFT
RIGHT
IN
OUT

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

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

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

followUpToken

String

Obbligatorio.

Token fornito nella richiesta EXECUTE originale.

status

String

Obbligatorio.

Risultato della richiesta.

Valori supportati:

SUCCESS

openPercent

Number

Obbligatorio.

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

Non riuscita

Campi Tipo Descrizione

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

followUpToken

String

Obbligatorio.

Token fornito nella richiesta EXECUTE originale.

status

String

Obbligatorio.

Risultato della richiesta.

Valori supportati:

FAILURE

errorCode

String

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

Questo comando richiede i seguenti attributi:

{
  "commandOnlyOpenClose": false
}

Parametri

Parametri Tipo Descrizione

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

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

Valori supportati:

UP
DOWN
LEFT
RIGHT
IN
OUT

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

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%

ERRORS dispositivo

Consulta l'elenco completo di errori ed eccezioni.

Schema dei tratti OpenClose per la smart home

ATTRIBUTES del dispositivo

Esempi

Dispositivo STATES

Apertura/chiusura singola direzione

Apertura/chiusura in più direzioni

Esempi

COMMANDS 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

Espressioni di esempio

de-DE

en-US

es-ES

fr-FR

hi-IN

it-IT

ja-JP

ko-KR

nl-NL

pt-BR

sv-SE

ERRORS dispositivo

`action.devices.commands.OpenClose`

`action.devices.commands.OpenCloseRelative`