Schéma des caractéristiques OpenClose de la maison connectée
action.devices.traits.OpenClose
: cette caractéristique appartient aux appareils qui acceptent l'ouverture et la fermeture, et dans certains cas, l'ouverture et la fermeture partielles ou potentiellement dans plusieurs directions.
ATTRIBUTS D'APPAREIL
Les appareils dotés de cette caractéristique peuvent signaler les attributs suivants dans le cadre de l'opération SYNC
. Pour en savoir plus sur la gestion des intents SYNC
, consultez la section Traitement des intents.
Attributs | Type | Description |
---|---|---|
discreteOnlyOpenClose |
Valeur booléenne |
(Par défaut : Lorsque cette règle est définie sur "True", cela indique que l'appareil doit être soit entièrement ouvert, soit complètement fermé (c'est-à-dire qu'il n'accepte pas les valeurs comprises entre 0% et 100%). |
openDirection |
Array |
Liste des instructions compatibles avec l'ouverture et la fermeture de l'appareil. Spécifiez cet attribut si l'appareil est compatible avec les ouvertures et les fermetures dans plusieurs directions. |
[item, ...] |
String |
Direction acceptée. Valeurs acceptées :
|
commandOnlyOpenClose |
Valeur booléenne |
(Par défaut : 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 à un intent QUERY ni à un état de rapport pour cette caractéristique. |
queryOnlyOpenClose |
Valeur booléenne |
(Par défaut : Indique si l'appareil ne peut être interrogé que pour obtenir des informations d'état et ne peut pas être contrôlé. Vous devez définir ce champ sur "true" pour les capteurs qui ne peuvent signaler que l'état ouvert. |
Exemples
Appareil ouvert-fermeture simple
{ "discreteOnlyOpenClose": true }
Appareil ascendant de haut en bas. Ils peuvent être ouverts dans les deux sens.
{ "openDirection": [ "UP", "DOWN" ] }
Appareil à commande uniquement :
{ "commandOnlyOpenClose": false }
État de l'appareil
Les entités dotées de cette caractéristique peuvent signaler les états suivants dans le cadre de l'opération QUERY
. Pour en savoir plus sur la gestion des intents QUERY
, consultez la section Traitement des intents.
La charge utile contient l'un des éléments suivants:
Ouverture-fermeture à sens unique
États | Type | Description |
---|---|---|
openPercent |
Number |
Obligatoire. Indique le pourcentage d'ouverture d'un appareil, où 0 est fermé et 100 sont complètement ouverts. |
targetOpenPercent |
Number |
Niveau indiquant le pourcentage d'ouverture de l'appareil vers lequel l'appareil se déplacera en raison d'un changement de position en cours. |
Ouverture-fermeture multi-directionnelle
États | Type | Description |
---|---|---|
openState |
Array |
Obligatoire. Liste des états pour chaque direction ouverte compatible. |
[item, ...] |
Objet |
État actuel de la direction d'ouverture donnée. |
openPercent |
Number |
Obligatoire. Indique le pourcentage d'ouverture d'un appareil, où 0 est fermé et 100 sont complètement ouverts. |
targetOpenPercent |
Number |
Niveau indiquant le pourcentage d'ouverture de l'appareil vers lequel l'appareil se déplacera en raison d'un changement de position en cours. |
openDirection |
String |
Obligatoire. Direction dans laquelle l'appareil est ouvert. Valeurs acceptées :
|
Exemples
Appareil ouvert-fermeture simple
{ "openPercent": 100 }
Appareil ouverture-fermeture simple qui s'ouvre à une nouvelle position.
{ "openPercent": 50, "targetOpenPercent": 100 }
Ouvrez l'appareil de 30% vers le bas et de 50% vers le haut.
{ "openState": [ { "openPercent": 30, "openDirection": "DOWN" }, { "openPercent": 50, "openDirection": "UP" } ] }
Ouvrez l'appareil de 30% vers le bas et de 50% vers le haut, en vous déplaçant de 80% vers le haut.
{ "openState": [ { "openPercent": 30, "openDirection": "DOWN" }, { "openPercent": 50, "targetOpenPercent": 80, "openDirection": "UP" } ] }
Appareil COMMANDS
Les appareils dotés de cette caractéristique 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 la section Traitement des intents.
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 est fermé et 100 sont complètement ouverts. |
openDirection |
String |
Direction dans laquelle ouvrir l'élément. Présent uniquement si l'appareil est compatible avec plusieurs directions, comme indiqué par l'attribut Valeurs acceptées :
|
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" } }
Ouvrez l'appareil à 50 % vers le bas.
{ "command": "action.devices.commands.OpenClose", "params": { "openPercent": 50, "openDirection": "DOWN", "followUpToken": "456" } }
Erreurs associées
Une erreur s'est produite lors de la définition de l'état ouverture-fermeture de l'appareil.
Valeurs acceptées :
lockedState
deviceJammingDetected
Réponses de suivi
Les appareils dotés de cette caractéristique peuvent renvoyer la charge utile de réponse de suivi suivante dans le cadre de l'opération EXECUTE
. Pour en savoir plus sur la mise en œuvre 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 :
|
openPercent |
Number |
Obligatoire. Indique le pourcentage d'ouverture d'un appareil lorsque la valeur 0 est fermée et que la valeur 100 est complètement ouverte. |
d'é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 :
|
errorCode |
String |
Obligatoire. La valeur peut être n'importe quel code d'erreur pour cette caractéristique, par exemple |
Exemples
Ouvrez la porte du garage. (réponse de suivi en cas de réussite)
{ "OpenClose": { "priority": 0, "followUpResponse": { "openPercent": 100, "status": "SUCCESS", "followUpToken": "1234" } } }
Ouvrez 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 ouverture-fermeture de l'appareil par rapport à l'état actuel. Cette commande n'est disponible que si commandOnlyOpenClose
est défini sur false
.
{ "commandOnlyOpenClose": false }
Paramètres
Paramètres | Type | Description |
---|---|---|
openRelativePercent |
Number |
Obligatoire. Pourcentage exact d'évolution de l'état d'ouverture-fermeture. Les commandes relatives agrandis seront converties en un paramètre de pourcentage exact (par exemple, "Ouvrir les stores un peu plus" au lieu de "Ouvrir les stores à 5%"). |
openDirection |
String |
Direction dans laquelle ouvrir l'élément. Présent uniquement si l'appareil est compatible avec plusieurs directions, comme indiqué par l'attribut Valeurs acceptées :
|
Exemples
Ouvrez un peu plus l'appareil
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": 5 } }
Augmentation de 10% de la fermeture de l'appareil
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": -10 } }
Ouvrez l'appareil à 50% de plus, vers le bas.
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": 50, "openDirection": "DOWN" } }
Erreurs associées
Une erreur s'est produite lors de la définition de l'état 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%