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ść |
volumeDefaultPercentage |
Liczba całkowita |
(domyślnie: 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: 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: 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 |
isMuted |
Wartość logiczna |
Wymagane, jeśli atrybut |
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 |
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 polecenieVolumeUp
, gdy głośność jest już najwyższa.volumeAlreadyMin
: urządzenie otrzymuje polecenieVolumeDown
, gdy jest już ustawione na minimalną głośność.