スマートホームの InputSelector トレイトのスキーマ
action.devices.traits.InputSelector
- このトレイトは、入力を切り替えられるデバイスに使用されます。
メディア入力には、音声フィードまたは動画フィードを表すデバイスごとに動的な名前を設定できます。これらのフィードは有線接続とネットワーク作成のどちらでもかまいませんが、適切に対応し、永続性のある名前を付ける必要があります。このトレイトは、検索可能なネットワーク ライブラリなど、任意の一時的なフィードをサポートしていません。ペア設定された名前付き Bluetooth ソースがサポートされます。ソースには複数の名前を付けることができるので、ユーザーが作成して検出した名前だけでなく、デフォルト名もサポートされています。たとえば、「hdmi_1」は「DVD プレーヤー」、または「usb_1」は「ハードドライブ」の場合もあります。
メディア入力は「次」と「前」のコマンドをサポートするために並べ替えることができます。
切り替えやモードと同様に、入力の名前は利用可能なすべての言語で指定する必要があります。特に、デフォルト名に関連します。
デバイスの属性
このトレイトを持つデバイスは、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
: 入力は現在サポートされていません。