Schema des AppSelector-Traits für Smart Home

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

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
availableApplications	Array	Erforderlich. Eine Liste mit Anwendungen. Jede Anwendung verfügt über ein oder mehrere Synonyme in jeder unterstützten Sprache. 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 nicht bei Sprache oder Antwort angezeigt wird.
names	Array	Erforderlich. Die Namen der einzelnen Anwendungen und die zugehörigen sprachspezifischen Synonyme.
[item, ...]	Objekt	Synonyme.
name_synonym	Array	Erforderlich. Benutzerfreundliche Synonyme für den Anwendungsnamen in einer bestimmten Sprache. Das erste Synonym wird in der Antwort verwendet.
[item, ...]	String	Name der Anwendung.
lang	String	Erforderlich. Sprachcode.

Beispiele

Gerät mit YouTube App

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

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
currentApplication	String	Erforderlich. Schlüsselwert der aktuellen Anwendung, die im Vordergrund aktiv ist.

Beispiele

Auf dem Gerät ist die YouTube App momentan im Vordergrund aktiv.

{
  "currentApplication": "YouTube"
}

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

Installiert die angegebene Anwendung.

Parameter

Parameter	Typ	Beschreibung
newApplication	String	Schlüssel der zu installierenden Anwendung.
newApplicationName	String	Name der zu installierenden Anwendung.

Beispiele

YouTube App über den Schlüssel installieren

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

YouTube App über den Namen installieren

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

action.devices.commands.appSearch

Suchen Sie nach der angegebenen Anwendung.

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

Suche anhand des Schlüssels nach der YouTube App

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

Suche nach dem Namen der YouTube App

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

action.devices.commands.appSelect

Wählen Sie die betreffende Anwendung aus.

Parameter

Parameter	Typ	Beschreibung
newApplication	String	Schlüssel der Anwendung, die ausgewählt werden soll.
newApplicationName	String	Name der Anwendung, die ausgewählt werden soll.

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ät ERRORS

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

• noAvailableApp: Die App existiert nicht oder ist nicht verfügbar.
• appLaunchFailed: Die Anwendung konnte nicht gestartet werden.
• alreadyInstalledApp: Die Anwendung wurde bereits installiert.