スマートホームの InputSelector トレイトのスキーマ
action.devices.traits.InputSelector
- このトレイトは、入力を切り替えられるデバイスに使用されます。
メディア入力には、音声フィードまたは動画フィードを表すデバイスごとに動的な名前を付けることができます。これらのフィードは有線でもネットワークでも構いませんが、名前をつけて、合理的に永続的にする必要があります。このトレイトは、検索可能なネットワーク ライブラリなど、任意の一時フィードをサポートしていません。ペアの名前付き Bluetooth ソースがサポートされています。ソースには複数の名前を付けることができるため、デフォルトの名前だけでなく、ユーザーが作成した名前や検出された名前がサポートされます。たとえば、「hdmi_1」は「DVD プレーヤー」や、「usb_1」は「ハードドライブ」にすることもできます。
メディア入力を並べ替えて、「次へ」と「前へ」のコマンドをサポートできます。
Toggles や Modes と同様に、入力の名前は利用可能なすべての言語で指定する必要があります。これは特にデフォルトの名前に関連しています。
デバイスの属性
このトレイトを持つデバイスは、SYNC
オペレーションの一部として次の属性をレポートできます。SYNC
インテントの処理方法については、インテントのフルフィルメントをご覧ください。
属性 | タイプ | 説明 |
---|---|---|
availableInputs |
配列 |
必須。 入力音声フィードまたは動画フィードを表すオブジェクトのリスト。フィードは有線接続でも、ネットワーク接続でも構いません。各フィードには名前を付け、妥当な永続性を確保する必要があります。望ましくない(過剰な)トリガーを避けるため、類義語は慎重に定義してください。 |
[item, ...] |
温度計 |
使用可能な入力です。 |
key |
文字列 |
必須。 入力の一意のキー。キーは、音声またはレスポンスでユーザーに開示しないでください。 |
names |
配列 |
必須。 利用可能なすべての言語の入力の名前のリスト。 |
[item, ...] |
温度計 |
指定された利用可能な言語の入力。 |
lang |
文字列 |
必須。 言語コード。 |
name_synonym |
配列 |
必須。 任意の言語で記述された、ユーザー フレンドリーな入力名。最初の類義語は、ユーザーに対する Google アシスタントのレスポンスで使用されます。 |
[item, ...] |
文字列 |
名前を入力します。 |
commandOnlyInputSelector |
ブール値 |
(デフォルト: デバイスが一方向(true)または双方向(false)の通信の使用をサポートしているかどうかを示します。デバイスがこのトレイトの QUERY インテントまたは Report State に応答できない場合は、この属性を true に設定します。 |
orderedInputs |
ブール値 |
(デフォルト: 出力のリストが並べ替えられる場合は true に設定します。また、「次へ」と「前へ」の機能が利用できることも示しています。 |
例
順序付けされた 2 つの入力を持つデバイス
{ "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 }
デバイスのステータス
このトレイトを持つエンティティは、QUERY
オペレーションの一部として次の状態をレポートできます。QUERY
インテントの処理方法については、インテントのフルフィルメントをご覧ください。
状態 | タイプ | 説明 |
---|---|---|
currentInput |
文字列 |
必須。 現在使用中の入力のキー。 |
例
HDMI 入力が現在選択されているデバイス。
{ "currentInput": "hdmi_1" }
デバイスのコマンド
このトレイトを持つデバイスは、EXECUTE
オペレーションの一部として次のコマンドに応答できます。EXECUTE
インテントの処理方法については、インテントのフルフィルメントをご覧ください。
action.devices.commands.SetInput
メディア入力を設定します。
パラメータ
パラメータ | タイプ | 説明 |
---|---|---|
newInput |
文字列 |
必須。 新しい入力のキー。 |
例
USB 入力を選択
{ "command": "action.devices.commands.SetInput", "params": { "newInput": "usb_1" } }
action.devices.commands.NextInput
次の入力を選択します。orderedInputs
属性が true に設定されている場合にのみ適用可能です。
{ "orderedInputs": true }
パラメータ
パラメータ | タイプ | 説明 |
---|---|---|
プロパティがありません |
例
パラメータなし
{ "command": "action.devices.commands.NextInput", "params": {} }
action.devices.commands.PreviousInput
前の入力を選択します。orderedInputs
属性が true に設定されている場合にのみ適用可能です。
{ "orderedInputs": true }
パラメータ
パラメータ | タイプ | 説明 |
---|---|---|
プロパティがありません |
例
パラメータなし
{ "command": "action.devices.commands.PreviousInput", "params": {} }
サンプル音声
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
デバイスエラー
エラーと例外の全リストをご覧ください。unsupportedInput
: 入力は現在サポートされていません。