Schemat zadania Smart Home ArmDisarm

action.devices.traits.ArmDisarm – ta cecha umożliwia włączanie i wyłączanie stosowania zabezpieczeń w systemach bezpieczeństwa, np.

W przypadku urządzeń o wielu poziomach zabezpieczeń należy je zgłaszać za pomocą atrybutu availableArmLevels.

ATTRIBUTES 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 ten atrybut nie zostanie zgłoszony, urządzenie obsługuje tylko jeden 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 zabezpieczeń używanego w poleceniach i stanach. Ta nazwa może nie być łatwa w użyciu i dostępna we wszystkich językach.
level_values	Tablica	Wymagane. Zawiera level_synonym i lang.
[item, ...]	Obiekt	Synonim poziomu języka.
level_synonym	Tablica	Wymagane. Przyjazne nazwy poziomów w każdym obsługiwanym języku. Pierwszy element jest traktowany jako nazwa kanoniczna.
[item, ...]	String	Nazwa synonimu.
lang	String	Wymagane. Kod języka dla synonimów poziomu. Zobacz Obsługiwane języki.
ordered	Wartość logiczna	Wymagane. Jeśli ma wartość Prawda, obowiązuje gramatyka dodatkowa w celu zwiększenia lub zmniejszenia kolejności w kolejności poziomów. Na przykład „OK Google, zwiększ mój poziom bezpieczeństwa o 1” oznacza, że Asystent określa bieżący poziom bezpieczeństwa, a następnie zwiększa go o 1. Jeśli ma wartość Fałsz, gramatyka 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 z tą cechą mogą zgłaszać wymienione poniżej stany. Więcej informacji o obsłudze intencji QUERY znajdziesz w sekcji Realizacja intencji.

Stany	Typ	Opis
isArmed	Wartość logiczna	Wymagane. Wskazuje, czy urządzenie jest obecnie włączone.
currentArmLevel	String	Wymagane. Wymagane, jeśli określono atrybut availableArmLevels. Jeśli istnieje wiele poziomów zabezpieczeń, wskazuje nazwę bieżącego poziomu zabezpieczeń.
exitAllowance	Liczba całkowita	Wskazuje czas w sekundach, zanim użytkownik musi wyjść, zanim zasada currentArmLevel zacznie obowiązywać.

Przykłady

System bezpieczeństwa, który zgłasza różne poziomy ramion

{
  "isArmed": true,
  "currentArmLevel": "L1"
}

Urządzenie CommandS

W ramach operacji EXECUTE urządzenia z tą cechą mogą reagować 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 jedną z tych wartości:

Anuluj operację użycia ramienia lub broni

Parametry	Typ	Opis
followUpToken	String	Token udostępniony przez Google dla odpowiedzi uzupełniającej.
arm	Wartość logiczna	Wymagane. Wartość „prawda”, gdy poleceniem jest „uzbrojenie”. Fałsz.
cancel	Wartość logiczna	Wymagane. Jeśli polecenie ma na celu anulowanie wartości arm, pole ma wartość Prawda.

Włącz lub wyłącz urządzenie, uwzględniając opcjonalny poziom zabezpieczeń.

Parametry	Typ	Opis
followUpToken	String	Token udostępniony przez Google dla odpowiedzi uzupełniającej.
arm	Wartość logiczna	Wymagane. Wartość „prawda”, gdy poleceniem jest „uzbrojenie”. Fałsz.
armLevel	String	level_name do włączenia.

Przykłady

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