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 level_synonym i lang.
[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 availableArmLevels. Jeśli istnieje wiele poziomów zabezpieczeń, wskazuje nazwę bieżącego poziomu zabezpieczeń.
exitAllowance	Liczba całkowita	Wskazuje czas w sekundach, w jakim użytkownik musi wyjść, zanim zacznie obowiązywać zasada currentArmLevel.

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 arm.

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	level_name do włączenia.

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

Urządzenie ERRORS

Zobacz pełną listę błędów i wyjątków.