Schema della caratteristica OpenClose della 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ù di una direzione.

ATTRIBUTI del dispositivo

I dispositivi con questa caratteristica possono segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per saperne di più sulla gestione degli intent SYNC, consulta Completamento degli 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 (true) o bidirezionale (false). Imposta questo attributo su true se il dispositivo non può rispondere a un intent QUERY o a Report State per questa caratteristica.
queryOnlyOpenClose Valore booleano

(Valore predefinito: false)

Indica se è possibile eseguire query sul dispositivo solo per informazioni sullo stato e non è possibile controllarlo. I sensori che possono segnalare solo lo stato di apertura devono impostare questo campo su true.

Esempi

Dispositivo di apertura/chiusura semplice.

{
  "discreteOnlyOpenClose": true
}

Dispositivo dall'alto verso il basso. Può essere aperto in entrambe le direzioni.

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

Dispositivo solo per i comandi.

{
  "commandOnlyOpenClose": false
}

STATI del dispositivo

Le entità con questa caratteristica possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per saperne di più sulla gestione degli intent QUERY, consulta Completamento degli intent.

Il payload contiene uno dei seguenti elementi:

Apertura/chiusura in una sola direzione

Stati Tipo Descrizione
openPercent Number

Obbligatorio.

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

Il valore deve essere compreso tra 0 e 100.
targetOpenPercent Number

Livello che indica la percentuale di apertura verso cui il dispositivo si sposterà o si sta spostando a seguito di una modifica in corso della posizione.

Il valore deve essere compreso tra 0 e 100.

Apertura/chiusura in più direzioni

Stati Tipo Descrizione
openState Array

Obbligatorio.

Elenco degli stati per ogni direzione di apertura supportata.
[item, ...] Object

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.

Il valore deve essere compreso tra 0 e 100.
targetOpenPercent Number

Livello che indica la percentuale di apertura verso cui il dispositivo si sposterà o si sta spostando a seguito di una modifica in corso della posizione.

Il valore deve essere compreso tra 0 e 100.
openDirection String

Obbligatorio.

Direzione in cui il dispositivo è aperto.

Valori supportati:

UP
DOWN
LEFT
RIGHT
IN
OUT

Esempi

Dispositivo di apertura/chiusura semplice.

{
  "openPercent": 100
}

Dispositivo di apertura/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% verso il basso e del 50% verso l'alto, attualmente in movimento verso l'80% verso l'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 saperne di più sulla gestione degli intent EXECUTE, consulta Completamento 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.

Il valore deve essere compreso tra 0 e 100.
openDirection String

Direzione in cui aprire. Presente solo se il dispositivo supporta più direzioni, come indicato dall'attributo openDirection, e se l'utente ha specificato una direzione.

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 questa caratteristica possono restituire il seguente payload di risposta di follow-up nell'ambito dell'operazione EXECUTE. Per saperne 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 è chiuso e 100 è completamente aperto.

Il valore deve essere compreso tra 0 e 100.

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 il 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 rispetto allo stato attuale. Questo comando è disponibile solo se discreteOnlyOpenClose è impostato su false.

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

Parametri

Parametri Tipo Descrizione
openRelativePercent Number

Obbligatorio.

La percentuale esatta per modificare lo stato di apertura/chiusura. I comandi relativi ambigui verranno convertiti in un parametro di percentuale esatta (ad esempio, "Apri un po' di più le persiane" anziché "Apri le persiane del 5%").

Il valore deve essere compreso tra -100 e 100.
openDirection String

Direzione in cui aprire. Presente solo se il dispositivo supporta più direzioni, come indicato dall'attributo openDirection, e se l'utente ha specificato una direzione.

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 del 10% in più

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

Esempi di espressioni

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.