Schemat cechy poziomu 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. ustawiać głośność na określony poziom, 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ługiwaniu intencji SYNC znajdziesz w artykule Realizacja intencji.

Atrybuty Typ Opis
volumeMaxLevel Liczba całkowita

Wymagany.

Maksymalny poziom głośności, przy założeniu, że wartość bazowa wynosi 0 (wyciszenie). 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 pamiętają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 wartość isMuted będzie miała wartość „true”.
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

(wartość domyślna: false)

Wskazuje, czy urządzenie działa w trybie komunikacji jednokierunkowej (wartość „true”) czy dwukierunkowej (wartość „false”). Jeśli na przykład kontroler może potwierdzić nowy stan urządzenia po wysłaniu żądania, to pole będzie zawierać wartość false (fałsz). Jeśli nie można potwierdzić, czy żądanie zostało wykonane, ani uzyskać stanu urządzenia (na przykład, jeśli urządzenie jest tradycyjnym pilotem na podczerwień), ustaw to pole na wartość 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ługiwaniu intencji QUERY znajdziesz w artykule Realizacja 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.

Wyciszenie lub przywrócenie dźwięku na urządzeniu.

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 taki sposób, aby dopasować go do dostępnych kroków. Na przykład Zwiększ głośność telewizora spowoduje ustawienie większej liczby kroków niż Zwiększ głośność telewizora o trochę.

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