Te damos la bienvenida al Centro para desarrolladores de Google Home, el nuevo destino para aprender a desarrollar acciones de casa inteligente. Nota: Seguirás compilando acciones en la Consola de Actions.

Se usó la API de Cloud Translation para traducir esta página.

Esquema de trait de OpenClose de una casa inteligente

action.devices.traits.OpenClose: Esta característica pertenece a dispositivos que admiten abrir y cerrar y, en algunos casos, abrir y cerrar parcialmente o posiblemente en más de una dirección.

ATRIBUTOS DISPOSITIVOS

Los dispositivos con este trait pueden informar lo siguiente atributos como parte de la operación SYNC. Para aprender Para obtener más información sobre cómo controlar los intents SYNC, consulta Entrega de intents.

Atributos	Tipo	Descripción
`discreteOnlyOpenClose`	Booleano	(Predeterminado: `false`) Cuando se establece como verdadero, esto indica que el dispositivo debe estar completamente abierto o cerrado por completo (es decir, no admite valores entre 0% y 100%).
`openDirection`	Matriz	Lista de instrucciones compatibles en las que se puede abrir o cerrar el dispositivo. Incluye este atributo si el dispositivo admite la apertura y el cierre en más de una dirección.
`[item, ...]`	String	Dirección compatible. Valores admitidos: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`
`commandOnlyOpenClose`	Booleano	(Predeterminado: `false`) Indica si el dispositivo admite el uso de comunicación unidireccional (verdadero) o bidireccional (falso). Establece este atributo como verdadero si el dispositivo no puede responder a un intent de CONSULTA o a un informe de estado de esta característica.
`queryOnlyOpenClose`	Booleano	(Predeterminado: `false`) Indica si al dispositivo solo se puede consultar información de estado y no se puede controlar. Los sensores que solo pueden informar el estado abierto deben establecer este campo en verdadero.

Ejemplos

Dispositivo simple de apertura y cierre

{
  "discreteOnlyOpenClose": true
}

Dispositivo de arriba hacia abajo, de abajo hacia arriba. Se puede abrir en cualquier dirección.

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

Dispositivo que solo funciona como comando:

{
  "commandOnlyOpenClose": false
}

Dispositivo STATES

Las entidades con esta característica pueden informar lo siguiente estados como parte de la operación QUERY. Para aprender Para obtener más información sobre cómo controlar los intents QUERY, consulta Entrega de intents.

La carga útil contiene uno de los siguientes elementos:

Una sola dirección de apertura y cierre

Estados Tipo Descripción

Estados	Tipo	Descripción
`openPercent`	Número	Obligatorio. Indica el porcentaje de que un dispositivo está abierto, donde 0 está cerrado y 100 está completamente abierto.
`targetOpenPercent`	Número	Nivel que indica el porcentaje de apertura al que irá o al que se moverá el dispositivo como resultado de un cambio de posición en curso.

openPercent

Número

Obligatorio.

Indica el porcentaje de que un dispositivo está abierto, donde 0 está cerrado y 100 está completamente abierto.

targetOpenPercent

Número

Nivel que indica el porcentaje de apertura al que irá o al que se moverá el dispositivo como resultado de un cambio de posición en curso.

Varias direcciones (apertura y cierre)

Estados	Tipo	Descripción
`openState`	Matriz	Obligatorio. Lista de estados para cada dirección abierta admitida.
`[item, ...]`	Objeto	Es el estado actual de la dirección abierta especificada.
`openPercent`	Número	Obligatorio. Indica el porcentaje de que un dispositivo está abierto, donde 0 está cerrado y 100 está completamente abierto.
`targetOpenPercent`	Número	Nivel que indica el porcentaje de apertura al que irá o al que se moverá el dispositivo como resultado de un cambio de posición en curso.
`openDirection`	String	Obligatorio. Indica la dirección en la que se abre el dispositivo. Valores admitidos: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`

Ejemplos

Dispositivo simple de apertura y cierre

{
  "openPercent": 100
}

Dispositivo simple de apertura y cierre que se abre en una nueva posición.

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

Abre el dispositivo un 30% en dirección hacia abajo y un 50% en dirección hacia arriba.

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

Abre el dispositivo un 30% en dirección hacia abajo y un 50% en dirección hacia arriba; actualmente, avanza al 80% en dirección hacia arriba.

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

COMANDOS del dispositivo

Los dispositivos con este rasgo pueden responder a lo siguiente comandos como parte de la operación EXECUTE. Para aprender Para obtener más información sobre cómo controlar los intents EXECUTE, consulta Entrega de intents.

`action.devices.commands.OpenClose`

Establece el estado de apertura y cierre del dispositivo.

Parámetros

Parámetros Tipo Descripción

