智慧型住宅 InputSelector 特徵結構定義

action.devices.traits.InputSelector：此特徵用於可切換輸入裝置。

媒體輸入內容可為每部裝置提供動態名稱，代表音訊或視訊動態消息。這些動態饋給可以是硬連線或網路連線，但應具備名稱且可持續一段時間。這個特徵不支援任意暫時動態消息，例如可搜尋的網路程式庫。系統支援已配對的已命名藍牙來源。來源可以有多個名稱，因此系統支援使用者建立和發現的名稱，以及預設名稱。舉例來說，'hdmi_1' 也可能是'DVD 播放器'，或'usb_1' 也可能是'硬碟驅動器'。

媒體輸入內容可排序，以支援「next」和「previous」指令。

如同 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

裝置 ERRORS

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

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