Bienvenue dans le centre Google Home pour les développeurs, la nouvelle destination pour apprendre à développer des actions pour la maison connectée. Remarque:Vous continuerez de créer des actions dans la console Actions.

Cette page a été traduite par l'API Cloud Translation.

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

action.devices.traits.OpenClose : cette caractéristique appartient aux dispositifs qui supportent l'ouverture et la fermeture, et, dans certains cas, partiellement ou potentiellement dans plusieurs directions.

ATTRIBUTS D'appareils

Les appareils présentant cette caractéristique peuvent signaler les éléments suivants : dans le cadre de l'opération SYNC. Pour apprendre Pour en savoir plus sur la gestion des intents SYNC, consultez Traitement des intents.

Attributs	Type	Description
`discreteOnlyOpenClose`	Valeur booléenne	(Par défaut : `false`) Lorsque cette règle est définie sur "true", cela indique que l'appareil doit être entièrement ouvert ou complètement fermé (c'est-à-dire qu'il n'accepte pas les valeurs comprises entre 0% et 100%).
`openDirection`	Array	Liste des instructions d'ouverture ou de fermeture compatibles avec l'appareil. Incluez cet attribut si l'appareil permet l'ouverture et la fermeture dans plusieurs directions.
`[item, ...]`	String	Sens accepté. 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 (vrai) ou bidirectionnelle (faux). Définissez cet attribut sur "true" si l'appareil ne peut pas répondre à un intent QUERY ou à l'état du rapport pour cette caractéristique.
`queryOnlyOpenClose`	Valeur booléenne	(Par défaut : `false`) Indique si l'appareil ne peut être interrogé que pour des informations d'état et 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 à ouverture-fermeture simple

{
  "discreteOnlyOpenClose": true
}

Appareil descendant de bas en haut. Ils peuvent être ouverts dans les deux sens.

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

Périphérique de commande uniquement.

{
  "commandOnlyOpenClose": false
}

STATES de l'appareil

Les entités présentant cette caractéristique peuvent signaler les éléments suivants : dans le cadre de l'opération QUERY. Pour apprendre Pour en savoir plus sur la gestion des intents QUERY, consultez Traitement des intents.

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

Ouverture-fermeture dans un seul sens

États Type Description

États	Type	Description
`openPercent`	Number	Obligatoire. Indique le pourcentage d'ouverture d'un appareil, où 0 correspond à fermé et 100 à être totalement ouvert.
`targetOpenPercent`	Number	Niveau indiquant le pourcentage d'ouverture où l'appareil ira ou se déplacera suite à un changement de position en cours.

openPercent

Number

Obligatoire.

Indique le pourcentage d'ouverture d'un appareil, où 0 correspond à fermé et 100 à être totalement ouvert.

targetOpenPercent

Number

Niveau indiquant le pourcentage d'ouverture où l'appareil ira ou se déplacera suite à un changement de position en cours.

Ouverture-fermeture dans plusieurs directions

États	Type	Description
`openState`	Array	Obligatoire. Liste des états pour chaque sens d'ouverture accepté.
`[item, ...]`	Objet	État actuel pour la direction d'ouverture donnée.
`openPercent`	Number	Obligatoire. Indique le pourcentage d'ouverture d'un appareil, où 0 correspond à fermé et 100 à être totalement ouvert.
`targetOpenPercent`	Number	Niveau indiquant le pourcentage d'ouverture où l'appareil ira ou se déplacera suite à un changement de position en cours.
`openDirection`	String	Obligatoire. Direction dans laquelle l'appareil est ouvert. Valeurs acceptées : `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`

Exemples

Appareil simple à ouverture et fermeture

{
  "openPercent": 100
}

Appareil simple d'ouverture-fermeture qui s'ouvre actuellement à 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 (passage de 80% vers le haut actuellement).

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

COMMANDS d'appareils

Les appareils présentant cette caractéristique peuvent répondre aux éléments suivants : dans le cadre de l'opération EXECUTE. Pour apprendre Pour en savoir plus sur la gestion des intents EXECUTE, consultez Traitement des intents.

