Schemat działań inteligentnych woluminów domowych

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

ATTRIBUTES urządzenia

W ramach operacji SYNC urządzenia z tą cechą mogą zgłaszać wymienione poniżej atrybuty. Więcej informacji o obsłudze intencji SYNC znajdziesz w sekcji 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 będzie odpowiednio dostosowywać polecenia głosowe (np. „zwiększ głośność telewizora”).
volumeCanMuteAndUnmute	Wartość logiczna	Wymagane. Wskazuje, czy urządzenie może wyciszyć i wyłączyć wyciszenie. Wyciszenie to osobna opcja, ponieważ funkcja wyciszania ustawia głośność na 0, zapamiętując poprzedni, co pozwala przywrócić wyciszenie. Znajduje to odzwierciedlenie w stanie głośności – jeśli głośność jest ustawiona na 5, a użytkownik wyciszy dźwięk, zostanie zachowany na poziomie 5, a wartość isMuted pozostanie prawda.
volumeDefaultPercentage	Liczba całkowita	(Domyślnie: 40) Głośność (w procentach) w wartości domyślnej określonej przez użytkownika lub producenta. Skala musi mieścić się w zakresie 0–100.
levelStepSize	Liczba całkowita	(Domyślnie: 1) Domyślny rozmiar kroku dla zapytań o 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 jednokierunkowej (prawda) czy dwukierunkowej (fałszywej) komunikacji. Jeśli na przykład po wysłaniu żądania kontroler może potwierdzić nowy stan urządzenia, to pole ma wartość false (fałsz). Jeśli nie można sprawdzić, czy żądanie zostało wykonane, czy też chcesz sprawdzić stan urządzenia (na przykład jest to tradycyjne pilot na podczerwień), ustaw to pole na wartość prawda.

Przykłady

Urządzenie głośnika, które można wyciszyć i raportuje bieżący stan

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

Urządzenie STATES

W ramach operacji QUERY encje z tą cechą mogą zgłaszać wymienione poniżej stany. Więcej informacji o obsłudze intencji QUERY znajdziesz w sekcji Realizacja intencji.

Stany	Typ	Opis
currentVolume	Liczba całkowita	Wymagane. Bieżący odsetek. 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ść Fałsz. Jeśli isMuted ma wartość Prawda, urządzenie zwraca currentVolume w przypadku pamiętanego punktu.

Przykłady

Urządzenie głośnika, które można wyciszyć i raportuje bieżący stan

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

Urządzenie CommandS

W ramach operacji EXECUTE urządzenia z tą cechą mogą reagować na podane niżej polecenia. Więcej informacji o obsłudze intencji EXECUTE znajdziesz w sekcji Realizacja intencji.

action.devices.commands.mute

Wycisza lub wyłącza wyciszenie.

Parametry

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

Przykłady

Wycisz głośnik

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

action.devices.commands.setVolume

Ustaw poziom głośności na podstawie volumeMaxLevel.

Parametry

Parametry	Typ	Opis
volumeLevel	Liczba całkowita	Wymagane. Nowy wolumin, od 0 do volumeMaxLevel.

Przykłady

Ustawianie bezwzględnej głośności głośnika

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

action.devices.commands.volumeRelative

Ustaw głośność zwiększania lub zmniejszania n na podstawie volumeMaxLevel. W przypadku poleceń, które używają wagi względnej, Asystent wybierze odpowiednią liczbę n, aby przeskalować ją do dostępnych kroków. Na przykład ustawienie Zwiększ głośność telewizora spowoduje ustawienie większej liczby kroków niż Ustaw telewizor na trochę głośniejszy dźwięk.

Parametry

Parametry	Typ	Opis
relativeSteps	Liczba całkowita	Wymagane. ujemne dla słowa „zmniejszenie”.

Przykłady

Ustawianie względnej głośności głośnika w trybie wiersza poleceń

{
  "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 otrzymuje polecenie VolumeUp, gdy głośność jest już najwyższa.
• volumeAlreadyMin: urządzenie otrzymuje polecenie VolumeDown, gdy jego głośność jest już ustawiona na minimalny poziom.