Smart Home InputSelector 結構結構定義
action.devices.traits.InputSelector
- 這個特徵用於可切換輸入來源的裝置。
媒體輸入可以為每個裝置設定動態名稱,代表音訊或視訊動態饋給。這些動態饋給可以使用線路或網路連線,但必須具有合理持續性的名稱和合理性。這項特徵不支援任意臨時動態饋給,例如可搜尋的網路程式庫。系統支援已命名的已配對藍牙來源。來源可包含多個名稱,因此支援使用者建立及發現的名稱,以及預設名稱。舉例來說,「hdmi_1」也可能是「DVD 播放程式」或「usb_1」,也可能是「硬碟機」。
媒體輸入可排序以支援「下一個」和「上一個」指令。
如同 Toggles 和 Modes 一樣,輸入內容的名稱應以所有可用語言提供,這對於預設名稱尤其重要。
裝置屬性
具備這個特性的裝置可能會在 SYNC
作業中回報下列屬性。如要進一步瞭解如何處理 SYNC
意圖,請參閱「意圖執行要求」。
屬性 | 類型 | 說明 |
---|---|---|
availableInputs |
陣列 |
必要。 代表輸入音訊或視訊動態饋給的物件清單。動態饋給可以是有線或網路連線。每個動態饋給應命名且合理。請務必仔細定義同義詞,以免產生不必要的 (過度) 觸發。 |
[item, ...] |
物件 |
。 |
key |
String |
必要。 輸入項目的專屬鍵。請勿以語音或回應的形式向使用者顯示金鑰。 |
names |
陣列 |
必要。 所有可用語言的輸入內容名稱清單。 |
[item, ...] |
物件 |
指定可用語言的輸入內容。 |
lang |
String |
必要。 語言代碼。 |
name_synonym |
陣列 |
必要。 簡單易懂的輸入內容名稱,以某種語言寫成。第一個同義詞會用於 Google 助理回應使用者的回應。 |
[item, ...] |
String |
輸入名稱。 |
commandOnlyInputSelector |
布林 |
(預設值: 指出裝置是否支援單向 (true) 或雙向 (false) 通訊。如果裝置無法回應此特性的 QUERY 意圖或報告狀態,請將此屬性設為 true。 |
orderedInputs |
布林 |
(預設值: 如果輸出清單已排序,則為「是」。這也表示您可以使用「下一個」和「上一個」功能。 |
範例
裝置有兩個已排序的輸入來源:
{ "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 |
String |
必要。 目前使用中的輸入鍵。 |
範例
目前已選取具備 HDMI 輸入端的裝置。
{ "currentInput": "hdmi_1" }
裝置指令
具有這個特性的裝置可能會在 EXECUTE
作業中回應下列指令。如要進一步瞭解如何處理 EXECUTE
意圖,請參閱「意圖執行要求」。
action.devices.commands.SetInput
設定媒體輸入來源。
參數
參數 | 類型 | 說明 |
---|---|---|
newInput |
String |
必要。 新輸入的鍵。 |
範例
選取 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
:目前不支援輸入內容。