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ść.