Schema dei caratteri OpenOpen della 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 parziale o potenziale in più direzioni.

ATTRIBUTE dispositivo

I dispositivi con questo trattino potrebbero segnalare i seguenti attributi come parte dell'operazione SYNC. Per saperne di più sulla gestione degli intent SYNC, consulta la sezione fulfillment di intent.

Attributi Tipo Descrizione
discreteOnlyOpenClose Booleano

(Valore predefinito: false)

Se il valore è impostato su True, significa che il dispositivo deve essere completamente aperto o completamente chiuso (vale a dire, non supporta valori compresi tra 0% e 100%).

openDirection Array

Elenco di indicazioni stradali supportate in cui il dispositivo può aprire o chiudere. 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 Booleano

(Valore predefinito: false)

Indica se il dispositivo supporta la comunicazione unidirezionale (vero) o bidirezionale (falso). Imposta questo attributo su "true" se il dispositivo non può rispondere a un intent QUERY o a uno stato del report per questo tratto.

queryOnlyOpenClose Booleano

(Valore predefinito: false)

Indica se è possibile eseguire query su informazioni sullo stato e non è possibile controllare il dispositivo. Questo campo deve essere impostato su vero per i sensori che possono segnalare solo lo stato di apertura.

Esempi

Semplice dispositivo aperto/chiuso.

{
  "discreteOnlyOpenClose": true
}

Dispositivo dal basso verso l'alto. Può essere aperto in entrambe le direzioni.

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

Dispositivo di solo comando.

{
  "commandOnlyOpenClose": false
}

STATO 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 la sezione fulfillment di intent.

Il payload contiene uno dei seguenti valori:

Apertura/chiusura unidirezionale

Stati Tipo Descrizione
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 Array

Obbligatorio.

Elenco di stati per ciascuna direzione di apertura supportata.

[item, ...] Oggetto

Stato attuale della direzione aperta specificata.

openPercent Number

Obbligatorio.

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

openDirection String

Obbligatorio.

Direzione in cui il dispositivo è aperto.

Valori supportati:

UP
DOWN
LEFT
RIGHT
IN
OUT

Esempi

Semplice dispositivo aperto/chiuso.

{
  "openPercent": 100
}

Apri il dispositivo del 30% verso il basso e del 50% verso il basso.

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

COMANDI dispositivo

I dispositivi con questo trattino potrebbero rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per saperne di più sulla gestione degli intent EXECUTE, consulta la sezione fulfillment di intent.

action.devices.commands.OpenClose

Imposta lo stato di chiusura/apertura 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

Indica in quale apertura 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 il follow-up.

Esempi

Apri il dispositivo.

{
  "command": "action.devices.commands.OpenClose",
  "params": {
    "openPercent": 100,
    "followUpToken": "123"
  }
}

Apri il dispositivo con il 50% di riduzione.

{
  "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 il seguente payload di risposta di follow-up nell'ambito dell'operazione EXECUTE. Per scoprire di più sull'implementazione delle risposte successive, consulta Notifiche per le azioni della smart home.

Il payload contiene uno dei seguenti valori:

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 in cui lo 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 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 successiva per la richiesta di assistenza)

{
  "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 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/chiusura. I comandi relativi ad enorme volume verranno convertiti in un parametro percentuale esatto (ad esempio, "Apri le veneziane un po' di più" rispetto a "Apri le veneziane del 5%").

openDirection String

Indica in quale apertura 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 il dispositivo un po' di più

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

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%

ERRORI del dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.