Schéma de trait de déverrouillage de serrure pour 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 avec le signalement d'un état verrouillé.

ATTRIBUTS de l'appareil

Aucune.

ÉTATS DE L'APPAREIL

Les entités avec 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.

États Type Description
isLocked Valeur booléenne

Indique si l'appareil est actuellement verrouillé.
isJammed Valeur booléenne

Indique si l'appareil est actuellement bloqué et si son état verrouillé ne peut pas être déterminé.

Exemples

Appareil verrouillé

{
  "isLocked": true
}

Appareil bloqué

{
  "isJammed": true
}

COMMANDES DE L'APPAREIL

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

Verrouillez ou déverrouillez l'appareil.

Paramètres

Paramètres Type Description
lock Valeur booléenne

Obligatoire.

"True" lorsque la commande consiste à 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éverrouille la porte d'entrée.

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

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 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 l'implémentation de réponses de suivi, consultez la section Notifications pour les actions de la maison connectée.

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

Opération réussie: verrouillé

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 être n'importe quel code d'erreur pour ce trait, par exemple deviceJammingDetected.

Exemples

Verrouille la porte d'entrée. (follow-up response for success case)

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

Déverrouille la porte d'entrée. (follow-up response for success case)

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

Verrouille la porte d'entrée. (réponse de suivi pour l'exemple d'échec)

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

Exemples d'énoncés

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 de l'appareil

Consultez la liste complète des erreurs et exceptions.