Schema dei tratti di sblocco per la serratura della smart home

action.devices.traits.LockUnlock: questa caratteristica appartiene a tutti i dispositivi che supportano il blocco e lo sblocco e/o segnalano uno stato bloccato.

ATTRIBUTI del dispositivo

Nessuno.

STATI del dispositivo

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

Stati Tipo Descrizione
isLocked Valore booleano

Indica se il dispositivo è attualmente bloccato.
isJammed Valore booleano

Indica se il dispositivo è attualmente bloccato e quindi non è possibile determinare il suo stato di blocco.

Esempi

Dispositivo bloccato

{
  "isLocked": true
}

Dispositivo bloccato

{
  "isJammed": true
}

COMANDI dispositivo

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

action.devices.commands.LockUnlock

Blocca o sblocca il dispositivo.

Parametri

Parametri Tipo Descrizione
lock Valore booleano

Obbligatorio.

True quando il comando è di 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 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 tratto potrebbero restituire il seguente payload di risposta di follow-up nell'ambito dell'operazione EXECUTE. Per scoprire di più sull'implementazione delle risposte di follow-up, vedi Notifiche per le azioni per la smart home.

Il payload contiene uno dei seguenti elementi:

Operazione riuscita: bloccato

Campi Tipo Descrizione
followUpToken String

Obbligatorio.

Token fornito nella richiesta EXECUTE originale.
status String

Obbligatorio.

Risultato della richiesta.

Valori supportati:

SUCCESS
isLocked Valore booleano

Obbligatorio.

Indica se il dispositivo è bloccato.

Operazione 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 porta d'ingresso. (follow-up response for success case)

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

Apri la porta principale. (follow-up response for success case)

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

Chiudi la porta d'ingresso. (follow-up response for failure case)

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

Frasi 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

ERRORI del dispositivo

Consulta l'elenco completo di errori ed eccezioni.