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 : 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 : "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".
{ "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".
{ "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.