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.

Eingabefeld für die Smart-Home-Eingabeauswahl

action.devices.traits.InputSelector: Diese Eigenschaft wird für Geräte verwendet, die Eingaben wechseln können.

Medieneingaben können pro Gerät dynamische Namen haben, die für Audio- oder Videofeeds stehen. Diese Feeds können kabelgebunden oder vernetzt sein, sollten jedoch benannt werden und einen angemessenen Umfang aufweisen. Beliebige sitzungsspezifische Feeds wie eine durchsuchbare Netzwerkbibliothek werden von diesem Merkmal nicht unterstützt. Gekoppelte, benannte Bluetooth-Quellen werden unterstützt. Quellen können mehrere Namen haben. Daher werden vom Nutzer erstellte und erkannte Namen sowie Standardnamen unterstützt. Beispiel: „hdmi_1“ kann auch „DVD-Player“ sein. „usb_1“ kann auch „Festplatte“ sein.

Medieneingaben können so angeordnet werden, dass sie die Befehle „next“ und „next“ unterstützen.

Wie bei Umschalten und Modi sollten die Namen der Eingaben in allen verfügbaren Sprachen angegeben werden. Dies ist besonders für Standardnamen relevant.

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
availableInputs Array

Erforderlich.

Liste der Objekte, die für Audio- oder Videofeeds stehen. Feeds können per Kabel oder mit einem Netzwerk verbunden werden. Jeder Feed sollte benannt werden und einen angemessenen Zeitraum haben. Definieren Sie Synonyme daher sorgfältig, um unerwünschte (Über-)Auslöser zu vermeiden.

[item, ...] Objekt

Verfügbare Eingabe.

key String

Erforderlich.

Eindeutiger Schlüssel für die Eingabe. Der Schlüssel sollte Nutzern nicht in Sprache oder Antwort angezeigt werden.

names Array

Erforderlich.

Liste der Namen für die Eingabe für alle verfügbaren Sprachen.

[item, ...] Objekt

Eingabe für eine bestimmte verfügbare Sprache.

lang String

Erforderlich.

Sprachcode.

name_synonym Array

Erforderlich.

Nutzerfreundliche Namen für die Eingabe in einer bestimmten Sprache. Das erste Synonym wird in der Antwort von Google Assistant an den Nutzer verwendet.

[item, ...] String

Eingabename.

commandOnlyInputSelector Boolesch

(Standard: false)

Gibt an, ob das Gerät die Einweg- (wahr) oder Zwei-Wege-Kommunikation (falsch) unterstützt. Legen Sie dieses Attribut auf „true“ fest, wenn das Gerät für einen dieser Merkmale nicht auf einen QUERY-Intent oder einen Berichtsstatus reagieren kann.

orderedInputs Boolesch

(Standard: false)

Wahr, wenn die Liste der Ausgabe geordnet ist. Das bedeutet auch, dass die Funktionen „Weiter“ und „Zurück“ verfügbar sind.

Beispiele

Gerät mit zwei sortierten Eingaben.

{
  "availableInputs": [
    {
      "key": "hdmi_1",
      "names": [
        {
          "lang": "en",
          "name_synonym": [
            "hdmi 1",
            "1st hdmi",
            "DVD player"
          ]
        },
        {
          "lang": "de",
          "name_synonym": [
            "hdmi 1",
            "zuerst hdmi",
            "DVD Spieler"
          ]
        }
      ]
    },
    {
      "key": "usb_1",
      "names": [
        {
          "lang": "en",
          "name_synonym": [
            "usb 1",
            "first usb",
            "Hard drive"
          ]
        },
        {
          "lang": "de",
          "name_synonym": [
            "usb 1",
            "zuerst usb",
            "Festplatte"
          ]
        }
      ]
    }
  ],
  "orderedInputs": true
}

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
currentInput String

Erforderlich.

Schlüssel der derzeit verwendeten Eingabe.

Beispiele

Gerät mit HDMI-Eingang ausgewählt

{
  "currentInput": "hdmi_1"
}

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.SetInput

Legen Sie die Medieneingabe fest.

Parameter

Parameter Typ Beschreibung
newInput String

Erforderlich.

Schlüssel der neuen Eingabe.

Beispiele

USB-Eingang auswählen

{
  "command": "action.devices.commands.SetInput",
  "params": {
    "newInput": "usb_1"
  }
}

action.devices.commands.NextInput

Wählen Sie die nächste Eingabe aus. Nur verfügbar, wenn das Attribut orderedInputs auf „true“ gesetzt ist.

Für diesen Befehl sind die folgenden Attribute erforderlich:
{
  "orderedInputs": true
}

Parameter

Parameter Typ Beschreibung

Keine Attribute

Beispiele

Keine Parameter

{
  "command": "action.devices.commands.NextInput",
  "params": {}
}

action.devices.commands.PreviousInput

Wählen Sie die vorherige Eingabe aus. Nur verfügbar, wenn das Attribut orderedInputs auf „true“ gesetzt ist.

Für diesen Befehl sind die folgenden Attribute erforderlich:
{
  "orderedInputs": true
}

Parameter

Parameter Typ Beschreibung

Keine Attribute

Beispiele

Keine Parameter

{
  "command": "action.devices.commands.PreviousInput",
  "params": {}
}

Beispieläußerungen

de-DE

  • Ändere den Eingangskanal auf AUX .

en-US

  • change input mode to HDMI 1

es-ES

  • cambia a hdmi 1

fr-FR

  • Activation du mode HDMI1 .
  • Mets la télé sur HDMI 1 .

hi-IN

  • टीवी की इनपुट HDMI 1 में स्विच करो

it-IT

  • metti ingresso aux sulla tv

ja-JP

  • テレビ HDMI1 にして

ko-KR

  • TV HDMI 1 로 바꿔 줘

nl-NL

  • zet de TV op bluetooth

pt-BR

  • Muda a entrada da TV para HDMI2 .
  • mudar a entrada para AUX

sv-SE

  • Sätt på hdmi 1

Gerät ERRORS

Vollständige Liste der Fehler und Ausnahmen

unsupportedInput: Die Eingabe wird derzeit nicht unterstützt.