Witamy w Google Home Developer Center – nowym miejscu, gdzie możesz dowiedzieć się, jak tworzyć inteligentne działania domowe. Uwaga: nadal będziesz tworzyć działania w konsoli Actions.

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.