Smart Home AppSelector Trait Schema

action.devices.traits.AppSelector : Dieses Trait wird für Geräte verwendet, die zwischen Anwendungen wechseln können.

Geräteattribute

Geräte mit diesem Trait können die folgenden Attribute im Rahmen des SYNC Vorgangs melden. Weitere Informationen zur Verarbeitung von SYNC Intents finden Sie unter Intent-Erfüllung.

Attribute Typ Beschreibung
availableApplications Array

Erforderlich.

Eine Liste von Anwendungen. Jede Anwendung hat in jeder unterstützten Sprache ein oder mehrere Synonyme. Das erste Synonym wird in der Antwort verwendet.
[item, ...] Objekt

Anwendung, mit der Nutzer dieses Geräts interagieren können.
key String

Erforderlich.

Eindeutiger Schlüssel für die Anwendung, der Nutzern in der Sprachausgabe oder Antwort nicht angezeigt wird.
names Array

Erforderlich.

Name jeder Anwendung und ihre sprachspezifischen Synonyme.
[item, ...] Objekt

Anwendungssynonyme.
name_synonym Array

Erforderlich.

Nutzerfreundliche Synonyme für den Anwendungsnamen für eine bestimmte Sprache. Das erste Synonym wird in der Antwort verwendet.
[item, ...] String

Anwendungsname.
lang String

Erforderlich.

Sprachcode.

Beispiele

Gerät mit der YouTube App

{
  "availableApplications": [
    {
      "key": "youtube",
      "names": [
        {
          "name_synonym": [
            "YouTube",
            "YouTube US"
          ],
          "lang": "en"
        },
        {
          "name_synonym": [
            "YouTube",
            "YouTube DE"
          ],
          "lang": "de"
        }
      ]
    }
  ]
}

Gerätestatus

Entitäten mit diesem Trait können die folgenden Status im Rahmen des QUERY Vorgangs melden. Weitere Informationen zur Verarbeitung von QUERY Intents finden Sie unter Intent-Erfüllung.

Bundesstaaten Typ Beschreibung
currentApplication String

Erforderlich.

Schlüsselwert der aktuellen Anwendung, die im Vordergrund aktiv ist.

Beispiele

Gerät mit der YouTube App, die derzeit im Vordergrund aktiv ist

{
  "currentApplication": "YouTube"
}

Gerätebefehle

Geräte mit diesem Trait können im Rahmen des EXECUTE Vorgangs auf die folgenden Befehle reagieren. Weitere Informationen zur Verarbeitung von EXECUTE Intents finden Sie unter Intent-Erfüllung.

action.devices.commands.appInstall

Die angegebene Anwendung installieren.

Parameter

Parameter Typ Beschreibung
newApplication String

Schlüssel der zu installierenden Anwendung.
newApplicationName String

Name der zu installierenden Anwendung.

Beispiele

YouTube App nach Schlüssel installieren

{
  "command": "action.devices.commands.appInstall",
  "params": {
    "newApplication": "YouTube"
  }
}

YouTube App nach Name installieren

{
  "command": "action.devices.commands.appInstall",
  "params": {
    "newApplicationName": "YouTube US"
  }
}

action.devices.commands.appSearch

Nach der angegebenen Anwendung suchen.

Parameter

Parameter Typ Beschreibung
newApplication String

Schlüssel der Anwendung, nach der gesucht werden soll.
newApplicationName String

Name der Anwendung, nach der gesucht werden soll.

Beispiele

Nach der YouTube App nach Schlüssel suchen

{
  "command": "action.devices.commands.appSearch",
  "params": {
    "newApplication": "YouTube"
  }
}

Nach der YouTube App nach Name suchen

{
  "command": "action.devices.commands.appSearch",
  "params": {
    "newApplicationName": "YouTube US"
  }
}

action.devices.commands.appSelect

Die angegebene Anwendung auswählen.

Parameter

Parameter Typ Beschreibung
newApplication String

Schlüssel der auszuwählenden Anwendung.
newApplicationName String

Name der auszuwählenden Anwendung.

Beispiele

YouTube App nach Schlüssel auswählen

{
  "command": "action.devices.commands.appSelect",
  "params": {
    "newApplication": "YouTube"
  }
}

YouTube App nach Name auswählen

{
  "command": "action.devices.commands.appSelect",
  "params": {
    "newApplicationName": "YouTube US"
  }
}

Beispieläußerungen

de-DE

  • Öffne Netflix auf dem Fernseher .

en-US

  • begin using YouTube app on the smart TV

es-ES

  • pon netflix en la tele del salón

fr-FR

  • Mets Netflix sur la télé .

hi-IN

  • टीवी पर नेटफ्लिक्स ऍप लॉन्च करो

it-IT

  • Apri Netflix sulla televisione della mia camera .

ja-JP

  • YouTube のアプリを テレビ でスタート

ko-KR

  • TV 에서 유튜브 앱 열어 줘

nl-NL

  • Start Netflix op mijn TV .

pt-BR

  • Abra o Netflix na TV para mim.
  • Abre o Youtube na televisão .

sv-SE

  • Öppna Youtube på TV:n

Gerätefehler

Eine vollständige Liste der Fehler und Ausnahmenfinden Sie hier.
  • noAvailableApp: Die Anwendung ist nicht vorhanden oder nicht verfügbar.
  • appLaunchFailed: Die Anwendung konnte nicht gestartet werden.
  • alreadyInstalledApp: Die Anwendung war bereits installiert.