Schema der Smart-Home-Lautstärke
action.devices.traits.Volume
: Diese Eigenschaft gehört zu Geräten, die die Lautstärke ändern können (z. B. Lautstärke auf eine bestimmte Stufe einstellen, stummschalten oder Stummschaltung aufheben).
Gerät ATTRIBUTE
Geräte mit diesem Attribut können im Rahmen des Vorgangs SYNC
die folgenden Attribute melden. Weitere Informationen zum Umgang mit SYNC
-Intents finden Sie unter Intent-Auftragsausführung.
Attribute | Typ | Beschreibung |
---|---|---|
volumeMaxLevel |
Ganzzahl |
Erforderlich. Die maximale Lautstärke, wobei von Baseline 0 ausgegangen wird. Assistant passt die adverbialen Befehle an (z.B. „Mach den Fernseher etwas lauter“). |
volumeCanMuteAndUnmute |
Boolesch |
Erforderlich. Gibt an, ob das Gerät die Lautstärke stumm- und lautschaltet. „Stummschalten“ ist eine separate Option, da die Option „Stummschalten“ die Lautstärke auf 0 setzt und sich die vorherige Lautstärke merken lässt. Dies wird im Lautstärkestatus widergespiegelt. Wenn die Lautstärke bei 5 liegt und der Nutzer stummschaltet, bleibt die Lautstärke 5 und |
volumeDefaultPercentage |
Ganzzahl |
(Standard: Die Lautstärke (in Prozent) für das Standardvolumen, das vom Nutzer oder Hersteller definiert wurde. Die Skala muss zwischen 0 und 100 liegen. |
levelStepSize |
Ganzzahl |
(Standard: Die Standardschrittgröße für Abfragen mit relativen Volumen wie „Lautstärke auf <Gerätename> erhöhen“. |
commandOnlyVolume |
Boolesch |
(Standard: Gibt an, ob das Gerät über eine Einweg- (true) oder Zwei-Wege- (False) Kommunikation betrieben wird. Wenn der Controller beispielsweise den neuen Gerätestatus nach dem Senden der Anfrage bestätigen kann, ist dieses Feld „false“. Wenn nicht bestätigt werden kann, ob die Anfrage erfolgreich ausgeführt wurde oder den Status des Geräts abrufen kann (z. B. eine herkömmliche Infrarot-Fernbedienung), legen Sie dieses Feld auf „true“ fest. |
Beispiele
Lautsprecher, der stummgeschaltet werden kann und den aktuellen Status meldet
{ "volumeMaxLevel": 11, "volumeCanMuteAndUnmute": true, "levelStepSize": 2, "commandOnlyVolume": false, "volumeDefaultPercentage": 6 }
Gerät STATES
Geräte mit diesem Attribut können im Rahmen des Vorgangs QUERY
die folgenden Zustände melden. Weitere Informationen zum Umgang mit QUERY
-Intents finden Sie unter Intent-Auftragsausführung.
Bundesstaaten | Typ | Beschreibung |
---|---|---|
currentVolume |
Ganzzahl |
Erforderlich. Der aktuelle Volumenprozentsatz. Er muss zwischen |
isMuted |
Boolesch |
Erforderlich, wenn das Attribut |
Beispiele
Lautsprecher, der stummgeschaltet werden kann und den aktuellen Status meldet
{ "currentVolume": 5, "isMuted": false }
Gerätebefehle
Geräte mit diesem Attribut können im Rahmen des Vorgangs EXECUTE
auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE
-Intents finden Sie unter Intent-Auftragsausführung.
action.devices.commands.mute
Schaltet das Gerät stumm.
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
mute |
Boolesch |
Erforderlich. Gibt an, ob ein Gerät stummgeschaltet oder die Stummschaltung aufgehoben werden soll. |
Beispiele
Lautsprecher stummschalten
{ "command": "action.devices.commands.mute", "params": { "mute": true } }
action.devices.commands.setVolume
Die Lautstärke wird auf der Grundlage der volumeMaxLevel
festgelegt.
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
volumeLevel |
Ganzzahl |
Erforderlich. Neuer Band, von |
Beispiele
Absolute Lautstärke des Lautsprechers festlegen
{ "command": "action.devices.commands.setVolume", "params": { "volumeLevel": 6 } }
action.devices.commands.volumeRelative
Die Lautstärke kann je nach volumeMaxLevel
in n Schritten erhöht oder verringert werden. Bei Befehlen, die eine relative Skalierung verwenden, wählt Assistant n entsprechend aus, um eine Skalierung auf die verfügbaren Schritte vorzunehmen. Beispielsweise können Sie mit Stell den Fernseher lauter eine höhere Anzahl von Schritten ein als mit Mach den Fernseher etwas lauter.
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
relativeSteps |
Ganzzahl |
Erforderlich. negativ für „decrease“. |
Beispiele
Relative Lautstärke des Lautsprechers im Nur-Befehl-Modus festlegen
{ "command": "action.devices.commands.volumeRelative", "params": { "relativeSteps": -1 } }
Gerät ERRORS
Vollständige Liste der Fehler und AusnahmenvolumeAlreadyMax
: Das Gerät erhält den BefehlVolumeUp
, wenn es bereits auf die höchste Lautstärke eingestellt ist.volumeAlreadyMin
: Das Gerät empfängt den BefehlVolumeDown
, wenn es bereits die niedrigste Lautstärke hat.