Ti diamo il benvenuto nel Centro sviluppatori Google Home, la nuova destinazione per imparare a sviluppare azioni per la smart home. Nota:continuerai a creare azioni nella Console Actions.
Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Schema tratto OpenHome 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ù direzioni.

ATTRIBUTE del dispositivo

I dispositivi con questa caratteristica potrebbero segnalare i seguenti attributi come parte dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta Soddisfazione degli intent.

Attributi Tipo Descrizione
discreteOnlyOpenClose Booleano

(Valore predefinito: false)

Se impostato su true, il dispositivo deve essere completamente aperto o completamente chiuso, ovvero 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, ...] Stringa

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 questa caratteristica.

queryOnlyOpenClose Booleano

(Valore predefinito: false)

Indica se il dispositivo può essere oggetto di query solo per informazioni sullo stato e non può essere controllato. Questo campo deve essere impostato su true per i sensori che possono segnalare solo lo stato di apertura.

Esempi

Semplice dispositivo a chiusura ravvicinata.

{
  "discreteOnlyOpenClose": true
}

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

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

Dispositivo solo con comandi.

{
  "commandOnlyOpenClose": false
}

STATEs dispositivo

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

Il payload contiene uno dei seguenti valori:

Apertura e 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.

Apertura e chiusura in più direzioni

Stati Tipo Descrizione
openState Array

Obbligatorio.

Elenco di stati per ciascuna direzione di apertura supportata.

[item, ...] Oggetto

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.

openDirection Stringa

Obbligatorio.

Direzione di apertura del dispositivo.

Valori supportati:

UP
DOWN
LEFT
RIGHT
IN
OUT

Esempi

Semplice dispositivo a chiusura ravvicinata.

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

Direzione di 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 Stringa

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 il 50% in meno.

{
  "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 scoprire di più sull'implementazione delle risposte successive, consulta Notifiche per le azioni relative alla smart home.

Il payload contiene uno dei seguenti valori:

Operazione riuscita

Campi Tipo Descrizione
followUpToken Stringa

Obbligatorio.

Token fornito nella richiesta EXECUTE originale.

status Stringa

Obbligatorio.

Risultato della richiesta.

Valori supportati:

SUCCESS
openPercent Number

Obbligatorio.

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

Non riuscita

Campi Tipo Descrizione
followUpToken Stringa

Obbligatorio.

Token fornito nella richiesta EXECUTE originale.

status Stringa

Obbligatorio.

Risultato della richiesta.

Valori supportati:

FAILURE
errorCode Stringa

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 la richiesta di successo)

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

Apri la porta del garage. (risposta di follow-up per la richiesta di assistenza non riuscita)

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

openDirection Stringa

Direzione di 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 ancora un po' 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 di almeno il 50% 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 degli errori e delle eccezioni.