智慧型住宅 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	布林	(預設：false) 指出裝置是否支援單向 (true) 或雙向 (false) 通訊。如果裝置無法回應此特徵的 QUERY 意圖或報告狀態，請將此屬性設為 true。
orderedInputs	布林	(預設：false) 如果輸出清單已排序，則傳回 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é 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

裝置錯誤：ERRORS

請參閱錯誤和例外狀況的完整清單。

unsupportedInput：目前不支援輸入內容。