Parámetros	Tipo	Descripción
`openPercent`	Número	Obligatorio. Indica el porcentaje de que un dispositivo está abierto, donde 0 está cerrado y 100 está completamente abierto.
`openDirection`	String	Dirección en la que se abrirá. Solo está presente si el dispositivo admite varias direcciones, como lo indica el atributo `openDirection`, y si el usuario especifica una dirección. Valores admitidos: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`
`followUpToken`	String	Token proporcionado por Google para la respuesta de seguimiento.

openPercent

Número

Obligatorio.

Indica el porcentaje de que un dispositivo está abierto, donde 0 está cerrado y 100 está completamente abierto.

openDirection

String

Dirección en la que se abrirá. Solo está presente si el dispositivo admite varias direcciones, como lo indica el atributo openDirection, y si el usuario especifica una dirección.

Valores admitidos:

UP
DOWN
LEFT
RIGHT
IN
OUT

followUpToken

String

Token proporcionado por Google para la respuesta de seguimiento.

Ejemplos

Abre el dispositivo.

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

Abre el dispositivo un 50% hacia abajo.

{
  "command": "action.devices.commands.OpenClose",
  "params": {
    "openPercent": 50,
    "openDirection": "DOWN",
    "followUpToken": "456"
  }
}

Se produjo un error cuando se configuraba el estado de apertura y cierre del dispositivo.

Valores admitidos:

lockedState
deviceJammingDetected

Respuestas de seguimiento

Los dispositivos con este trait pueden devolver lo siguiente: carga útil de respuesta de seguimiento como parte de la operación EXECUTE. Para aprender sobre la implementación de respuestas de seguimiento, consulta Notificaciones para Acciones de casa inteligente

La carga útil contiene uno de los siguientes elementos:

Listo

Campos Tipo Descripción

Campos	Tipo	Descripción
`followUpToken`	String	Obligatorio. Token proporcionado en la solicitud EXECUTE original.
`status`	String	Obligatorio. Resultado de la solicitud. Valores admitidos: `SUCCESS`
`openPercent`	Número	Obligatorio. Indica el porcentaje de que un dispositivo está abierto cuando 0 está cerrado y 100 está completamente abierto.

followUpToken

String

Obligatorio.

Token proporcionado en la solicitud EXECUTE original.

status

String

Obligatorio.

Resultado de la solicitud.

Valores admitidos:

SUCCESS

openPercent

Número

Obligatorio.

Indica el porcentaje de que un dispositivo está abierto cuando 0 está cerrado y 100 está completamente abierto.

Con errores

Campos Tipo Descripción

Campos	Tipo	Descripción
`followUpToken`	String	Obligatorio. Token proporcionado en la solicitud EXECUTE original.
`status`	String	Obligatorio. Resultado de la solicitud. Valores admitidos: `FAILURE`
`errorCode`	String	Obligatorio. El valor puede ser cualquier código de error para esta característica, por ejemplo, `lockedState`.

followUpToken

String

Obligatorio.

Token proporcionado en la solicitud EXECUTE original.

status

String

Obligatorio.

Resultado de la solicitud.

Valores admitidos:

FAILURE

errorCode

String

Obligatorio.

El valor puede ser cualquier código de error para esta característica, por ejemplo, lockedState.

Ejemplos

Abre la puerta de la cochera. (respuesta de seguimiento en caso de éxito)

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

Abre la puerta de la cochera. (respuesta de seguimiento para casos de falla)

{
  "OpenClose": {
    "priority": 0,
    "followUpResponse": {
      "errorCode": "lockedState",
      "status": "FAILURE",
      "followUpToken": "1234"
    }
  }
}

`action.devices.commands.OpenCloseRelative`

Ajusta el estado de apertura y cierre del dispositivo en relación con el estado actual. Este comando solo está disponible si commandOnlyOpenClose se establece como false.

Este comando requiere los siguientes atributos:

{
  "commandOnlyOpenClose": false
}

Parámetros

Parámetros Tipo Descripción

Parámetros	Tipo	Descripción
`openRelativePercent`	Número	Obligatorio. El porcentaje exacto para cambiar el estado de apertura y cierre. Los comandos relativos ambiciosos se convertirán en un parámetro de porcentaje exacto (por ejemplo, "Abrir un poco más las persianas" en comparación con "Abrir las persianas un 5%").
`openDirection`	String	Dirección en la que se abrirá. Solo está presente si el dispositivo admite varias direcciones, como lo indica el atributo `openDirection`, y si el usuario especifica una dirección. Valores admitidos: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`

openRelativePercent

Número

Obligatorio.

El porcentaje exacto para cambiar el estado de apertura y cierre. Los comandos relativos ambiciosos se convertirán en un parámetro de porcentaje exacto (por ejemplo, "Abrir un poco más las persianas" en comparación con "Abrir las persianas un 5%").

openDirection

String

Dirección en la que se abrirá. Solo está presente si el dispositivo admite varias direcciones, como lo indica el atributo openDirection, y si el usuario especifica una dirección.

Valores admitidos:

UP
DOWN
LEFT
RIGHT
IN
OUT

Ejemplos

Abre el dispositivo un poco más

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

Cierra el dispositivo un 10% más

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

Abre el dispositivo un 50% más hacia abajo.

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": 50,
    "openDirection": "DOWN"
  }
}

Se produjo un error cuando se configuraba el estado de apertura y cierre del dispositivo.

Valores admitidos:

lockedState
deviceJammingDetected

Expresiones de muestra

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%

ERRORES DE DISPOSITIVO

Consulta la lista completa de errores y excepciones.

Esquema de trait de OpenClose de una casa inteligente

ATRIBUTOS DISPOSITIVOS

Ejemplos

Dispositivo STATES

Una sola dirección de apertura y cierre

Varias direcciones (apertura y cierre)

Ejemplos

COMANDOS del dispositivo

action.devices.commands.OpenClose

Parámetros

Ejemplos

Errores relacionados

Respuestas de seguimiento

Listo

Con errores

Ejemplos

action.devices.commands.OpenCloseRelative

Parámetros

Ejemplos

Errores relacionados

Expresiones de muestra

de-DE

en-US

es-ES

fr-FR

hi-IN

it-IT

ja-JP

ko-KR

nl-NL

pt-BR

sv-SE

ERRORES DE DISPOSITIVO

`action.devices.commands.OpenClose`

`action.devices.commands.OpenCloseRelative`