Willkommen beim Google Home Developer Center, der neuen Anlaufstelle für Smart-Home-Aktionen. Hinweis:Sie erstellen weiterhin Aktionen in der Actions Console.
Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

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.