Schemat cech głośności inteligentnego domu

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, wyciszyć lub wyłączyć wyciszenie).

Urządzenia – ATTRIBUTES

Urządzenia z tą cechą mogą zgłaszać te problemy jako część operacji SYNC. Aby się uczyć więcej informacji o obsłudze intencji SYNC znajdziesz tutaj 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 odpowiednio dostosuje polecenia przysłone (np. „Ustaw telewizor trochę głośniej”).
volumeCanMuteAndUnmute	Wartość logiczna	Wymagane. Wskazuje, czy urządzenie może wyciszyć lub wyłączyć wyciszenie dźwięku. Wyciszenie to odrębna opcja jako „wycisz” powoduje przywrócenie głośności do 0 z zapamiętaniem poprzedniej wartości, więc wyłączenie wyciszenia powoduje jej przywrócenie. 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	(Domyślnie: 40) Głośność (w procentach) domyślnej głośności określonej przez użytkownika lub producenta. Skala musi wynosić od 0 do 100.
levelStepSize	Liczba całkowita	(Domyślnie: 1) Domyślny rozmiar kroku w przypadku 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 przy użyciu 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 ma wartość false (fałsz). 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 przekazuje bieżący stan

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

Urządzenie STATES

Jednostki o tej cechie mogą zgłaszać: stanów w ramach operacji QUERY. Aby się uczyć więcej informacji o obsłudze intencji QUERY znajdziesz tutaj Realizacja intencji.

Stany	Typ	Opis
currentVolume	Liczba całkowita	Wymagane. Bieżący procent głośności. Wartość musi mieścić się w zakresie od >0 do volumeMaxLevel.
isMuted	Wartość logiczna	Wymagane, jeśli atrybut volumeCanMuteAndUnmute ma wartość Prawda. Prawda, jeśli urządzenie jest wyciszone. w przeciwnym razie ma wartość false. Jeśli isMuted ma wartość prawda, urządzenie nadal zwraca wartość currentVolume dla zapamiętanego punktu.

Przykłady

Głośnik z możliwością wyciszenia i przekazywaniem informacji o bieżącym stanie

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

Polecenia na urządzeniu

Urządzenia z tą cechą mogą reagować na: w ramach operacji EXECUTE. Aby się uczyć więcej informacji o obsłudze intencji EXECUTE znajdziesz tutaj Realizacja intencji.

action.devices.commands.mute

Wycisza lub włącza wyciszenie urządzenia.

Parametry

Parametry	Typ	Opis
mute	Wartość logiczna	Wymagane. Określa, czy wyciszyć urządzenie, czy wyłączyć jego wyciszenie.

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	Wymagane. Nowy tom, od 0 do volumeMaxLevel.

Przykłady

Ustaw głośność bezwzględną głośnika

{
  "command": "action.devices.commands.setVolume",
  "params": {
    "volumeLevel": 6
  }
}

action.devices.commands.volumeRelative

Ustaw kroki zwiększania lub zmniejszania głośności o n stopniowo (volumeMaxLevel). W przypadku poleceń korzystających ze skali względnej Asystent wybierze n odpowiednio, by dostosować skalę 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	Wymagane. ujemne dla słowa „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 jest już działa z największą głośnością.
• volumeAlreadyMin: urządzenie odbiera polecenie VolumeDown, gdy jest i teraz z najniższym poziomem głośności.