Schemat inteligentnego działania domu

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

ATRYBUTY 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	Wymagany. Maksymalny poziom głośności przy założeniu, że wartość bazowa to 0 (wyciszenie). Asystent będzie odpowiednio dostosowywać polecenia wypowiadane przez użytkownika (np. „zwiększ głośność telewizora”).
volumeCanMuteAndUnmute	Wartość logiczna	Wymagany. Wskazuje, czy urządzenie może wyciszać i wyłączać wyciszenie. Wyciszenie to oddzielna opcja, ponieważ działanie „wyciszenia” powoduje wyrównanie głośności do 0, zapamiętując poprzednie, dzięki czemu wyciszenie zostaje przywrócone. 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 on ustawiony na 5, a wartość isMuted będzie ustawiona na wartość prawda.
volumeDefaultPercentage	Liczba całkowita	(domyślnie: 40) Głośność (w procentach) domyślnej liczby zdefiniowanej 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 z wykorzystaniem komunikacji jednokierunkowej (prawda) czy dwukierunkowej (fałsz). Jeśli na przykład po wysłaniu żądania kontroler może potwierdzić nowy stan urządzenia, to pole ma wartość Fałsz. Jeśli nie można potwierdzić, że żądanie zostało wykonane lub pozwala uzyskać stan urządzenia (na przykład jest to tradycyjne pilot na podczerwień), ustaw to pole na wartość true.

Przykłady

Urządzenie z głośnikiem, 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 urządzenia z tą cechą mogą zawierać podane niżej stany. Więcej informacji o obsłudze intencji QUERY znajdziesz w sekcji Realizacja intencji.

Stany	Typ	Opis
currentVolume	Liczba całkowita	Wymagany. Bieżący procent głośności. Musi mieścić się w przedziale od >0 do volumeMaxLevel.
isMuted	Wartość logiczna	Wymagane, jeśli atrybut volumeCanMuteAndUnmute ma wartość Prawda. Wartość to „prawda”, jeśli urządzenie jest wyciszone. W przeciwnym razie „fałsz”. Jeśli zasada isMuted ma wartość Prawda, urządzenie zwraca currentVolume dla pamiętanego punktu.

Przykłady

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

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

Polecenie urządzenia

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

action.devices.commands.mute

Wycisza lub wycisza urządzenie.

Parametry

Parametry	Typ	Opis
mute	Wartość logiczna	Wymagany. Wyciszanie urządzenia i włączanie jego wyciszenia.

Przykłady

Wycisz głośnik

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

action.devices.commands.setVolume

Ustaw głośność na żądanym poziomie na podstawie volumeMaxLevel.

Parametry

Parametry	Typ	Opis
volumeLevel	Liczba całkowita	Wymagany. 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ść w górę lub w dół n – zależnie od volumeMaxLevel. W przypadku poleceń, które używają wagi względnej, Asystent wybierze odpowiednią opcję n, aby przeprowadzić skalowanie do dostępnych kroków. Na przykład ustawienie Zwiększ głośność telewizora ustawi większą liczbę kroków niż Ustaw telewizor na trochę głośniejszy.

Parametry

Parametry	Typ	Opis
relativeSteps	Liczba całkowita	Wymagany. w przypadku wartości „zmniejsz”

Przykłady

Ustawianie względnej głośności głośnika w trybie 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 jest już ustawione na minimalną głośność.