智慧型住宅輸入選取器特徵結構定義

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 布林值

(預設值：false)

指出裝置是否支援單向 (true) 或雙向 (false) 通訊。如果裝置無法回應此特徵的「QUERY」意圖或「回報狀態」，請將這項屬性設為 true。
orderedInputs 布林值

(預設值：false)

如果輸出清單已排序，則為「是」。這也表示「下一個」以及「上一個」您仍能使用這些功能。

範例

裝置含有兩項已排序的輸入來源。

{
  "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：目前不支援輸入內容。