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 wieloma poziomami zabezpieczeń te poziomy powinny być zgłaszane 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 w danym języku.
level_synonym	Tablica	Wymagany. Przyjazne dla użytkownika nazwy poziomu 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, stosuje się dodatkową gramatykę 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, nie jest obsługiwana dodatkowa składnia logiki zwiększania i zmniejszania.

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ą raportować 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	Wymagany. 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. Wartość true, gdy polecenie to uzbrojenie. False to disarm.
armLevel	String	level_name, aby włączyć tryb.

Przykłady

Włączanie systemu

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

BŁĘDY urządzenia

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