Schemat cech inteligentnego domu ArmDisarm
action.devices.traits.ArmDisarm
– ten atrybut umożliwia włączenie i wyłączenie funkcji, na przykład w systemach bezpieczeństwa.
W przypadku urządzeń z wieloma poziomami zabezpieczeń należy podać te poziomy w atrybucie availableArmLevels
.
ATRYBUTY urządzenia
W ramach operacji SYNC
urządzenia z tą cechą mogą zgłaszać wymienione poniżej atrybuty. Więcej informacji o obsłudze intencji SYNC
znajdziesz w sekcji Realizacja intencji.
Atrybuty | Typ | Opis |
---|---|---|
availableArmLevels |
Obiekt |
Opisuje obsługiwane poziomy zabezpieczeń urządzenia. Jeśli nie zgłosisz tego atrybutu, urządzenie obsługuje tylko jeden poziom. |
levels |
Tablica |
Wymagany. Lista dostępnych poziomów zabezpieczeń obsługiwanych przez urządzenie. |
[item, ...] |
Obiekt |
Poziom zabezpieczeń. |
level_name |
Ciąg |
Wymagany. Wewnętrzna nazwa poziomu zabezpieczeń używanego w poleceniach i stanach. Ta nazwa może nie być przyjazna dla użytkownika i jest dostępna we wszystkich językach. |
level_values |
Tablica |
Wymagany. Zawiera |
[item, ...] |
Obiekt |
Synonim poziomu danego języka. |
level_synonym |
Tablica |
Wymagany. Łatwe do użycia nazwy w każdym obsługiwanym języku. Pierwszy element jest traktowany jako nazwa kanoniczna. |
[item, ...] |
Ciąg |
Nazwa synonimu. |
lang |
Ciąg |
Wymagany. Kod języka synonimów danego poziomu. Zobacz Obsługiwane języki. |
ordered |
Wartość logiczna |
Wymagany. Jeśli zasada ma wartość Prawda, obowiązują dodatkowe reguły gramatyczne dla zwiększania i zmniejszania wartości, zgodnie z kolejnością poziomów. Jeśli na przykład użyjesz polecenia „OK Google, zwiększ poziom zabezpieczeń o 1”, oznacza to, że Asystent określa bieżący poziom zabezpieczeń i zwiększa go o 1. Jeśli ma wartość Fałsz, gramatyka dodatkowa w celu zwiększenia lub obniżenia nie jest obsługiwana. |
Przykłady
System alarmowy z 2 różnymi poziomami rąk
{ "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 } }
Urządzenie STATES
W ramach operacji QUERY
encje o tym atrybucie mogą raportować te stany. Więcej informacji o obsłudze intencji QUERY
znajdziesz w sekcji Realizacja intencji.
Stany | Typ | Opis |
---|---|---|
isArmed |
Wartość logiczna |
Wymagany. Wskazuje, czy urządzenie jest obecnie włączone. |
currentArmLevel |
Ciąg |
Wymagany. Wymagane, jeśli podano atrybut |
exitAllowance |
Liczba całkowita |
Wskazuje czas w sekundach, w jakim użytkownik musi wyjść, zanim zacznie obowiązywać zasada |
Przykłady
System alarmowy z raportem o różnym poziomie ramienia
{ "isArmed": true, "currentArmLevel": "L1" }
Polecenie urządzenia
W ramach operacji EXECUTE
urządzenia z tą cechą mogą odpowiadać na podane niżej polecenia. Więcej informacji o obsłudze intencji EXECUTE
znajdziesz w sekcji Realizacja intencji.
action.devices.commands.ArmDisarm
Ustaw poziom alarmu na tym urządzeniu.
Parametry
Ładunek zawiera jeden z tych elementów:
Anuluj operację użycia uzbrojenia
Parametry | Typ | Opis |
---|---|---|
followUpToken |
Ciąg |
Token Google dostarczony w ramach dalszej odpowiedzi. |
arm |
Wartość logiczna |
Wymagany. Prawda, gdy polecenie jest włączone. Fałsz – wyłączenie. |
cancel |
Wartość logiczna |
Wymagany. Wartość to „prawda”, jeśli polecenie ma na celu anulowanie wartości |
Włącz lub wyłącz urządzenie za pomocą opcjonalnego poziomu zabezpieczeń.
Parametry | Typ | Opis |
---|---|---|
followUpToken |
Ciąg |
Token Google dostarczony w ramach dalszej odpowiedzi. |
arm |
Wartość logiczna |
Wymagany. Prawda, gdy polecenie jest włączone. Fałsz – wyłączenie. |
armLevel |
Ciąg |
|
Przykłady
Włącz system
{ "command": "action.devices.commands.ArmDisarm", "params": { "arm": true, "followUpToken": "123" } }
Ustaw system na poziomie ramienia L1
{ "command": "action.devices.commands.ArmDisarm", "params": { "arm": true, "armLevel": "L1", "followUpToken": "456" } }
Anulowanie operacji włączania
{ "command": "action.devices.commands.ArmDisarm", "params": { "arm": true, "cancel": true } }
Powiązane błędy
Wystąpił błąd podczas włączania lub wyłączania urządzenia.
Obsługiwane wartości:
alreadyInState
deviceTampered
passphraseIncorrect
pinIncorrect
securityRestriction
tooManyFailedAttempts
userCancelled