Schéma de trait OpenClose pour la maison connectée

action.devices.traits.OpenClose : ce trait appartient aux appareils qui permettent d'ouvrir et de fermer, et dans certains cas d'ouvrir et de fermer partiellement ou potentiellement dans plusieurs directions.

ATTRIBUTS de l'appareil

Les appareils dotés de ce trait peuvent signaler les attributs suivants dans le cadre de l'opération SYNC. Pour en savoir plus sur la gestion des intents SYNC, consultez Fulfillment d'intent.

Attributs Type Description
discreteOnlyOpenClose Valeur booléenne

(Par défaut : false)

Si la valeur est définie sur "true", cela indique que l'appareil doit être complètement ouvert ou complètement fermé (c'est-à-dire qu'il n'accepte pas les valeurs comprises entre 0 % et 100 %).
openDirection Array

Liste des directions dans lesquelles l'appareil peut s'ouvrir ou se fermer. Incluez cet attribut si l'appareil peut s'ouvrir et se fermer dans plusieurs directions.
[item, ...] String

Direction acceptée.

Valeurs acceptées :

UP
DOWN
LEFT
RIGHT
IN
OUT
commandOnlyOpenClose Valeur booléenne

(Par défaut : false)

Indique si l'appareil est compatible avec la communication unidirectionnelle (true) ou bidirectionnelle (false). Définissez cet attribut sur "true" si l'appareil ne peut pas répondre à une intention QUERY ni à un rapport d'état pour ce trait.
queryOnlyOpenClose Valeur booléenne

(Par défaut : false)

Indique si l'état de l'appareil peut uniquement être interrogé et s'il ne peut pas être contrôlé. Les capteurs qui ne peuvent signaler que l'état ouvert doivent définir ce champ sur "true".

Exemples

Appareil simple à ouvrir et à fermer.

{
  "discreteOnlyOpenClose": true
}

Appareil avec un système de fixation par le haut et par le bas. Peut être ouvert dans les deux sens.

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

Appareil fonctionnant uniquement avec des commandes.

{
  "commandOnlyOpenClose": false
}

ÉTATS des appareils

Les entités dotées de ce trait peuvent signaler les états suivants dans le cadre de l'opération QUERY. Pour en savoir plus sur la gestion des intents QUERY, consultez Fulfillment d'intent.

La charge utile contient l'un des éléments suivants :

Ouverture et fermeture dans un seul sens

États Type Description
openPercent Number

Obligatoire.

Indique le pourcentage d'ouverture d'un appareil, où 0 correspond à la position fermée et 100 à la position entièrement ouverte.
targetOpenPercent Number

Niveau indiquant le pourcentage d'ouverture vers lequel l'appareil se déplace ou se déplacera en raison d'un changement de position en cours.

Ouvrir et fermer dans plusieurs directions

États Type Description
openState Array

Obligatoire.

Liste des états pour chaque direction ouverte acceptée.
[item, ...] Objet

État actuel de la direction ouverte donnée.
openPercent Number

Obligatoire.

Indique le pourcentage d'ouverture d'un appareil, où 0 correspond à la position fermée et 100 à la position entièrement ouverte.
targetOpenPercent Number

Niveau indiquant le pourcentage d'ouverture vers lequel l'appareil se déplace ou se déplacera en raison d'un changement de position en cours.
openDirection String

Obligatoire.

Sens d'ouverture de l'appareil.

Valeurs acceptées :

UP
DOWN
LEFT
RIGHT
IN
OUT

Exemples

Appareil simple à ouvrir et à fermer.

{
  "openPercent": 100
}

Un simple dispositif d'ouverture et de fermeture est en train de s'ouvrir.

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

Ouvre l'appareil de 30 % vers le bas et de 50 % vers le haut.

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

Ouvre l'appareil à 30 % vers le bas et à 50 % vers le haut. Il est actuellement en train de s'ouvrir à 80 % vers le haut.

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

