Schema trait OpenClose 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ù direzioni.

ATTRIBUTI 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 Completamento dell'intent.

Attributi Tipo Descrizione
discreteOnlyOpenClose Valore booleano

(valore predefinito: false)

Se impostato su true, significa che il dispositivo deve essere completamente aperto o chiuso (ovvero, non supporta valori compresi tra 0% e 100%).

openDirection Array

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 Valore booleano

(valore predefinito: false)

Indica se il dispositivo supporta l'utilizzo della 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 Valore booleano

(valore predefinito: false)

Indica se è possibile interrogare il 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 semplice da aprire e chiudere.

{
  "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 solo con comando a riga di 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 Completamento dell'intent.

Il payload contiene uno dei seguenti elementi:

Apertura/chiusura in un'unica direzione

Stati Tipo Descrizione
openPercent Number

Obbligatorio.

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

targetOpenPercent Number

Livello che indica la percentuale di apertura del punto in cui il dispositivo andrà o si sta spostando come risultato di 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 aperta specificata.

openPercent Number

Obbligatorio.

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

targetOpenPercent Number

Livello che indica la percentuale di apertura del punto in cui il dispositivo andrà o si sta spostando come risultato di un cambiamento continuo di posizione.

openDirection String

Obbligatorio.

La direzione di apertura del dispositivo.

Valori supportati:

UP
DOWN
LEFT
RIGHT
IN
OUT

Esempi

Dispositivo semplice da aprire e chiudere.

{
  "openPercent": 100
}

Semplice apertura/chiusura del dispositivo 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% verso il basso e del 50% verso l'alto, attualmente in direzione di 80% in alto.

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

COMANDI del dispositivo

I dispositivi con questo trait potrebbero rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per scoprire 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
openPercent Number

Obbligatorio.

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

openDirection String

Indicazioni per l'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 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% verso il 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 trait possono restituire il seguente payload di risposta di follow-up nell'ambito dell'operazione EXECUTE. Per scoprire di più sull'implementazione delle risposte di follow-up, consulta Notifiche sulle 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 con 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:

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 caso di successo)

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

Apri la porta del garage. (risposta di follow-up per il 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
openRelativePercent Number

Obbligatorio.

La percentuale esatta di variazione dello stato di apertura/chiusura. I comandi relativi ambiziosi verranno convertiti in un parametro percentuale esatto (ad esempio, "Apri un po' di più le veneziane" e "Apri le veneziane del 5%").

openDirection String

Indicazioni per l'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 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 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 di errori ed eccezioni.