Schéma de trait d'AppSelector pour la maison connectée

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

Attributs d'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 d'applications. Chaque application possède un ou 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 présentée aux utilisateurs par la voix ni la réponse.

names Array

Obligatoire.

Nom de chaque application et de ses synonymes propres à chaque langage.

[item, ...] Objet

Synonymes d'application

name_synonym Array

Obligatoire.

Synonymes conviviaux pour le nom d'application dans 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

Appareil avec l'application YouTube

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

Device STATES

Les entités dotées de 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 la clé de l'application active au premier plan.

Exemples

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

{
  "currentApplication": "YouTube"
}

COMMANDS d'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

Installer 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 à l'aide de la clé

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

Installer l'application YouTube en saisissant son nom

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

action.devices.commands.appSearch

Recherche 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 une application YouTube par clé

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

Rechercher une application YouTube par son 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 par clé

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

Sélectionner l'application YouTube par son 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 TV:n

ERREURS sur l'appareil

Consultez la liste complète des erreurs et exceptions.
  • noAvailableApp: l'application n'existe pas ou n'est pas disponible.
  • appLaunchFailed: échec du lancement de l'application.
  • alreadyInstalledApp: l'application a déjà été installée.