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 level_synonym i lang.

[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 availableArmLevels. Jeśli istnieje kilka poziomów zabezpieczeń, wskazuje nazwę bieżącego poziomu zabezpieczeń.

exitAllowance Liczba całkowita

Określa czas (w sekundach), jaki użytkownik ma na zaakceptowanie currentArmLevel.

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

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

level_name, aby włączyć tryb.

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

Podczas uzbrajania lub rozbrajania urządzenia wystąpił błąd.

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.