Schema dei tratti di sblocco per la smart home

action.devices.traits.LockUnlock: questa trait appartiene a tutti i dispositivi che supportano il blocco e lo sblocco e/o la segnalazione di uno stato di blocco.

ATTRIBUTES del dispositivo

Nessuna.

Dispositivo STATES

Le entità con questo trait possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per scoprire di più sulla gestione degli intent QUERY, consulta fulfillment dell'intent.

Stati Tipo Descrizione
isLocked Booleano

Indica se il dispositivo è attualmente bloccato.

isJammed Booleano

Se il dispositivo è attualmente bloccato e quindi non è possibile determinarne lo stato di blocco.

Esempi

Dispositivo bloccato

{
  "isLocked": true
}

Dispositivo bloccato

{
  "isJammed": true
}

COMMANDS dispositivo

I dispositivi con questa caratteristica potrebbero rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per scoprire di più sulla gestione degli intent EXECUTE, consulta fulfillment dell'intent.

action.devices.commands.LockUnlock

Blocca o sblocca il dispositivo.

Parametri

Parametri Tipo Descrizione
lock Booleano

Obbligatorio.

True quando il comando corrisponde al blocco, false per sbloccare.

followUpToken String

Token fornito da Google per la risposta di follow-up.

Esempi

Chiudi la serratura della porta principale.

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

Apri la serratura della porta principale.

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

Si è verificato un errore durante il blocco o lo sblocco del dispositivo.

Valori supportati:

remoteSetDisabled
deviceJammingDetected
notSupported
alreadyLocked
alreadyUnlocked

Risposte di follow-up

I dispositivi con questo trait possono restituire il seguente payload della risposta di follow-up nell'ambito dell'operazione EXECUTE. Per scoprire di più sull'implementazione delle risposte di follow-up, consulta Notifiche per le azioni per la smart home.

Il payload contiene uno dei seguenti valori:

Operazione riuscita: blocco

Campi Tipo Descrizione
followUpToken String

Obbligatorio.

Token fornito nella richiesta EXECUTE originale.

status String

Obbligatorio.

Risultato della richiesta.

Valori supportati:

SUCCESS
isLocked Booleano

Obbligatorio.

Indica se il dispositivo è bloccato.

Non riuscita

Campi Tipo Descrizione
followUpToken String

Obbligatorio.

Token fornito nella richiesta EXECUTE originale.

status String

Obbligatorio.

Risultato della richiesta.

Valori supportati:

FAILURE
errorCode String

Obbligatorio.

Il valore può essere qualsiasi codice di errore per questa caratteristica, ad esempio deviceJammingDetected.

Esempi

Chiudi la serratura della porta principale. (risposta di follow-up per caso di successo)

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

Apri la serratura della porta principale. (risposta di follow-up per caso di successo)

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

Chiudi la serratura della porta principale. (risposta di follow-up per caso di errore)

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

Espressioni di esempio

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

ERRORS dispositivo

Consulta l'elenco completo di errori ed eccezioni.