Schéma de la trame de déverrouillage de la maison connectée

action.devices.traits.LockUnlock : cette caractéristique appartient à tous les appareils compatibles avec le verrouillage et le déverrouillage, et/ou le signalement d'un état verrouillé.

ATTRIBUTS D'appareils

Aucun

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.

États	Type	Description
isLocked	Valeur booléenne	Indique si l'appareil est actuellement verrouillé.
isJammed	Valeur booléenne	Si l'appareil est actuellement bloqué, il est donc impossible de déterminer son état verrouillé.

Exemples

Appareil verrouillé

{
  "isLocked": true
}

Appareil bloqué

{
  "isJammed": true
}

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

verrouiller ou déverrouiller l'appareil ;

Paramètres

Paramètres	Type	Description
lock	Valeur booléenne	Obligatoire. "True" lorsque la commande sert à verrouiller, "false" pour déverrouiller.
followUpToken	String	Jeton fourni par Google pour la réponse de suivi.

Exemples

Verrouille la porte d'entrée.

{
  "command": "action.devices.commands.LockUnlock",
  "params": {
    "lock": true,
    "followUpToken": "123"
  }
}

Déverrouillez la porte d'entrée.

{
  "command": "action.devices.commands.LockUnlock",
  "params": {
    "lock": false,
    "followUpToken": "567"
  }
}

Erreurs associées

Une erreur s'est produite lors du verrouillage ou du déverrouillage de l'appareil.

Valeurs acceptées :

remoteSetDisabled

deviceJammingDetected

notSupported

alreadyLocked

alreadyUnlocked

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:

Réussite: Verrouillée

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
isLocked	Valeur booléenne	Obligatoire. Indique si l'appareil est verrouillé.

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

Exemples

Verrouille la porte d'entrée. (réponse de suivi en cas de réussite)

{
  "LockUnlock": {
    "priority": 0,
    "followUpResponse": {
      "status": "SUCCESS",
      "isLocked": true,
      "followUpToken": "1234"
    }
  }
}

Déverrouillez la porte d'entrée. (réponse de suivi en cas de réussite)

{
  "LockUnlock": {
    "priority": 0,
    "followUpResponse": {
      "status": "SUCCESS",
      "isLocked": false,
      "followUpToken": "1234"
    }
  }
}

Verrouille la porte d'entrée. (réponse de suivi en cas d'échec)

{
  "LockUnlock": {
    "priority": 0,
    "followUpResponse": {
      "status": "FAILURE",
      "errorCode": "deviceJammingDetected",
      "followUpToken": "1234"
    }
  }
}

Exemples d'énoncés

<ph type="x-smartling-placeholder">

de-DE

• Bitte Eingangstür abschließen
• Bitte schließ die Eingangstür auf

en-US

• lock my doors
• unlock study room

es-ES

• cierra la puerta con llave
• quitar el cerrojo de la puerta de entrad a

fr-FR

• déverrouille la porte d'entrée
• verrouille la porte d'entrée

hi-IN

• फ़्रंट डोर अनलॉक करो
• सामने के दरवाजे को लॉक करो

it-IT

• apri la porta d'ingresso
• puoi chiudere la porta d'ingresso a chiave

ja-JP

• 玄関のドア を施錠して
• 玄関 開錠して

ko-KR

• 도어락 잠가 줘
• 현관 도어락 열어 줄래

nl-NL

• Ontgrendel de voordeur
• doe de voordeur op slot

pt-BR

• Tranca a porta do quarto .
• destranca a porta da cozinha
• destrancar a porta da frente
• trancar a porta da frente

sv-SE

• lås upp ytterdörren
• lås ytterdörren

Erreurs d'appareil

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