Schemat cechy ArmDisarm inteligentnego domu

action.devices.traits.ArmDisarm – ta cecha obsługuje włączanie i wyłączanie alarmu, np. w systemach alarmowych.

W przypadku urządzeń z kilkoma poziomami zabezpieczeń te poziomy należy 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łudze intencji SYNC znajdziesz w artykule Realizacja intencji.

Atrybuty Typ Opis
availableArmLevels Obiekt

Opis obsługiwanych poziomów zabezpieczeń urządzenia. Jeśli ten atrybut nie jest zgłaszany, urządzenie obsługuje tylko 1 poziom.
levels Tablica

Wymagane.

Lista dostępnych poziomów zabezpieczeń obsługiwanych przez urządzenie.
[item, ...] Obiekt

Poziom bezpieczeństwa.
level_name String

Wymagane.

Wewnętrzna nazwa poziomu bezpieczeństwa używana w poleceniach i stanach. Ta nazwa może być nieprzyjazna dla użytkownika i jest wspólna dla wszystkich języków.
level_values Tablica

Wymagane.

Zawiera level_synonym i lang.
[item, ...] Obiekt

Synonim poziomu w danym języku. Aby zapewnić rezerwę językową, wymagany jest co najmniej 1 element z wartością lang równą en.
level_synonym Tablica

Wymagane.

Nazwy poziomu przyjazne dla użytkownika w każdym obsługiwanym języku. Pierwszy element jest traktowany jako nazwa kanoniczna.
[item, ...] String

Nazwa synonimu. Aby zapewnić rezerwę językową, wymagany jest co najmniej 1 element z wartością lang równą en.
lang String

Wymagane.

Kod języka dla synonimów poziomu. Zobacz Obsługiwane języki.
ordered Wartość logiczna

Wymagane.

Jeśli ustawisz wartość true, będzie stosowana dodatkowa gramatyka dla logiki zwiększania/zmniejszania w kolejności tablicy poziomów. Na przykład „OK Google, zwiększ poziom bezpieczeństwa o 1” spowoduje, że Asystent określi bieżący poziom bezpieczeństwa, a następnie zwiększy go o 1. Jeśli ta wartość jest ustawiona na false, dodatkowa gramatyka dla logiki zwiększania/zmniejszania nie jest obsługiwana.

Przykłady

System alarmowy z 2 różnymi poziomami alarmu

{
  "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
  }
}

STANY urządzenia

Jednostki z tą cechą mogą zgłaszać te stany w ramach operacji QUERY. Więcej informacji o obsłudze intencji QUERY znajdziesz w artykule Realizacja intencji.

Stany Typ Opis
isArmed Wartość logiczna

Wymagane.

Wskazuje, czy urządzenie jest obecnie uzbrojone.
currentArmLevel String

Wymagane.

Wymagane, jeśli określono atrybut availableArmLevels. Jeśli istnieje kilka poziomów zabezpieczeń, wskazuje nazwę bieżącego poziomu zabezpieczeń.
exitAllowance Liczba całkowita

Wskazuje czas w sekundach, jaki użytkownik ma na opuszczenie pomieszczenia, zanim zacznie obowiązywać currentArmLevel.

Przykłady

System alarmowy, który zgłasza odrębny poziom alarmu

{
  "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łudze intencji EXECUTE znajdziesz w artykule Realizacja intencji.

action.devices.commands.ArmDisarm

Ustaw poziom alarmu tego urządzenia.

Parametry

Ładunek zawiera jedną z tych wartości:

Anulowanie operacji włączania lub wyłączania alarmu

Parametry Typ Opis
followUpToken String

Token dostarczony przez Google na potrzeby odpowiedzi uzupełniającej.
arm Wartość logiczna

Wymagane.

Wartość true, gdy polecenie ma włączyć alarm. Wartość false, aby wyłączyć alarm.
cancel Wartość logiczna

Wymagane.

Wartość true, gdy polecenie ma anulować wartość arm.

Włączanie lub wyłączanie alarmu urządzenia z opcjonalnym poziomem bezpieczeństwa.

Parametry Typ Opis
followUpToken String

Token dostarczony przez Google na potrzeby odpowiedzi uzupełniającej.
arm Wartość logiczna

Wymagane.

Wartość true, gdy polecenie ma włączyć alarm. Wartość false, aby wyłączyć alarm.
armLevel String

level_name, na którą ma zostać ustawiony alarm.

Przykłady

Włączanie alarmu

{
  "command": "action.devices.commands.ArmDisarm",
  "params": {
    "arm": true,
    "followUpToken": "123"
  }
}

Ustawianie systemu na poziom alarmu L1

{
  "command": "action.devices.commands.ArmDisarm",
  "params": {
    "arm": true,
    "armLevel": "L1",
    "followUpToken": "456"
  }
}

Anulowanie operacji włączania alarmu

{
  "command": "action.devices.commands.ArmDisarm",
  "params": {
    "arm": true,
    "cancel": true
  }
}

Podczas włączania lub wyłączania alarmu urządzenia wystąpił błąd.

Obsługiwane wartości:

alreadyInState
deviceTampered
passphraseIncorrect
pinIncorrect
securityRestriction
tooManyFailedAttempts
userCancelled

BŁĘDY urządzenia

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