Witamy w Google Home Developer Center – nowym miejscu, z którego dowiesz się, jak tworzyć inteligentne działania domowe. Uwaga: nadal będziesz tworzyć działania w konsoli Actions.
Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Schemat traktatu inteligentnego inteligentnego domu

action.devices.traits.ArmDisarm – ten atrybut obsługuje włączanie i wyłączanie broni, np. w systemach bezpieczeństwa.

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

ATRYBUTY na urządzeniu

Urządzenia z tą cechą mogą zgłaszać w ramach operacji SYNC te atrybuty. Więcej informacji o obsłudze intencji SYNC znajdziesz w artykule Realizacja intencji.

Atrybuty Typ Opis
availableArmLevels Obiekt

Opisuje obsługiwane poziomy zabezpieczeń urządzenia. Jeśli nie podasz tego atrybutu, 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 Ciąg

Wymagane.

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

Wymagane.

Zawiera level_synonym i lang.

[item, ...] Obiekt

synonim synonimu 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, ...] Ciąg

Nazwa synonimu.

lang Ciąg

Wymagane.

Kod języka synonimów poziomu. Zobacz obsługiwane języki.

ordered Wartość logiczna

Wymagane.

Jeśli ustawisz wartość prawda, obowiązuje gramatyka dodatkowa przyrostu lub zmniejszania (w kolejności tablicy poziomów). Na przykład „OK Google, zwiększ mój poziom zabezpieczeń o 1” – Asystent pokaże Ci obecny poziom zabezpieczeń, a potem go zwiększy o 1. Jeśli ta wartość ma wartość Fałsz, gramatyka dodatkowa na potrzeby zwiększania/zmniejszania nie jest obsługiwana.

Przykłady

System zabezpieczający z 2 różnymi poziomami ramion

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

Urządzenia z tą cechą mogą w ramach operacji QUERY zgłaszać następujące stany. 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 włączone.

currentArmLevel Ciąg

Wymagane.

Wymagany, 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, przez który użytkownik musi wyjść, zanim usługa currentArmLevel zacznie obowiązywać.

Przykłady

System bezpieczeństwa, który zgłasza osobne poziomy ramienia

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

Polecenia dotyczące urządzenia

Urządzenia z tą cechą mogą w ramach operacji EXECUTE reagować na następujące polecenia. Więcej informacji o obsłudze intencji EXECUTE znajdziesz w artykule Realizacja intencji.

action.devices.commands.ArmDisarm

Ustaw poziom alarmu na tym urządzeniu.

Parametry

Ładunek zawiera jedną z tych wartości:

Anuluj działanie uzbrojenia lub broni

Parametry Typ Opis
followUpToken Ciąg

Token Google do dalszej odpowiedzi.

arm Wartość logiczna

Wymagane.

Prawda, gdy polecenie jest włączone. Wartość fałsz, aby wyłączyć.

cancel Wartość logiczna

Wymagane.

Prawda, gdy polecenie ma anulować wartość arm.

Włącz lub wyłącz urządzenie, podając opcjonalny poziom bezpieczeństwa.

Parametry Typ Opis
followUpToken Ciąg

Token Google do dalszej odpowiedzi.

arm Wartość logiczna

Wymagane.

Prawda, gdy polecenie jest włączone. Wartość fałsz, aby wyłączyć.

armLevel Ciąg

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

Wystąpił błąd podczas włączania i 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.