Schema tratto di sblocco smart home

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

ATTRIBUTE del dispositivo

Nessuna.

STATEs dispositivo

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

Stati	Tipo	Descrizione
isLocked	Booleano	Indica se al momento il dispositivo è bloccato.
isJammed	Booleano	Se il dispositivo è attualmente bloccato e pertanto il suo stato di blocco non può essere stabilito.

Esempi

Dispositivo bloccato

{
  "isLocked": true
}

Dispositivo bloccato

{
  "isJammed": true
}

comandi del 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 Soddisfazione degli intent.

action.devices.commands.LockUnlock

Blocca o sblocca il dispositivo.

Parametri

Parametri	Tipo	Descrizione
lock	Booleano	Obbligatorio. Vero quando il comando è bloccare, falso per sbloccare.
followUpToken	Stringa	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"
  }
}

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 questa caratteristica possono restituire il seguente payload di risposta di follow-up nell'ambito dell'operazione EXECUTE. Per scoprire di più sull'implementazione delle risposte successive, consulta Notifiche per le azioni relative alla smart home.

Il payload contiene uno dei seguenti valori:

Operazione riuscita: bloccato

Campi	Tipo	Descrizione
followUpToken	Stringa	Obbligatorio. Token fornito nella richiesta EXECUTE originale.
status	Stringa	Obbligatorio. Risultato della richiesta. Valori supportati: SUCCESS
isLocked	Booleano	Obbligatorio. Indica se il dispositivo è bloccato.

Non riuscita

Campi	Tipo	Descrizione
followUpToken	Stringa	Obbligatorio. Token fornito nella richiesta EXECUTE originale.
status	Stringa	Obbligatorio. Risultato della richiesta. Valori supportati: FAILURE
errorCode	Stringa	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 la richiesta di successo)

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

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

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

Chiudi la serratura della porta principale. (risposta di follow-up per la richiesta di assistenza non riuscita)

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

Esempi di frasi

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 degli errori e delle eccezioni.