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 isMuted ist „wahr“.

volumeDefaultPercentage Ganzzahl

(Standardeinstellung: 40)

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: 1)

Die Standardschrittgröße für Abfragen mit relativem Volumen wie „Lautstärke auf <device_name> erhöhen“.

commandOnlyVolume Boolesch

(Standardeinstellung: false)

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 >0 und volumeMaxLevel liegen.

isMuted Boolesch

Erforderlich, wenn das volumeCanMuteAndUnmute-Attribut auf „wahr“ festgelegt ist. "True", wenn das Gerät stummgeschaltet ist, andernfalls "False". Wenn isMuted „true“ ist, gibt das Gerät trotzdem currentVolume für den gemerkten Punkt zurück.

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 0 bis volumeMaxLevel.

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 Ausnahmen
  • volumeAlreadyMax: Das Gerät empfängt den Befehl VolumeUp, wenn es bereits die höchste Lautstärke hat.
  • volumeAlreadyMin: Das Gerät empfängt den Befehl VolumeDown, wenn die niedrigste Lautstärke bereits eingestellt ist.