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

action.devices.traits.InputSelector : cette caractéristique est utilisée pour les appareils qui peuvent 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 que les bibliothèques en réseau incluses dans l'index de recherche. Les sources Bluetooth associées et nommées sont compatibles. 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 commandées pour accepter les commandes "next" et "previous".

Comme pour Toggles et Modes, les noms des entrées doivent être fournis dans toutes les langues disponibles, particulièrement 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 pour l'entrée. Les utilisateurs ne doivent pas voir la clé à l'oral ni dans une réponse.
names Array

Obligatoire.

Liste des noms d'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 unidirectionnelle (vrai) ou bidirectionnelle (faux). 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"
}

COMMANDS d'appareils

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 une 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 l'entrée 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.