Schema dei tratti di sblocco per la serratura della smart home

action.devices.traits.LockUnlock: questo tratto appartiene a tutti i dispositivi che supportano la chiusura e lo sblocco e/o la segnalazione dello stato di blocco.

ATTRIBUTES dispositivo

Nessuno.

STATES del dispositivo

Le entità con questo tratto possono segnalare quanto segue nell'ambito dell'operazione QUERY. Per ulteriori informazioni scopri di più sulla gestione degli intent QUERY; consulta Completamento dell'intent.

Stati	Tipo	Descrizione
isLocked	Valore booleano	Indica se il dispositivo è attualmente bloccato.
isJammed	Valore booleano	Se il dispositivo è attualmente bloccato e quindi il suo stato di blocco non può essere determinato.

Esempi

Dispositivo bloccato

{
  "isLocked": true
}

Dispositivo inceppato

{
  "isJammed": true
}

COMANDI dispositivo

I dispositivi con questo tratto potrebbero rispondere ai seguenti nell'ambito dell'operazione EXECUTE. Per ulteriori informazioni scopri di più sulla gestione degli intent EXECUTE; consulta Completamento dell'intent.

action.devices.commands.LockUnlock

Blocca o sblocca il dispositivo.

Parametri

Parametri	Tipo	Descrizione
lock	Valore booleano	Obbligatorio. True se il comando è bloccare, false per sbloccare.
followUpToken	String	Token fornito da Google per la risposta di follow-up.

Esempi

Chiudi la porta d'ingresso.

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

Apri la porta principale.

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

Errori correlati

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 quanto segue Payload della risposta di follow-up come parte dell'operazione EXECUTE. Per ulteriori informazioni per ulteriori informazioni sull'implementazione delle risposte aggiuntive, consulta Notifiche per le azioni della smart home.

Il payload contiene uno dei seguenti elementi:

Operazione riuscita: bloccata

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 questo tratto, ad esempio deviceJammingDetected.

Esempi

Chiudi la porta d'ingresso. (risposta di follow-up per i casi di successo)

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

Apri la porta principale. (risposta di follow-up per i casi di successo)

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

Chiudi la porta d'ingresso. (risposta di follow-up in caso di errore)

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

Esempi di enunciato

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 dispositivo

Consulta l'elenco completo errori ed eccezioni.