Smart-Home-Attributschema für InputSelector

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

Medieneingaben können pro Gerät dynamische Namen haben, die Audio- oder Videofeeds darstellen. Diese Feeds können verkabelt oder vernetzt sein, sollten aber benannt und relativ dauerhaft sein. Diese Eigenschaft unterstützt keine beliebigen sitzungsspezifischen Feeds, z. B. eine suchbare Netzwerkbibliothek. Gekoppelte, benannte Bluetooth-Quellen werden unterstützt. Quellen können mehrere Namen haben. Es werden sowohl von Nutzern erstellte und erkannte Namen als auch Standardnamen unterstützt. „hdmi_1“ kann beispielsweise auch „DVD-Player“ oder „usb_1“ auch „Festplatte“ sein.

Medieneingänge können so angeordnet werden, dass die Befehle „Weiter“ und „Zurück“ unterstützt werden.

Wie bei Toggles und Modes sollten die Namen der Eingaben in allen verfügbaren Sprachen angegeben werden. Das ist besonders wichtig für Standardnamen.

Geräteattribute

Geräte mit dieser Eigenschaft können im Rahmen des Vorgangs SYNC die folgenden Attribute melden. Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Intent-Ausführung.

Attribute Typ Beschreibung
availableInputs Array

Erforderlich.

Liste der Objekte, die Eingabe-Audio- oder -Videofeeds darstellen. Feeds können per Kabel oder über ein Netzwerk angeschlossen werden. Jeder Feed sollte einen Namen haben und möglichst dauerhaft sein. Definieren Sie Ihre Synonyme sorgfältig, um unerwünschte (Über-)Auslösungen zu vermeiden.
[item, ...] Objekt

Verfügbare Eingabe
key String

Erforderlich.

Eindeutiger Schlüssel für die Eingabe. Der Schlüssel darf nicht in der Sprache oder Antwort für Nutzer sichtbar sein.
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

Geben Sie einen Namen ein.
commandOnlyInputSelector Boolesch

(Standardeinstellung: false)

Gibt an, ob das Gerät die unidirektionale (wahr) oder bidirektionale (falsch) Kommunikation unterstützt. Legen Sie dieses Attribut auf „true“ fest, wenn das Gerät nicht auf eine QUERY-Intention oder den Berichtsstatus für dieses Attribut antworten kann.
orderedInputs Boolesch

(Standardeinstellung: false)

„Wahr“, wenn die Ausgabeliste sortiert ist. Außerdem wird angezeigt, dass die Funktionen „Nächster“ und „Vorheriger“ 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ÄTESTATUS

Entitäten mit diesem Attribut können im Rahmen des Vorgangs QUERY die folgenden Status melden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Ausführung.

Bundesstaaten Typ Beschreibung
currentInput String

Erforderlich.

Der Schlüssel der aktuell verwendeten Eingabe.

Beispiele

Das Gerät mit dem aktuell ausgewählten HDMI-Eingang.

{
  "currentInput": "hdmi_1"
}

Gerätebefehle

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.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. Gilt nur, wenn das Attribut orderedInputs auf „wahr“ 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. Gilt nur, wenn das Attribut orderedInputs auf „wahr“ 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ÄTEFEHLER

Eine vollständige Liste der Fehler und Ausnahmen

unsupportedInput: Die Eingabe wird derzeit nicht unterstützt.