智慧型住宅 InputSelector 特性結構定義
action.devices.traits.InputSelector
- 此屬性可用於可切換輸入裝置的裝置。
媒體輸入可包含多個裝置的動態名稱,用來代表音訊或視訊動態饋給。這些動態饋給可以採用有線技術或網路,但應該能夠命名且合理持續性。這類特性不支援任意的臨時動態饋給,例如可供搜尋的網路網路程式庫。系統支援已配對的已命名藍牙來源。來源可以有多個名稱,因此支援使用者建立及探索的名稱,以及預設名稱。舉例來說,「hdmi_1」也可能是「DVD 播放器」,或「usb_1」也可能是「硬碟」。
可排序媒體輸入以支援「下一個」和「上一個」指令。
與 Toggles 和 Modes 一樣,輸入項目的名稱也必須以所有可用的語言提供,尤其在預設名稱中特別重要。
裝置屬性
具有此特性的裝置可能會在 SYNC
作業中回報下列屬性。如要進一步瞭解如何處理 SYNC
意圖,請參閱意圖執行要求一文。
屬性 | 類型 | 說明 |
---|---|---|
availableInputs |
陣列 |
必填。 代表輸入音訊或視訊資訊提供的物件清單。動態饋給可採用有線或網路連線。每個動態饋給都應命名且合理。請務必謹慎定義您的同義詞,以避免意外 (超過) 觸發。 |
[item, ...] |
物件 |
可用的輸入項目。 |
key |
字串 |
必填。 輸入的專屬鍵。不應在語音或回應中向使用者顯示金鑰。 |
names |
陣列 |
必填。 所有可用語言輸入內容的名稱清單。 |
[item, ...] |
物件 |
輸入特定語言。 |
lang |
字串 |
必填。 語言代碼。 |
name_synonym |
陣列 |
必填。 使用者可輕鬆輸入的輸入名稱。第一個同義詞會用於 Google 助理回應使用者。 |
[item, ...] |
字串 |
輸入名稱。 |
commandOnlyInputSelector |
布林 |
(預設: 指出裝置是否支援單向 (true) 或雙向 (false) 通訊。如果裝置無法回應此特徵的 QUERY 意圖或報告狀態,請將此屬性設為 true。 |
orderedInputs |
布林 |
(預設: 如果輸出清單已排序,則傳回 True。這也表示「下一個」和「上一個」功能可供使用。 |
範例
具有兩個已排序輸入裝置的裝置。
{ "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 }
裝置狀態:STATE
具有此特性的實體可能會在 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é surHDMI 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 opbluetooth
pt-BR
-
Muda a entrada da
TV paraHDMI2 . -
mudar a entrada para
AUX
sv-SE
-
Sätt på
hdmi 1
裝置錯誤:ERRORS
請參閱錯誤和例外狀況的完整清單。unsupportedInput
:目前不支援輸入內容。