Schemat cechy Inteligentny dom – głośność

action.devices.traits.Volume – ta cecha należy do urządzeń, które mogą zmieniać głośność (np. ustawiać głośność na określonym poziomie, wyciszać lub wyłączać wyciszenie).

ATRYBUTY URZĄDZENIA

Urządzenia z tą cechą mogą zgłaszać te 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

Wymagany.

Maksymalny poziom głośności, przy założeniu, że wartość bazowa wynosi 0 (wyciszanie). Asystent dostosuje polecenia przymiotnikowe (np. „zwiększ głośność telewizora”) odpowiednio do kontekstu.
volumeCanMuteAndUnmute Wartość logiczna

Wymagany.

Wskazuje, czy urządzenie może wyciszyć i włączyć głośność. Wyciszenie jest osobną opcją, ponieważ zachowanie „wyciszenie” ustawia głośność na 0, jednocześnie zapamiętując poprzednią głośność, dzięki czemu przywrócenie dźwięku przywraca ją do poprzedniego poziomu. 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ść pozostanie na poziomie 5, a isMuted będzie ustawiona na prawda.
volumeDefaultPercentage Liczba całkowita

(wartość domyślna: 40)

Głośność (w procentach) domyślnej głośności zdefiniowanej przez użytkownika lub producenta. Skala musi zawierać się w zakresie od 0 do 100.
levelStepSize Liczba całkowita

(wartość domyślna: 1)

Domyślny krok dla zapytań dotyczących względnej głośności, takich jak „zwiększ głośność na <device_name>”.
commandOnlyVolume Wartość logiczna

(Domyślnie: false)

Wskazuje, czy urządzenie działa w trybie 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 miało wartość false. Jeśli nie można sprawdzić, czy żądanie zostało wykonane, ani sprawdzić stanu urządzenia (np. jeśli jest to tradycyjny pilot na podczerwień), ustaw to pole na wartość true (prawda).

Przykłady

Głośnik, który można wyciszyć i który raportuje aktualny stan

{
  "volumeMaxLevel": 11,
  "volumeCanMuteAndUnmute": true,
  "levelStepSize": 2,
  "commandOnlyVolume": false,
  "volumeDefaultPercentage": 6
}

STANOWISKO URZĄDZENIA

Elementy z tą cechą mogą raportować te 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

Wymagany.

Bieżący procent głośności. Wartość musi się mieścić w zakresie >0–volumeMaxLevel.
isMuted Wartość logiczna

Wymagane, jeśli atrybut volumeCanMuteAndUnmute ma wartość Prawda. Wartość „prawda”, jeśli urządzenie jest wyciszone. W przeciwnym razie „fałsz”. Jeśli isMuted ma wartość Prawda, urządzenie nadal zwraca currentVolume dla zapamiętanego punktu.

Przykłady

Głośnik, który można wyciszyć i który raportuje aktualny stan

{
  "currentVolume": 5,
  "isMuted": false
}

Polecenia urządzenia

Urządzenia z tą cechą mogą odpowiadać na te polecenia w ramach operacji EXECUTE. Więcej informacji o obsługiwaniu intencji EXECUTE znajdziesz w artykule Realizacja intencji.

action.devices.commands.mute

wycisza lub włącza dźwięk na urządzeniu.

Parametry

Parametry Typ Opis
mute Wartość logiczna

Wymagany.

wyciszyć lub włączyć mikrofon urządzenia.

Przykłady

Wycisz głośnik

{
  "command": "action.devices.commands.mute",
  "params": {
    "mute": true
  }
}

action.devices.commands.setVolume

Ustaw głośność na żądany poziom, na podstawie: volumeMaxLevel.

Parametry

Parametry Typ Opis
volumeLevel Liczba całkowita

Wymagany.

Nowa objętość, z 0 na 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

Zwiększ lub zmniejsz głośność o n kroków na podstawie volumeMaxLevel. W przypadku poleceń używających skali względnej Asystent wybierze n w sposób odpowiedni do dostępnych kroków. Jeśli na przykład wybierzesz opcję Znacznie głośniej na telewizorze, ustawisz większą liczbę kroków niż Zwiększ głośność telewizora.

Parametry

Parametry Typ Opis
relativeSteps Liczba całkowita

Wymagany.

ujemna w przypadku wartości „decrease” (spadek).

Przykłady

Ustawianie względnej głośności głośnika w trybie tylko z komendami

{
  "command": "action.devices.commands.volumeRelative",
  "params": {
    "relativeSteps": -1
  }
}

BŁĘDY urządzenia

Zobacz pełną listę błędów i wyjątków.
  • volumeAlreadyMax: urządzenie odbiera polecenie VolumeUp, gdy jest już na najwyższej głośności.
  • volumeAlreadyMin: urządzenie odbiera polecenie VolumeDown, gdy ma już ustawioną minimalną głośność.