Schéma de trait du sélecteur de saisie de la maison connectée

action.devices.traits.InputSelector : cette caractéristique est utilisée pour les appareils capables de permuter les entrées.

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 consultable. Les sources Bluetooth associées et nommées sont compatibles. Les sources peuvent avoir plusieurs noms. Par conséquent, les noms créés et découverts par l'utilisateur sont acceptés, de même 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 classé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 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
availableInputs Array

Obligatoire.

Liste d'objets représentant des 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 assez persistant. Veillez à définir vos synonymes avec soin afin d'éviter tout déclenchement indésirable.

[item, ...] Objet

Entrée disponible.

key String

Obligatoire.

Clé unique de l'entrée. Les utilisateurs ne doivent pas voir la clé dans la voix ni dans la réponse.

names Array

Obligatoire.

Liste des noms d'entrée pour toutes les langues disponibles.

[item, ...] Objet

Entrée pour une langue disponible donnée.

lang String

Obligatoire.

Code de langue.

name_synonym Array

Obligatoire.

Noms conviviaux de 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

Nom de l'entrée.

commandOnlyInputSelector Booléen

(Par défaut : false)

Indique si l'appareil est compatible avec la communication unidirectionnelle (vrai) ou bidirectionnelle (faux). Définissez cet attribut sur "true" si l'appareil ne peut pas répondre à un intent QUERY ni à un état de rapport pour cette caractéristique.

orderedInputs Booléen

(Par défaut : false)

"True" si la liste de résultats est triée. Cela indique également que les fonctionnalités "suivant" et "précédent" sont disponibles.

Exemples

Appareil avec deux entrées classé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
}

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

Obligatoire.

Clé de l'entrée actuellement utilisée.

Exemples

Appareil avec entrée HDMI sélectionnée

{
  "currentInput": "hdmi_1"
}

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.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 l'entrée suivante. Ne s'applique que lorsque 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 lorsque 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 sur l'appareil

Consultez la liste complète des erreurs et exceptions.

unsupportedInput: la saisie n'est pas acceptée pour l'instant.