Smart-Home-InputSelector-Trait-Schema

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

Medieneingaben können pro Gerät dynamische Namen haben, die Audio- oder Videofeeds darstellen. Diese Feeds können per Kabel oder mit einem Netzwerk verbunden sein, sollten aber benannt werden und ausreichend persistent sein. Diese Trait unterstützt keine beliebigen sitzungsspezifischen Feeds, z. B. eine durchsuchbare Netzwerkbibliothek. Gekoppelte, benannte Bluetooth-Quellen werden unterstützt. Quellen können mehrere Namen haben. Daher werden von Nutzern erstellte und erkannte Namen sowie Standardnamen unterstützt. Beispielsweise kann „hdmi_1“ auch „DVD-Player“ oder „usb_1“ auch „Festplatte“ sein.

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

Wie bei Toggles und Modes sollten die Namen von Eingaben in allen verfügbaren Sprachen angegeben werden. Dies ist besonders für Standardnamen relevant.

Geräte-ATTRIBUTE

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

Attribute Typ Beschreibung
availableInputs Array

Erforderlich.

Liste der Objekte, die Audio- oder Video-Eingabefeeds darstellen. Feeds können per Kabel oder mit einem Netzwerk verbunden sein. Jeder Feed sollte einen Namen haben und angemessen dauerhaft sein. Achten Sie darauf, Ihre Synonyme sorgfältig zu definieren, um unerwünschte (Über-)Triggerungen zu vermeiden.

[item, ...] Objekt

Verfügbare Eingabe.

key String

Erforderlich.

Eindeutiger Schlüssel für die Eingabe. Der Schlüssel sollte Nutzern nicht gesprochen oder als 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 unidirektionale (wahr) oder die bidirektionale (falsche) Kommunikation unterstützt. Setze dieses Attribut auf „true“, wenn das Gerät für diese Eigenschaft nicht auf einen QUERY-Intent oder Berichtsstatus reagieren kann.

orderedInputs Boolesch

(Standard: false)

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

Beispiele

Gerät mit zwei geordneten 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

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

Bundesstaaten Typ Beschreibung
currentInput String

Erforderlich.

Schlüssel der aktuell verwendeten Eingabe.

Beispiele

Aktuell ist das Gerät mit HDMI-Eingang ausgewählt.

{
  "currentInput": "hdmi_1"
}

BEFEHLUNGEN auf dem Gerät

Geräte mit dieser Eigenschaft können im Rahmen des EXECUTE-Vorgangs auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Intent-Auftragsausführung.

action.devices.commands.SetInput

Medieneingabe festlegen

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

Nächsten Eingang auswählen. Nur anwendbar, 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 anwendbar, 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

Sehen Sie sich die vollständige Liste der Fehler und Ausnahmen an.

unsupportedInput: Die Eingabe wird derzeit nicht unterstützt.