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 isMuted ist wahr.
volumeDefaultPercentage	Ganzzahl	(Standard: 40) 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: 1) Die Standardschrittgröße für Abfragen mit relativen Volumen wie „Lautstärke auf <Gerätename> erhöhen“.
commandOnlyVolume	Boolesch	(Standard: false) 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 >0 und volumeMaxLevel liegen.
isMuted	Boolesch	Erforderlich, wenn das Attribut volumeCanMuteAndUnmute auf „true“ gesetzt ist. „True“, wenn das Gerät stummgeschaltet ist, andernfalls „False“. Wenn isMuted „true“ ist, gibt das Gerät weiterhin currentVolume für den gespeicherten Punkt zurück.

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

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 Ausnahmen

• volumeAlreadyMax: Das Gerät erhält den Befehl VolumeUp, wenn es bereits auf die höchste Lautstärke eingestellt ist.
• volumeAlreadyMin: Das Gerät empfängt den Befehl VolumeDown, wenn es bereits die niedrigste Lautstärke hat.