Esquema de atributos de apertura y cierre de la casa inteligente

action.devices.traits.OpenClose: Este atributo pertenece a dispositivos que admiten la apertura y el cierre, y, en algunos casos, la apertura y el cierre parcial o potencialmente en más de una dirección.

ATRIBUTOS del dispositivo

Los dispositivos con esta característica pueden informar los siguientes atributos como parte de la operación SYNC. 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

Es la lista de direcciones compatibles en las que el dispositivo puede abrirse o cerrarse. Incluye este atributo si el dispositivo admite la apertura y el cierre en más de una dirección.
[item, ...] String

Dirección admitida.

Valores admitidos:

UP
DOWN
LEFT
RIGHT
IN
OUT
commandOnlyOpenClose Booleano

(Predeterminado: false)

Indica si el dispositivo admite la 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 estado de informe de esta característica.
queryOnlyOpenClose Booleano

(Predeterminado: false)

Indica si solo se puede consultar el dispositivo para obtener información de estado y no se puede controlar. Los sensores que solo pueden informar el estado abierto deben establecer este campo como verdadero.

Ejemplos

Dispositivo de apertura y cierre simple.

{
  "discreteOnlyOpenClose": true
}

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

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

Dispositivo solo de comandos.

{
  "commandOnlyOpenClose": false
}

Dispositivo STATES

Las entidades con este atributo pueden informar los siguientes estados como parte de la operación QUERY. Para obtener más información sobre cómo controlar intents QUERY, consulta Cómo entregar intents.

La carga útil contiene una de las siguientes opciones:

Apertura y cierre en una sola direcció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

Es el nivel que indica el porcentaje de espacio abierto al que se dirigirá o se está moviendo el dispositivo como resultado de un cambio continuo de posición.

Apertura y cierre en varias direcciones

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 determinada.
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.

Es la dirección en la que se abre el dispositivo.

Valores admitidos:

UP
DOWN
LEFT
RIGHT
IN
OUT

Ejemplos

Dispositivo de apertura y cierre simple.

{
  "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 la dirección hacia abajo y un 50% en la dirección hacia arriba.

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

Abrir el dispositivo un 30% hacia abajo y un 50% hacia arriba, actualmente se mueve al 80% hacia arriba.

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

COMANDOS del dispositivo

Los dispositivos con esta característica pueden responder a los siguientes comandos como parte de la operación EXECUTE. Para obtener más información sobre cómo controlar intents EXECUTE, consulta Cómo entregar intents.

action.devices.commands.OpenClose

Establece el estado de apertura y cierre del dispositivo.

Parámetros

Parámetros Tipo Descripción
openPercent Número

Obligatorio.

Indica el porcentaje en el que un dispositivo está abierto, donde 0 es cerrado y 100 es completamente abierto.
openDirection String

Dirección en la que se debe abrir. Solo está presente si el dispositivo admite varias direcciones, como lo indica el atributo openDirection, y 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 esta característica pueden mostrar la siguiente carga útil de respuesta de seguimiento como parte de la operación EXECUTE. Para obtener más información sobre cómo implementar respuestas de seguimiento, consulta Notificaciones para Acciones de casa inteligente.

La carga útil contiene una de las siguientes opciones:

Listo

Campos Tipo Descripción
followUpToken String

Obligatorio.

Es el token proporcionado en la solicitud EXECUTE original.
status String

Obligatorio.

Es el resultado de la solicitud.

Valores admitidos:

SUCCESS
openPercent Número

Obligatorio.

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

Se produjo un error al subir el archivo

Campos Tipo Descripción
followUpToken String

Obligatorio.

Es el token proporcionado en la solicitud EXECUTE original.
status String

Obligatorio.

Es el 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 para el 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
openRelativePercent Número

Obligatorio.

Es el porcentaje exacto para cambiar el estado de abierto a cerrado. 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 debe abrir. Solo está presente si el dispositivo admite varias direcciones, como lo indica el atributo openDirection, y 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 del dispositivo

Consulta la lista completa de errores y excepciones.