Schemat ustawień głośności w inteligentnym domu
action.devices.traits.Volume
– ta cecha należy do urządzeń, które mogą zmieniać głośność (np. ustawić określony poziom głośności oraz wyciszyć lub wyłączyć wyciszenie).
Urządzenie ATTRIBUTES
Urządzenia z tą cechą mogą zgłaszać poniższe atrybuty w ramach operacji SYNC
. Więcej informacji o obsłudze intencji SYNC
znajdziesz w artykule o realizacji intencji.
Atrybuty | Typ | Opis |
---|---|---|
volumeMaxLevel |
Liczba całkowita |
Wymagane. Maksymalny poziom głośności przy założeniu bazowym 0 (wyciszenie). Asystent odpowiednio dostosuje polecenia głosowe (np. „Zwiększ głośność telewizora”). |
volumeCanMuteAndUnmute |
Wartość logiczna |
Wymagane. Wskazuje, czy urządzenie może wyciszyć dźwięk lub wyłączyć jego wyciszenie. Wyciszenie stanowi osobną opcję, ponieważ funkcja wyciszenia zwiększa głośność do 0, zapamiętując poprzednią. Jest to odzwierciedlone w stanie głośności – jeśli głośność wynosi 5, a użytkownik wyciszy dźwięk, głośność pozostaje na poziomie 5, a zasada |
volumeDefaultPercentage |
Liczba całkowita |
(Domyślnie: Głośność (w procentach) domyślnej głośności określonej przez użytkownika lub producenta. Skala musi wynosić 0–100. |
levelStepSize |
Liczba całkowita |
(Domyślnie: Domyślny rozmiar kroku dla zapytań dotyczących liczby względnej, takich jak „Zwiększ głośność na <device_name>. |
commandOnlyVolume |
Wartość logiczna |
(Domyślnie: Wskazuje, czy urządzenie używa komunikacji jednokierunkowej (prawda) czy dwukierunkowej (fałsz). Jeśli na przykład kontroler może potwierdzić nowy stan urządzenia po wysłaniu żądania, to pole będzie mieć wartość false (fałsz). Jeśli nie można potwierdzić, czy żądanie zostało zrealizowane, ani uzyskać stanu urządzenia (np. jeśli jest to tradycyjny pilot na podczerwień), ustaw to pole na „true”. |
Przykłady
Głośnik, który można wyciszyć i raportuje bieżący stan
{ "volumeMaxLevel": 11, "volumeCanMuteAndUnmute": true, "levelStepSize": 2, "commandOnlyVolume": false, "volumeDefaultPercentage": 6 }
Urządzenie STATES
Encje z tą cechą mogą zgłaszać poniższe stany w ramach operacji QUERY
. Więcej informacji o obsłudze intencji QUERY
znajdziesz w artykule o realizacji intencji.
Stany | Typ | Opis |
---|---|---|
currentVolume |
Liczba całkowita |
Wymagane. Bieżąca wartość procentowa głośności. Wartość musi mieścić się w zakresie od |
isMuted |
Wartość logiczna |
Wymagany, jeśli atrybut |
Przykłady
Głośnik, który można wyciszyć i raportuje bieżący stan
{ "currentVolume": 5, "isMuted": false }
CommandS na urządzeniu
Urządzenia z tą cechą mogą reagować na podane niżej polecenia w ramach operacji EXECUTE
. Więcej informacji o obsłudze intencji EXECUTE
znajdziesz w artykule o realizacji intencji.
action.devices.commands.mute
Wycisza lub włącza wyciszenie urządzenia.
Parametry
Parametry | Typ | Opis |
---|---|---|
mute |
Wartość logiczna |
Wymagane. Określa, czy urządzenie ma wyciszyć czy wyłączyć wyciszenie. |
Przykłady
Wyciszanie głośnika
{ "command": "action.devices.commands.mute", "params": { "mute": true } }
action.devices.commands.setVolume
Ustaw głośność na żądanym poziomie (volumeMaxLevel
).
Parametry
Parametry | Typ | Opis |
---|---|---|
volumeLevel |
Liczba całkowita |
Wymagane. Nowy wolumin, od |
Przykłady
Ustawianie głośności bezwzględnej głośnika
{ "command": "action.devices.commands.setVolume", "params": { "volumeLevel": 6 } }
action.devices.commands.volumeRelative
Ustaw n kroków zwiększania lub zmniejszania głośności w zależności od ustawienia volumeMaxLevel
. W przypadku poleceń, które korzystają ze skali względnej, Asystent wybierze odpowiednio n, aby przeskalować je do kolejnych dostępnych kroków. Na przykład opcja Zwiększ głośność telewizora ustaw liczbę kroków na większą niż opcję Zmniejsz głośność telewizora.
Parametry
Parametry | Typ | Opis |
---|---|---|
relativeSteps |
Liczba całkowita |
Wymagane. „zmniejsz”. |
Przykłady
Ustawianie względnej głośności głośnika w trybie „tylko polecenia”
{ "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 odbiera polecenieVolumeUp
, gdy ma już maksymalną głośność.volumeAlreadyMin
: urządzenie odbiera polecenieVolumeDown
, gdy ma już ustawioną minimalną głośność.