Schemat działań inteligentnych woluminów domowych
action.devices.traits.Volume
– ta cecha należy do urządzeń, które mogą zmieniać głośność (na przykład ustawić głośność na określony poziom, włączyć lub wyłączyć wyciszenie).
ATTRIBUTES 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 |
Wymagane. Maksymalny poziom głośności przy założeniu, że wartość bazowa to 0 (wyciszenie). Asystent będzie odpowiednio dostosowywać polecenia głosowe (np. „zwiększ głośność telewizora”). |
volumeCanMuteAndUnmute |
Wartość logiczna |
Wymagane. Wskazuje, czy urządzenie może wyciszyć i wyłączyć wyciszenie. Wyciszenie to osobna opcja, ponieważ funkcja wyciszania ustawia głośność na 0, zapamiętując poprzedni, co pozwala przywrócić wyciszenie. 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 zachowany na poziomie 5, a wartość |
volumeDefaultPercentage |
Liczba całkowita |
(Domyślnie: Głośność (w procentach) w wartości domyślnej określonej 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 przy użyciu jednokierunkowej (prawda) czy dwukierunkowej (fałszywej) komunikacji. Jeśli na przykład po wysłaniu żądania kontroler może potwierdzić nowy stan urządzenia, to pole ma wartość false (fałsz). Jeśli nie można sprawdzić, czy żądanie zostało wykonane, czy też chcesz sprawdzić stan urządzenia (na przykład jest to tradycyjne pilot na podczerwień), ustaw to pole na wartość prawda. |
Przykłady
Urządzenie głośnika, 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
encje z tą cechą mogą zgłaszać wymienione poniżej stany. Więcej informacji o obsłudze intencji QUERY
znajdziesz w sekcji Realizacja intencji.
Stany | Typ | Opis |
---|---|---|
currentVolume |
Liczba całkowita |
Wymagane. Bieżący odsetek. Wartość musi mieścić się w zakresie od |
isMuted |
Wartość logiczna |
Wymagane, jeśli atrybut |
Przykłady
Urządzenie głośnika, które można wyciszyć i raportuje bieżący stan
{ "currentVolume": 5, "isMuted": false }
Urządzenie CommandS
W ramach operacji EXECUTE
urządzenia z tą cechą mogą reagować na podane niżej polecenia. Więcej informacji o obsłudze intencji EXECUTE
znajdziesz w sekcji Realizacja intencji.
action.devices.commands.mute
Wycisza lub wyłącza wyciszenie.
Parametry
Parametry | Typ | Opis |
---|---|---|
mute |
Wartość logiczna |
Wymagane. Określa, czy wyciszać urządzenie czy wyłączać wyciszenie. |
Przykłady
Wycisz głośnik
{ "command": "action.devices.commands.mute", "params": { "mute": true } }
action.devices.commands.setVolume
Ustaw poziom głośności na podstawie volumeMaxLevel
.
Parametry
Parametry | Typ | Opis |
---|---|---|
volumeLevel |
Liczba całkowita |
Wymagane. 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ść zwiększania lub zmniejszania n na podstawie volumeMaxLevel
. W przypadku poleceń, które używają wagi względnej, Asystent wybierze odpowiednią liczbę n, aby przeskalować ją do dostępnych kroków. Na przykład ustawienie Zwiększ głośność telewizora spowoduje ustawienie większej liczby kroków niż Ustaw telewizor na trochę głośniejszy dźwięk.
Parametry
Parametry | Typ | Opis |
---|---|---|
relativeSteps |
Liczba całkowita |
Wymagane. ujemne dla słowa „zmniejszenie”. |
Przykłady
Ustawianie względnej głośności głośnika w trybie wiersza 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 jego głośność jest już ustawiona na minimalny poziom.