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