COMMANDES de l'appareil

Les appareils dotés de ce trait peuvent répondre aux commandes suivantes dans le cadre de l'opération EXECUTE. Pour en savoir plus sur la gestion des intents EXECUTE, consultez Fulfillment d'intent.

action.devices.commands.OpenClose

Définissez l'état d'ouverture/fermeture de l'appareil.

Paramètres

Paramètres Type Description
openPercent Number

Obligatoire.

Indique le pourcentage d'ouverture d'un appareil, où 0 correspond à la position fermée et 100 à la position entièrement ouverte.
openDirection String

Sens d'ouverture. Cet élément n'est présent que si l'appareil est compatible avec plusieurs directions, comme indiqué par l'attribut openDirection, et si une direction est spécifiée par l'utilisateur.

Valeurs acceptées :

UP
DOWN
LEFT
RIGHT
IN
OUT
followUpToken String

Jeton fourni par Google pour la réponse de suivi.

Exemples

Ouvrez l'appareil.

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

Ouvre l'appareil à moitié.

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

Une erreur s'est produite lors de la définition de l'état d'ouverture/fermeture de l'appareil.

Valeurs acceptées :

lockedState
deviceJammingDetected

Réponses de suivi

Les appareils dotés de ce trait peuvent renvoyer la charge utile de réponse complémentaire suivante dans le cadre de l'opération EXECUTE. Pour en savoir plus sur l'implémentation des réponses de suivi, consultez Notifications pour les actions de maison connectée.

La charge utile contient l'un des éléments suivants :

Opération réussie

Champs Type Description
followUpToken String

Obligatoire.

Jeton fourni dans la requête EXECUTE d'origine.
status String

Obligatoire.

Résultat de la requête.

Valeurs acceptées :

SUCCESS
openPercent Number

Obligatoire.

Indique le pourcentage d'ouverture d'un appareil, où 0 correspond à la position fermée et 100 à la position entièrement ouverte.

Échec

Champs Type Description
followUpToken String

Obligatoire.

Jeton fourni dans la requête EXECUTE d'origine.
status String

Obligatoire.

Résultat de la requête.

Valeurs acceptées :

FAILURE
errorCode String

Obligatoire.

La valeur peut être n'importe quel code d'erreur pour ce trait (par exemple, lockedState).

Exemples

Ouvre la porte du garage. (follow-up response for success case)

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

Ouvre la porte du garage. (réponse de suivi en cas d'échec)

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

action.devices.commands.OpenCloseRelative

Ajustez l'état d'ouverture/fermeture de l'appareil par rapport à l'état actuel. Cette commande n'est disponible que si discreteOnlyOpenClose est défini sur false.

Cette commande nécessite les attributs suivants : 
{
  "discreteOnlyOpenClose": false
}

Paramètres

Paramètres Type Description
openRelativePercent Number

Obligatoire.

Pourcentage exact pour modifier l'état ouvert/fermé. Les commandes relatives ambiguës seront converties en paramètre de pourcentage exact (par exemple, "Ouvre un peu plus les stores" sera remplacé par "Ouvre les stores de 5 %").
openDirection String

Sens d'ouverture. Cet élément n'est présent que si l'appareil est compatible avec plusieurs directions, comme indiqué par l'attribut openDirection, et si une direction est spécifiée par l'utilisateur.

Valeurs acceptées :

UP
DOWN
LEFT
RIGHT
IN
OUT

Exemples

Ouvrez un peu plus l'appareil.

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

Fermez l'appareil de 10 % supplémentaires.

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

Ouvrez l'appareil de 50 % vers le bas.

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

Une erreur s'est produite lors de la définition de l'état d'ouverture/fermeture de l'appareil.

Valeurs acceptées :

lockedState
deviceJammingDetected

Exemples d'énoncés

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%

ERREURS liées à l'appareil

Consultez la liste complète des erreurs et exceptions.