Schemat cechy Smart Home ArmDisarm
action.devices.traits.ArmDisarm
– ta cecha obsługuje uzbrajanie i rozbrajanie, które jest używane na przykład w systemach bezpieczeństwa.
W przypadku urządzeń z kilkoma poziomami zabezpieczeń należy je zgłaszać za pomocą atrybutu availableArmLevels
.
ATRYBUTY URZĄDZENIA
Urządzenia z tą cechą mogą zgłaszać te atrybuty w ramach operacji SYNC
. Więcej informacji o obsługiwaniu intencji SYNC
znajdziesz w artykule Realizacja intencji.
Atrybuty | Typ | Opis |
---|---|---|
availableArmLevels |
Obiekt |
Opisuje obsługiwane poziomy zabezpieczeń urządzenia. Jeśli ten atrybut nie jest raportowany, urządzenie obsługuje tylko 1 poziom. |
levels |
Tablica |
Wymagany. Lista dostępnych poziomów zabezpieczeń obsługiwanych przez urządzenie. |
[item, ...] |
Obiekt |
Poziom bezpieczeństwa. |
level_name |
String |
Wymagany. Wewnętrzna nazwa poziomu zabezpieczeń używana w poleceniach i stanach. Ta nazwa może być nieprzyjazna dla użytkowników i jest wspólna dla wszystkich języków. |
level_values |
Tablica |
Wymagany. Zawiera |
[item, ...] |
Obiekt |
Synonim poziomu dla danego języka. |
level_synonym |
Tablica |
Wymagane. Przyjazne dla użytkownika nazwy poziomów w każdym obsługiwanym języku. Pierwszy element jest traktowany jako nazwa kanoniczna. |
[item, ...] |
String |
Nazwa synonimu. |
lang |
String |
Wymagany. Kod języka synonimów poziomu. Zobacz obsługiwane języki. |
ordered |
Wartość logiczna |
Wymagany. Jeśli ta opcja ma wartość Prawda, jest stosowana dodatkowa składnia dla zwiększania i zmniejszania w kolejności tablicy levels. Na przykład polecenie „OK Google, zwiększ poziom zabezpieczeń o 1” powoduje, że Asystent określa bieżący poziom zabezpieczeń, a następnie zwiększa go o 1. Jeśli ta wartość ma wartość Fałsz, logika zwiększania/zmniejszania wartości gramatycznej nie jest obsługiwana. |
Przykłady
System alarmowy z 2 poziomami uzbrojenia
{ "availableArmLevels": { "levels": [ { "level_name": "L1", "level_values": [ { "level_synonym": [ "Home and Guarding", "SL1" ], "lang": "en" }, { "level_synonym": [ "Zuhause und Bewachen", "SL1" ], "lang": "de" } ] }, { "level_name": "L2", "level_values": [ { "level_synonym": [ "Away and Guarding", "SL2" ], "lang": "en" }, { "level_synonym": [ "Weg und Bewachen", "SL2" ], "lang": "de" } ] } ], "ordered": true } }
STANOWISKO URZĄDZENIA
Elementy z tą cechą mogą zgłaszać te stany w ramach operacji QUERY
. Więcej informacji o obsługiwaniu intencji QUERY
znajdziesz w artykule Realizacja intencji.
Stany | Typ | Opis |
---|---|---|
isArmed |
Wartość logiczna |
Wymagany. Wskazuje, czy urządzenie jest obecnie uzbrojone. |
currentArmLevel |
String |
Wymagane. Wymagana, jeśli podano atrybut |
exitAllowance |
Liczba całkowita |
Określa czas (w sekundach), jaki użytkownik ma na zaakceptowanie |
Przykłady
System bezpieczeństwa, który raportuje oddzielny poziom włączenia
{ "isArmed": true, "currentArmLevel": "L1" }
Polecenia urządzenia
Urządzenia z tą cechą mogą odpowiadać na te polecenia w ramach operacji EXECUTE
. Więcej informacji o obsługiwaniu intencji EXECUTE
znajdziesz w artykule Realizacja intencji.
action.devices.commands.ArmDisarm
Ustaw poziom alarmu na tym urządzeniu.
Parametry
Ładunek zawiera jedną z tych opcji:
Anulowanie operacji włączania lub wyłączania wykrywania
Parametry | Typ | Opis |
---|---|---|
followUpToken |
String |
Token dostarczony przez Google do odpowiedzi uzupełniającej. |
arm |
Wartość logiczna |
Wymagany. Wartość true, gdy polecenie to uzbrojenie. False to disarm. |
cancel |
Wartość logiczna |
Wymagany. Prawda, gdy polecenie ma anulować wartość |
Włączanie i wyłączanie urządzenia z opcjonalnym poziomem zabezpieczeń.
Parametry | Typ | Opis |
---|---|---|
followUpToken |
String |
Token dostarczony przez Google do odpowiedzi uzupełniającej. |
arm |
Wartość logiczna |
Wymagany. Prawda, gdy polecenie ma włączyć. False to disarm. |
armLevel |
String |
|
Przykłady
Włącz system
{ "command": "action.devices.commands.ArmDisarm", "params": { "arm": true, "followUpToken": "123" } }
Ustaw system na poziom uzbrojenia L1
{ "command": "action.devices.commands.ArmDisarm", "params": { "arm": true, "armLevel": "L1", "followUpToken": "456" } }
Anulowanie włączania i wyłączania uzbrojenia
{ "command": "action.devices.commands.ArmDisarm", "params": { "arm": true, "cancel": true } }
Powiązane błędy
Podczas uzbrajania lub rozbrajania urządzenia wystąpił błąd.
Obsługiwane wartości:
alreadyInState
deviceTampered
passphraseIncorrect
pinIncorrect
securityRestriction
tooManyFailedAttempts
userCancelled