Smart Home InputSelector 結構結構定義

action.devices.traits.InputSelector - 這個特徵用於可切換輸入來源的裝置。

媒體輸入可以為每個裝置設定動態名稱,代表音訊或視訊動態饋給。這些動態饋給可以使用線路或網路連線,但必須具有合理持續性的名稱和合理性。這項特徵不支援任意臨時動態饋給,例如可搜尋的網路程式庫。系統支援已命名的已配對藍牙來源。來源可包含多個名稱,因此支援使用者建立及發現的名稱,以及預設名稱。舉例來說,「hdmi_1」也可能是「DVD 播放程式」或「usb_1」,也可能是「硬碟機」。

媒體輸入可排序以支援「下一個」和「上一個」指令。

如同 TogglesModes 一樣,輸入內容的名稱應以所有可用語言提供,這對於預設名稱尤其重要。

裝置屬性

具備這個特性的裝置可能會在 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:目前不支援輸入內容。