Schéma de trait Smart Home AppSelector

action.devices.traits.AppSelector : cette caractéristique est utilisée pour les appareils capables de passer d'une application à une autre.

ATTRIBUTS de l'appareil

Les appareils dotés de cette caractéristique peuvent signaler les attributs suivants dans le cadre de l'opération SYNC. Pour en savoir plus sur la gestion des intents SYNC, consultez la section Traitement des intents.

Attributs	Type	Description
availableApplications	Array	Obligatoire. Liste des applications. Chaque application dispose d'un ou de plusieurs synonymes dans chaque langue prise en charge. Le premier synonyme est utilisé dans la réponse.
[item, ...]	Objet	Application avec laquelle les utilisateurs de cet appareil peuvent interagir.
key	String	Obligatoire. Clé unique de l'application qui n'est pas exposée aux utilisateurs dans la parole ou la réponse.
names	Array	Obligatoire. Nom de chaque application et de ses synonymes spécifiques à la langue.
[item, ...]	Objet	Synonymes de l'application.
name_synonym	Array	Obligatoire. Synonyme convivial du nom de l'application pour une langue donnée. Le premier synonyme est utilisé dans la réponse.
[item, ...]	String	Nom de l'application.
lang	String	Obligatoire. Code de langue.

Exemples

Un appareil avec l'application YouTube

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

ÉTATS DE L'APPAREIL

Les entités avec cette caractéristique peuvent signaler les états suivants dans le cadre de l'opération QUERY. Pour en savoir plus sur la gestion des intents QUERY, consultez la section Traitement des intents.

États	Type	Description
currentApplication	String	Obligatoire. Valeur de clé de l'application active au premier plan.

Exemples

Appareil sur lequel l'application YouTube est actuellement active au premier plan.

{
  "currentApplication": "YouTube"
}

COMMANDES DE L'APPAREIL

Les appareils dotés de cette caractéristique peuvent répondre aux commandes suivantes dans le cadre de l'opération EXECUTE. Pour en savoir plus sur la gestion des intents EXECUTE, consultez la section Traitement des intents.

action.devices.commands.appInstall

Installez l'application donnée.

Paramètres

Paramètres	Type	Description
newApplication	String	Clé de l'application à installer.
newApplicationName	String	Nom de l'application à installer.

Exemples

Installer l'application YouTube par clé

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

Installer l'application YouTube par nom

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

action.devices.commands.appSearch

Recherchez l'application donnée.

Paramètres

Paramètres	Type	Description
newApplication	String	Clé de l'application à rechercher.
newApplicationName	String	Nom de l'application à rechercher.

Exemples

Rechercher l'application YouTube par clé

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

Rechercher l'application YouTube par nom

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

action.devices.commands.appSelect

Sélectionnez l'application donnée.

Paramètres

Paramètres	Type	Description
newApplication	String	Clé de l'application à sélectionner.
newApplicationName	String	Nom de l'application à sélectionner.

Exemples

Sélectionner l'application YouTube à l'aide d'une touche

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

Sélectionner l'application YouTube par nom

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

Exemples d'énoncés

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

ERREURS de l'appareil

Consultez la liste complète des erreurs et exceptions.

• noAvailableApp: l'application n'existe pas ou n'est pas disponible.
• appLaunchFailed: l'application n'a pas pu être lancée.
• alreadyInstalledApp: l'application était déjà installée.