Schema del tratto 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.

ATTRIBUTI del dispositivo

I dispositivi con questa caratteristica possono segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per scoprire 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 delle direzioni supportate in cui il dispositivo può aprirsi o chiudersi. 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 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 intento QUERY o a uno stato Report per questa caratteristica.
queryOnlyOpenClose Valore 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 segnalare solo lo stato aperto devono impostare questo campo su true.

Esempi

Dispositivo di apertura e chiusura semplice.

{
  "discreteOnlyOpenClose": true
}

Dispositivo top-down bottom-up. Può essere aperto in entrambe le direzioni.

{
  "openDirection": [
    "UP",
    "DOWN"
  ]
}

Dispositivo con solo comando.

{
  "commandOnlyOpenClose": false
}

STATI del dispositivo

Le entità con questo attributo possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per scoprire di più sulla gestione degli intent QUERY, consulta Adempimento degli intent.

Il payload contiene uno dei seguenti elementi:

Aperto/chiuso in una sola direzione

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.

Apertura e 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 in cui viene aperto il dispositivo.

Valori supportati:

UP
DOWN
LEFT
RIGHT
IN
OUT

Esempi

Dispositivo di apertura e chiusura semplice.

{
  "openPercent": 100
}

Dispositivo di apertura e chiusura semplice che si sta aprendo in una nuova posizione.

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

Apri il dispositivo del 30% verso il basso e del 50% verso l'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 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 Adempimento 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 String

La direzione in cui aprire. Presente solo se il dispositivo supporta più indicazioni, come indicato dall'attributo openDirection, e un'indicazione è 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 questa caratteristica 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 elementi:

Operazione riuscita

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 indica chiuso e 100 indica completamente aperto.

Operazione non riuscita

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.

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. (follow-up response for failure case)

{
  "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 commandOnlyOpenClose è impostato su false.

Questo comando richiede i seguenti attributi: 
{
  "commandOnlyOpenClose": false
}

Parametri

Parametri Tipo Descrizione
openRelativePercent Number

Obbligatorio.

La percentuale esatta per modificare lo stato di apertura e chiusura. I comandi relativi ambigui verranno convertiti in un parametro percentuale esatto (ad esempio, "Apri un po' di più le veneziane" rispetto ad "Apri le veneziane del 5%").
openDirection String

La direzione in cui aprire. Presente solo se il dispositivo supporta più indicazioni, come indicato dall'attributo openDirection, e un'indicazione è 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 per un altro 10%

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": -10
  }
}

Apri il dispositivo del 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

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

ERRORI del dispositivo

Consulta l'elenco completo di errori ed eccezioni.