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 cech inteligentnego domu ArmDisarm

action.devices.traits.ArmDisarm – ten atrybut umożliwia włączenie i wyłączenie funkcji, na przykład w systemach bezpieczeństwa.

W przypadku urządzeń z wieloma poziomami zabezpieczeń należy podać te poziomy w atrybucie availableArmLevels.

ATRYBUTY 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 nie zgłosisz tego atrybutu, urządzenie obsługuje tylko jeden poziom.

levels Tablica

Wymagany.

Lista dostępnych poziomów zabezpieczeń obsługiwanych przez urządzenie.

[item, ...] Obiekt

Poziom zabezpieczeń.

level_name Ciąg

Wymagany.

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

Wymagany.

Zawiera level_synonym i lang.

[item, ...] Obiekt

Synonim poziomu danego języka.

level_synonym Tablica

Wymagany.

Łatwe do użycia nazwy w każdym obsługiwanym języku. Pierwszy element jest traktowany jako nazwa kanoniczna.

[item, ...] Ciąg

Nazwa synonimu.

lang Ciąg

Wymagany.

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

ordered Wartość logiczna

Wymagany.

Jeśli zasada ma wartość Prawda, obowiązują dodatkowe reguły gramatyczne dla zwiększania i zmniejszania wartości, zgodnie z kolejnością poziomów. Jeśli na przykład użyjesz polecenia „OK Google, zwiększ poziom zabezpieczeń o 1”, oznacza to, że Asystent określa bieżący poziom zabezpieczeń i zwiększa go o 1. Jeśli ma wartość Fałsz, gramatyka dodatkowa 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 o tym atrybucie mogą raportować te stany. Więcej informacji o obsłudze intencji QUERY znajdziesz w sekcji Realizacja intencji.

Stany Typ Opis
isArmed Wartość logiczna

Wymagany.

Wskazuje, czy urządzenie jest obecnie włączone.

currentArmLevel Ciąg

Wymagany.

Wymagane, jeśli podano atrybut availableArmLevels. Jeśli istnieje wiele poziomów zabezpieczeń, wskazuje nazwę bieżącego poziomu zabezpieczeń.

exitAllowance Liczba całkowita

Wskazuje czas w sekundach, w jakim użytkownik musi wyjść, zanim zacznie obowiązywać zasada currentArmLevel.

Przykłady

System alarmowy z raportem o różnym poziomie ramienia

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

Polecenie urządzenia

W ramach operacji EXECUTE urządzenia z tą cechą mogą odpowiadać 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 jeden z tych elementów:

Anuluj operację użycia uzbrojenia

Parametry Typ Opis
followUpToken Ciąg

Token Google dostarczony w ramach dalszej odpowiedzi.

arm Wartość logiczna

Wymagany.

Prawda, gdy polecenie jest włączone. Fałsz – wyłączenie.

cancel Wartość logiczna

Wymagany.

Wartość to „prawda”, jeśli polecenie ma na celu anulowanie wartości arm.

Włącz lub wyłącz urządzenie za pomocą opcjonalnego poziomu zabezpieczeń.

Parametry Typ Opis
followUpToken Ciąg

Token Google dostarczony w ramach dalszej odpowiedzi.

arm Wartość logiczna

Wymagany.

Prawda, gdy polecenie jest włączone. Fałsz – wyłączenie.

armLevel Ciąg

level_name do włączenia.

Przykłady

Włącz 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 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.