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.

Schema del Trait OpenClose per la smart home

action.devices.traits.OpenClose: questo tratto appartiene ai dispositivi che supportano l'apertura e la chiusura e, in alcuni casi, l'apertura e la chiusura parzialmente o potenzialmente in più direzioni.

ATTRIBUTES dispositivo

I dispositivi con questo tratto potrebbero segnalare quanto segue nell'ambito dell'operazione SYNC. Per ulteriori informazioni scopri di più sulla gestione degli intent SYNC; consulta Completamento dell'intent.

Attributi	Tipo	Descrizione
`discreteOnlyOpenClose`	Valore booleano	(Valore predefinito: `false`) Se impostato su true, indica che il dispositivo deve essere completamente aperto o completamente chiuso (ovvero non supporta valori compresi tra 0% e 100%).
`openDirection`	Array	Elenco di direzioni supportate in cui è possibile aprire o chiudere il dispositivo. Includi questo attributo se il dispositivo supporta l'apertura e la chiusura in più direzioni.
`[item, ...]`	String	Direzione supportata. Valori supportati: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`
`commandOnlyOpenClose`	Valore booleano	(Valore predefinito: `false`) Indica se il dispositivo supporta la comunicazione unidirezionale (vero) o bidirezionale (false). Imposta questo attributo su true se il dispositivo non può rispondere a un intent QUERY o a Segnalare lo stato per questo tratto.
`queryOnlyOpenClose`	Valore booleano	(Valore predefinito: `false`) Indica se il dispositivo può essere sottoposto a query solo per informazioni sullo stato e non può essere controllato. I sensori che possono segnalare solo lo stato aperto devono impostare questo campo su true.

Esempi

Dispositivo di apertura e 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
}

STATES del dispositivo

Le entità con questo tratto possono segnalare quanto segue nell'ambito dell'operazione QUERY. Per ulteriori informazioni scopri di più sulla gestione degli intent QUERY; consulta Completamento dell'intent.

Il payload contiene uno dei seguenti elementi:

Apertura/chiusura singola direzione

Stati Tipo Descrizione

Stati	Tipo	Descrizione
`openPercent`	Number	Obbligatorio. Indica la percentuale di apertura di un dispositivo, in cui 0 è chiuso e 100 è completamente aperto.
`targetOpenPercent`	Number	Livello che indica la percentuale di apertura della posizione del dispositivo in seguito a un cambiamento continuo di posizione.

openPercent

Number

Obbligatorio.

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

targetOpenPercent

Number

Livello che indica la percentuale di apertura della posizione del dispositivo in seguito a un cambiamento continuo di posizione.

Apertura/chiusura in più direzioni

Stati	Tipo	Descrizione
`openState`	Array	Obbligatorio. Elenco di stati per ogni direzione aperta supportata.
`[item, ...]`	Oggetto	Stato attuale per la direzione di apertura specificata.
`openPercent`	Number	Obbligatorio. Indica la percentuale di apertura di un dispositivo, in cui 0 è chiuso e 100 è completamente aperto.
`targetOpenPercent`	Number	Livello che indica la percentuale di apertura della posizione del dispositivo in seguito a un cambiamento continuo di posizione.
`openDirection`	String	Obbligatorio. Direzione di apertura del dispositivo. Valori supportati: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`

Esempi

Dispositivo di apertura e chiusura semplice.

{
  "openPercent": 100
}

Un semplice dispositivo di apertura/chiusura che si apre in una nuova posizione.

{
  "openPercent": 50,
  "targetOpenPercent": 100
}

Apri il dispositivo del 30% in basso e del 50% in alto.

{
  "openState": [
    {
      "openPercent": 30,
      "openDirection": "DOWN"
    },
    {
      "openPercent": 50,
      "openDirection": "UP"
    }
  ]
}

Apri il dispositivo del 30% in basso e del 50% in alto, attualmente spostandoti all'80% in alto.

{
  "openState": [
    {
      "openPercent": 30,
      "openDirection": "DOWN"
    },
    {
      "openPercent": 50,
      "targetOpenPercent": 80,
      "openDirection": "UP"
    }
  ]
}

COMANDI dispositivo

I dispositivi con questo tratto potrebbero rispondere ai seguenti nell'ambito dell'operazione EXECUTE. Per ulteriori informazioni scopri di più sulla gestione degli intent EXECUTE; consulta Completamento 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, in cui 0 è chiuso e 100 è completamente aperto.
`openDirection`	String	Direzione in cui aprire. 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, in cui 0 è chiuso e 100 è completamente aperto.

openDirection

String

Direzione in cui aprire. 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 del 50% in basso.

{
  "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 tratto potrebbero restituire quanto segue Payload della risposta di follow-up come parte dell'operazione EXECUTE. Per ulteriori informazioni per ulteriori informazioni sull'implementazione delle risposte aggiuntive, consulta Notifiche per le azioni della smart home.

Il payload contiene uno dei seguenti elementi:

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 in cui 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 in cui 0 è chiuso e 100 è completamente aperto.

Operazione 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 questo tratto, 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 questo tratto, ad esempio lockedState.

Esempi

Apri la porta del garage. (risposta di follow-up per i casi di successo)

{
  "OpenClose": {
    "priority": 0,
    "followUpResponse": {
      "openPercent": 100,
      "status": "SUCCESS",
      "followUpToken": "1234"
    }
  }
}

Apri la porta del garage. (risposta di follow-up in 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 rispetto 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 ampi verranno convertiti in un parametro percentuale esatto (ad esempio, "Apri un po' di più le veneziane" anziché "Apri le veneziane del 5%").
`openDirection`	String	Direzione in cui aprire. 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 ampi verranno convertiti in un parametro percentuale esatto (ad esempio, "Apri un po' di più le veneziane" anziché "Apri le veneziane del 5%").

openDirection

String

Direzione in cui aprire. 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' di più 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 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

Esempi di enunciato

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 dispositivo

Consulta l'elenco completo errori ed eccezioni.

Schema del Trait OpenClose per la smart home

ATTRIBUTES dispositivo

Esempi

STATES del dispositivo

Apertura/chiusura singola direzione

Apertura/chiusura in più direzioni

Esempi

COMANDI dispositivo

action.devices.commands.OpenClose

Parametri

Esempi

Errori correlati

Risposte di follow-up

Operazione riuscita

Operazione non riuscita

Esempi

action.devices.commands.OpenCloseRelative

Parametri

Esempi

Errori correlati

Esempi di enunciato

de-DE

en-US

es-ES

fr-FR

hi-IN

it-IT

ja-JP

ko-KR

nl-NL

pt-BR

sv-SE

ERRORI dispositivo

`action.devices.commands.OpenClose`

`action.devices.commands.OpenCloseRelative`