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 isMuted ma wartość prawda.
volumeDefaultPercentage	Liczba całkowita	(Domyślnie: 40) 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: 1) 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: false) 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 >0 do volumeMaxLevel.
isMuted	Wartość logiczna	Wymagany, jeśli atrybut volumeCanMuteAndUnmute ma wartość Prawda. Wartość „prawda”, jeśli urządzenie jest wyciszone, lub „fałsz” w przeciwnym razie. Jeśli isMuted ma wartość true (prawda), urządzenie nadal zwraca currentVolume dla zapamiętanego punktu.

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 0 do volumeMaxLevel.

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 polecenie VolumeUp, gdy ma już maksymalną głośność.
• volumeAlreadyMin: urządzenie odbiera polecenie VolumeDown, gdy ma już ustawioną minimalną głośność.