歡迎使用 Google Home 開發人員中心,探索全新功能,瞭解如何開發智慧住宅動作。注意:請繼續在「動作」控制台中建立動作。
透過集合功能整理內容 你可以依據偏好儲存及分類內容。

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

action.devices.traits.InputSelector - 此屬性可用於可切換輸入裝置的裝置。

媒體輸入可包含多個裝置的動態名稱,用來代表音訊或視訊動態饋給。這些動態饋給可以採用有線技術或網路,但應該能夠命名且合理持續性。這類特性不支援任意的臨時動態饋給,例如可供搜尋的網路網路程式庫。系統支援已配對的已命名藍牙來源。來源可以有多個名稱,因此支援使用者建立及探索的名稱,以及預設名稱。舉例來說,「hdmi_1」也可能是「DVD 播放器」,或「usb_1」也可能是「硬碟」。

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

TogglesModes 一樣,輸入項目的名稱也必須以所有可用的語言提供,尤其在預設名稱中特別重要。

裝置屬性

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