Schéma de trait InputSelector pour la maison connectée

action.devices.traits.InputSelector : cette caractéristique est utilisée pour les appareils capables de changer d'entrée.

Les entrées multimédias peuvent avoir des noms dynamiques par appareil qui représentent des flux audio ou vidéo. Ces flux peuvent être câblés ou en réseau, mais ils doivent être nommés et raisonnablement persistants. Cette caractéristique n'est pas compatible avec les flux éphémères arbitraires, tels qu'une bibliothèque en réseau pouvant être recherchée. Les sources Bluetooth associées et nommées sont prises en charge. Les sources peuvent avoir plusieurs noms. Les noms créés et découverts par l'utilisateur sont donc acceptés, ainsi que les noms par défaut. Par exemple, "hdmi_1" peut également être "Lecteur DVD", ou "usb_1" peut également être "Disque dur".

Les entrées multimédias peuvent être ordonnées pour prendre en charge les commandes "suivant" et "précédent".

Comme pour Toggles et Modes, les noms des entrées doivent être fournis dans toutes les langues disponibles. Cela est particulièrement pertinent pour les noms par défaut.

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
availableInputs Array

Obligatoire.

Liste d'objets représentant les flux audio ou vidéo d'entrée. Les flux peuvent être câblés ou en réseau. Chaque flux doit être nommé et suffisamment persistant. Veillez à définir vos synonymes avec soin pour éviter les déclenchements indésirables (trop nombreux).
[item, ...] Objet

Données disponibles.
key String

Obligatoire.

Clé unique de la saisie. La clé ne doit pas être exposée aux utilisateurs dans la parole ou la réponse.
names Array

Obligatoire.

Liste des noms de l'entrée pour toutes les langues disponibles.
[item, ...] Objet

Saisie pour une langue disponible donnée.
lang String

Obligatoire.

Code de langue.
name_synonym Array

Obligatoire.

Noms conviviaux pour l'entrée, dans une langue donnée. Le premier synonyme est utilisé dans la réponse de l'Assistant Google à l'utilisateur.
[item, ...] String

Saisissez un nom.
commandOnlyInputSelector Valeur booléenne

(Par défaut : false)

Indique si l'appareil prend en charge la communication à sens unique (true) ou à double sens (false). Définissez cet attribut sur "true" si l'appareil ne peut pas répondre à un intent QUERY ou à un état de rapport pour cette caractéristique.
orderedInputs Valeur booléenne

(Par défaut : false)

"True" si la liste de sortie est triée. Cela indique également que les fonctionnalités "Suivant" et "Précédent" sont disponibles.

Exemples

Appareil avec deux entrées ordonnées.

{
  "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
}

É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
currentInput String

Obligatoire.

Clé de la saisie actuellement utilisée.

Exemples

Appareil avec entrée HDMI actuellement sélectionnée.

{
  "currentInput": "hdmi_1"
}

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

Définissez l'entrée multimédia.

Paramètres

Paramètres Type Description
newInput String

Obligatoire.

Clé de la nouvelle entrée.

Exemples

Sélectionner l'entrée USB

{
  "command": "action.devices.commands.SetInput",
  "params": {
    "newInput": "usb_1"
  }
}

action.devices.commands.NextInput

Sélectionnez la saisie suivante. Ne s'applique que si l'attribut orderedInputs est défini sur "True".

Cette commande nécessite les attributs suivants: 
{
  "orderedInputs": true
}

Paramètres

Paramètres Type Description

Aucune propriété

Exemples

Aucun paramètre

{
  "command": "action.devices.commands.NextInput",
  "params": {}
}

action.devices.commands.PreviousInput

Sélectionnez la saisie précédente. Ne s'applique que si l'attribut orderedInputs est défini sur "True".

Cette commande nécessite les attributs suivants: 
{
  "orderedInputs": true
}

Paramètres

Paramètres Type Description

Aucune propriété

Exemples

Aucun paramètre

{
  "command": "action.devices.commands.PreviousInput",
  "params": {}
}

Exemples d'énoncés

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

ERREURS de l'appareil

Consultez la liste complète des erreurs et exceptions.

unsupportedInput: la saisie n'est pas disponible pour le moment.