Smart-Home-Lautstärkeattribut-Schema
action.devices.traits.Volume
– Diese Eigenschaft gehört zu Geräten, die die Lautstärke ändern können, z. B. die Lautstärke auf eine bestimmte Stufe stellen, stummschalten oder die Stummschaltung aufheben.
Geräteattribute
Geräte mit diesem Merkmal können die folgenden Attribute im Rahmen des Vorgangs SYNC
melden. Weitere Informationen zum Umgang mit SYNC
-Intents finden Sie unter Intent-Ausführung.
Attribute | Typ | Beschreibung |
---|---|---|
volumeMaxLevel |
Ganzzahl |
Erforderlich. Die maximale Lautstärkestufe, vorausgesetzt, die Grundeinstellung ist 0 (Stummschaltung). Assistant passt adverbiale Befehle (z. B. „Mach den Fernseher etwas lauter“) entsprechend an. |
volumeCanMuteAndUnmute |
Boolesch |
Erforderlich. Gibt an, ob die Lautstärke des Geräts stummgeschaltet und die Stummschaltung aufgehoben werden kann. Die Stummschaltung ist eine separate Option, da die Lautstärke bei der Stummschaltung auf 0 gesetzt wird, während die vorherige Lautstärke gespeichert wird. Wenn Sie die Stummschaltung aufheben, wird die vorherige Lautstärke wiederhergestellt. Das wird im Lautstärkestatus berücksichtigt: Wenn die Lautstärke auf 5 steht und der Nutzer die Lautstärke stummschaltet, bleibt die Lautstärke bei 5 und |
volumeDefaultPercentage |
Ganzzahl |
(Standardeinstellung: Die Lautstärke (in Prozent) für die vom Nutzer oder Hersteller festgelegte Standardlautstärke. Die Skala muss zwischen 0 und 100 liegen. |
levelStepSize |
Ganzzahl |
(Standardeinstellung: Die Standardschrittgröße für Abfragen mit relativem Volumen wie „Lautstärke auf <device_name> erhöhen“. |
commandOnlyVolume |
Boolesch |
(Standardeinstellung: Gibt an, ob das Gerät eine Einweg- (wahr) oder Zwei-Wege-Kommunikation (falsch) verwendet. Wenn der Controller beispielsweise den neuen Gerätestatus nach dem Senden der Anfrage bestätigen kann, ist dieses Feld auf „false“ (falsch) gesetzt. Wenn nicht bestätigt werden kann, ob die Anfrage erfolgreich ausgeführt wurde, oder den Gerätestatus abzurufen (z. B. ob es sich bei dem Gerät um eine herkömmliche Infrarotfernbedienung handelt), setzen Sie dieses Feld auf "true". |
Beispiele
Lautsprecher, der stummgeschaltet werden kann und den aktuellen Status meldet
{ "volumeMaxLevel": 11, "volumeCanMuteAndUnmute": true, "levelStepSize": 2, "commandOnlyVolume": false, "volumeDefaultPercentage": 6 }
GERÄTESTATUS
Entitäten mit diesem Merkmal können im Rahmen der QUERY
-Operation die folgenden Bundesstaaten melden. Weitere Informationen zum Umgang mit QUERY
-Intents finden Sie unter Intent-Auftragsausführung.
Bundesstaaten | Typ | Beschreibung |
---|---|---|
currentVolume |
Ganzzahl |
Erforderlich. Der aktuelle Prozentsatz der Lautstärke. Er muss zwischen |
isMuted |
Boolesch |
Erforderlich, wenn das |
Beispiele
Lautsprecher, der stummgeschaltet werden kann und den aktuellen Status meldet
{ "currentVolume": 5, "isMuted": false }
BEFEHLE für Geräte
Geräte mit dieser Eigenschaft können im Rahmen des Vorgangs EXECUTE
auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE
-Intents finden Sie unter Intent-Ausführung.
action.devices.commands.mute
Schaltet das Gerät stumm bzw. hebt die Stummschaltung auf.
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
mute |
Boolesch |
Erforderlich. Gibt an, ob ein Gerät stummgeschaltet werden soll oder nicht. |
Beispiele
Lautsprecher stummschalten
{ "command": "action.devices.commands.mute", "params": { "mute": true } }
action.devices.commands.setVolume
Die Lautstärke wird auf die angeforderte Stufe festgelegt, basierend auf volumeMaxLevel
.
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
volumeLevel |
Ganzzahl |
Erforderlich. Neues Volume von |
Beispiele
Absolute Lautstärke des Lautsprechers einstellen
{ "command": "action.devices.commands.setVolume", "params": { "volumeLevel": 6 } }
action.devices.commands.volumeRelative
Lautstärke um n Stufen erhöhen oder verringern, basierend auf volumeMaxLevel
. Bei Befehlen mit einer relativen Skalierung wählt Assistant n entsprechend aus, um die verfügbaren Schritte zu skalieren. Für Fernseher viel lauter machen wird beispielsweise eine höhere Anzahl von Schritten festgelegt als für Fernseher ein bisschen lauter machen.
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
relativeSteps |
Ganzzahl |
Erforderlich. „negativ“ für „Rückgang“. |
Beispiele
Relative Lautstärke des Lautsprechers im reinen Befehlsmodus festlegen
{ "command": "action.devices.commands.volumeRelative", "params": { "relativeSteps": -1 } }
Gerätefehler
Vollständige Liste der Fehler und AusnahmenvolumeAlreadyMax
: Das Gerät empfängt den BefehlVolumeUp
, wenn es bereits die höchste Lautstärke hat.volumeAlreadyMin
: Das Gerät empfängt den BefehlVolumeDown
, wenn die niedrigste Lautstärke bereits eingestellt ist.