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:
|
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:
|
errorCode |
Stringa |
Obbligatorio. Il valore può essere qualsiasi codice di errore per questa caratteristica, ad esempio |
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