`action.devices.commands.OpenClose`

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

Paramètres

Paramètres Type Description

Paramètres	Type	Description
`openPercent`	Number	Obligatoire. Indique le pourcentage d'ouverture d'un appareil, où 0 correspond à fermé et 100 à être totalement ouvert.
`openDirection`	String	Direction de l'ouverture. Uniquement présente si l'appareil prend en charge plusieurs directions, comme indiqué par l'attribut `openDirection` et si l'utilisateur spécifie une direction. Valeurs acceptées : `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`
`followUpToken`	String	Jeton fourni par Google pour la réponse de suivi.

openPercent

Number

Obligatoire.

Indique le pourcentage d'ouverture d'un appareil, où 0 correspond à fermé et 100 à être totalement ouvert.

openDirection

String

Direction de l'ouverture. Uniquement présente si l'appareil prend en charge plusieurs directions, comme indiqué par l'attribut openDirection et si l'utilisateur spécifie une direction.

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"
  }
}

Ouvrez l'appareil à 50 % vers le bas.

{
  "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 présentant cette caractéristique peuvent renvoyer les éléments suivants : charge utile de la réponse de suivi dans le cadre de l'opération EXECUTE. Pour apprendre comment implémenter 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

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 lorsque la valeur 0 est fermée et que la valeur 100 est totalement ouverte.

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 lorsque la valeur 0 est fermée et que la valeur 100 est totalement ouverte.

Échec

Champs Type Description

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 correspondre à n'importe quel code d'erreur pour cette caractéristique, par exemple `lockedState`.

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 correspondre à n'importe quel code d'erreur pour cette caractéristique, par exemple lockedState.

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 d'ouverture-fermeture de l'appareil par rapport à l'état actuel. Cette commande n'est disponible que si commandOnlyOpenClose est défini sur false.

Cette commande nécessite les attributs suivants:

{
  "commandOnlyOpenClose": false
}

Paramètres

Paramètres Type Description

Paramètres	Type	Description
`openRelativePercent`	Number	Obligatoire. Pourcentage exact de changement de l'état d'ouverture-fermeture. Les commandes relatives grosses seront converties en un paramètre de pourcentage exact (par exemple, "Ouvrir un peu plus les stores" ou "Ouvrir les stores de 5 %").
`openDirection`	String	Direction de l'ouverture. Uniquement présente si l'appareil prend en charge plusieurs directions, comme indiqué par l'attribut `openDirection` et si l'utilisateur spécifie une direction. Valeurs acceptées : `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`

openRelativePercent

Number

Obligatoire.

Pourcentage exact de changement de l'état d'ouverture-fermeture. Les commandes relatives grosses seront converties en un paramètre de pourcentage exact (par exemple, "Ouvrir un peu plus les stores" ou "Ouvrir les stores de 5 %").

openDirection

String

Direction de l'ouverture. Uniquement présente si l'appareil prend en charge plusieurs directions, comme indiqué par l'attribut openDirection et si l'utilisateur spécifie une direction.

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 10% en plus

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

Ouvrez l'appareil 50% plus souvent, 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 d'appareil

Voir la liste complète les erreurs et les exceptions.

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

ATTRIBUTS D'appareils

Exemples

STATES de l'appareil

Ouverture-fermeture dans un seul sens

Ouverture-fermeture dans plusieurs directions

Exemples

COMMANDS d'appareils

action.devices.commands.OpenClose

Paramètres

Exemples

Erreurs associées

Réponses de suivi

Opération réussie

Échec

Exemples

action.devices.commands.OpenCloseRelative

Paramètres

Exemples

Erreurs associées

Exemples d'énoncés

de-DE

en-US

es-ES

fr-FR

hi-IN

it-IT

ja-JP

ko-KR

nl-NL

pt-BR

sv-SE

Erreurs d'appareil

`action.devices.commands.OpenClose`

`action.devices.commands.OpenCloseRelative`