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 inteligentnego działania domu

action.devices.traits.Volume – ten atrybut należy do urządzeń, które mogą zmieniać głośność (na przykład regulują głośność na określonym poziomie, wyciszać lub wyłączać wyciszenie).

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
volumeMaxLevel Liczba całkowita

Wymagany.

Maksymalny poziom głośności przy założeniu, że wartość bazowa to 0 (wyciszenie). Asystent będzie odpowiednio dostosowywać polecenia wypowiadane przez użytkownika (np. „zwiększ głośność telewizora”).

volumeCanMuteAndUnmute Wartość logiczna

Wymagany.

Wskazuje, czy urządzenie może wyciszać i wyłączać wyciszenie. Wyciszenie to oddzielna opcja, ponieważ działanie „wyciszenia” powoduje wyrównanie głośności do 0, zapamiętując poprzednie, dzięki czemu wyciszenie zostaje przywrócone. Znajduje to odzwierciedlenie w stanie głośności – jeśli głośność jest ustawiona na 5, a użytkownik wyciszy dźwięk, zostanie on ustawiony na 5, a wartość isMuted będzie ustawiona na wartość prawda.

volumeDefaultPercentage Liczba całkowita

(domyślnie: 40)

Głośność (w procentach) domyślnej liczby zdefiniowanej przez użytkownika lub producenta. Skala musi mieścić się w zakresie 0–100.

levelStepSize Liczba całkowita

(domyślnie: 1)

Domyślny rozmiar kroku dla zapytań o względnej głośności, takich jak „zwiększ głośność na <device_name>”.

commandOnlyVolume Wartość logiczna

(domyślnie: false)

Wskazuje, czy urządzenie działa z wykorzystaniem komunikacji jednokierunkowej (prawda) czy dwukierunkowej (fałsz). Jeśli na przykład po wysłaniu żądania kontroler może potwierdzić nowy stan urządzenia, to pole ma wartość Fałsz. Jeśli nie można potwierdzić, że żądanie zostało wykonane lub pozwala uzyskać stan urządzenia (na przykład jest to tradycyjne pilot na podczerwień), ustaw to pole na wartość true.

Przykłady

Urządzenie z głośnikiem, które można wyciszyć i raportuje bieżący stan

{
  "volumeMaxLevel": 11,
  "volumeCanMuteAndUnmute": true,
  "levelStepSize": 2,
  "commandOnlyVolume": false,
  "volumeDefaultPercentage": 6
}

Urządzenie STATES

W ramach operacji QUERY urządzenia z tą cechą mogą zawierać podane niżej stany. Więcej informacji o obsłudze intencji QUERY znajdziesz w sekcji Realizacja intencji.

Stany Typ Opis
currentVolume Liczba całkowita

Wymagany.

Bieżący procent głośności. Musi mieścić się w przedziale od >0 do volumeMaxLevel.

isMuted Wartość logiczna

Wymagane, jeśli atrybut volumeCanMuteAndUnmute ma wartość Prawda. Wartość to „prawda”, jeśli urządzenie jest wyciszone. W przeciwnym razie „fałsz”. Jeśli zasada isMuted ma wartość Prawda, urządzenie zwraca currentVolume dla pamiętanego punktu.

Przykłady

Urządzenie z głośnikiem, które można wyciszyć i raportuje bieżący stan

{
  "currentVolume": 5,
  "isMuted": false
}

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

Wycisza lub wycisza urządzenie.

Parametry

Parametry Typ Opis
mute Wartość logiczna

Wymagany.

Wyciszanie urządzenia i włączanie jego wyciszenia.

Przykłady

Wycisz głośnik

{
  "command": "action.devices.commands.mute",
  "params": {
    "mute": true
  }
}

action.devices.commands.setVolume

Ustaw głośność na żądanym poziomie na podstawie volumeMaxLevel.

Parametry

Parametry Typ Opis
volumeLevel Liczba całkowita

Wymagany.

Nowy wolumin od 0 do volumeMaxLevel.

Przykłady

Ustawianie bezwzględnej głośności głośnika

{
  "command": "action.devices.commands.setVolume",
  "params": {
    "volumeLevel": 6
  }
}

action.devices.commands.volumeRelative

Ustaw głośność w górę lub w dół n – zależnie od volumeMaxLevel. W przypadku poleceń, które używają wagi względnej, Asystent wybierze odpowiednią opcję n, aby przeprowadzić skalowanie do dostępnych kroków. Na przykład ustawienie Zwiększ głośność telewizora ustawi większą liczbę kroków niż Ustaw telewizor na trochę głośniejszy.

Parametry

Parametry Typ Opis
relativeSteps Liczba całkowita

Wymagany.

w przypadku wartości „zmniejsz”

Przykłady

Ustawianie względnej głośności głośnika w trybie poleceń

{
  "command": "action.devices.commands.volumeRelative",
  "params": {
    "relativeSteps": -1
  }
}

Urządzenie ERRORS

Zobacz pełną listę błędów i wyjątków.
  • volumeAlreadyMax: urządzenie otrzymuje polecenie VolumeUp, gdy głośność jest już najwyższa.
  • volumeAlreadyMin: urządzenie otrzymuje polecenie VolumeDown, gdy jest już ustawione na minimalną głośność.