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

智慧型住宅頻道特性結構定義

action.devices.traits.Channel - 此屬性屬於支援媒體裝置上的電視頻道的裝置。

在同步處理期間,系統會使用 availableChannels 屬性,以使用者或裝置的形式分享可用的管道。這份清單會列出使用者或裝置訂閱的所有熱門或熱門頻道。為了確保查詢延遲,建議您將頻道清單維持在更小的狀態 (不超過 30 個管道)。

裝置屬性

具有此特性的裝置可能會在 SYNC 作業中回報下列屬性。如要進一步瞭解如何處理 SYNC 意圖,請參閱意圖執行要求一文。

屬性 類型 說明
availableChannels 陣列

必填。

描述此裝置可用媒體頻道的物件清單。每個項目都描述了使用者可以在這部裝置上選取的頻道。

[item, ...] 物件

可用的媒體頻道。

key 字串

必填。

這個頻道的專屬 ID。不會向使用者顯示。

names 陣列

必填。

使用者看到的管道名稱清單。

[item, ...] 字串

頻道名稱。

number 字串

這個頻道的自選數字 ID。

commandOnlyChannels 布林

(預設:false)

指出裝置是否支援單向 (true) 或雙向 (false) 通訊。如果裝置無法回應此特徵的 QUERY 意圖或報告狀態,請將此屬性設為 true。

範例

支援兩個管道的裝置。

{
  "availableChannels": [
    {
      "key": "ktvu2",
      "names": [
        "Fox",
        "KTVU"
      ],
      "number": "2"
    },
    {
      "key": "abc1",
      "names": [
        "ABC",
        "ABC East"
      ],
      "number": "4-11"
    }
  ]
}

裝置狀態:STATE

無。

裝置指令

具有此特性的裝置可能會在 EXECUTE 作業中回應下列指令。如要進一步瞭解如何處理 EXECUTE 意圖,請參閱意圖執行要求一文。

action.devices.commands.selectChannel

將目前的頻道設定為特定的值。

參數

酬載包含下列其中一個值:

依 ID 選擇頻道

參數 類型 說明
channelCode 字串

必填。

要求管道的專屬 ID,與其中一個 availableChannels 相符。

channelName 字串

所要求頻道的容易使用名稱。

channelNumber 字串

所要求頻道的數字 ID。

依號碼選取頻道

參數 類型 說明
channelNumber 字串

必填。

所要求頻道的數字 ID。

範例

變更為 KTVU

{
  "command": "action.devices.commands.selectChannel",
  "params": {
    "channelCode": "ktvu2",
    "channelName": "KTVU"
  }
}

轉到第 3 頻道。

{
  "command": "action.devices.commands.selectChannel",
  "params": {
    "channelNumber": "3"
  }
}

選取裝置上的新頻道時發生錯誤。

支援的值:

noAvailableChannel
noChannelSubscription
channelSwitchFailed

action.devices.commands.relativeChannel

依目前的金額調整目前的頻道。

參數

參數 類型 說明
relativeChannelChange 整數

必填。

要增加或減少的頻道數。

範例

切換至下一個頻道

{
  "command": "action.devices.commands.relativeChannel",
  "params": {
    "relativeChannelChange": 1
  }
}

切換至上一個頻道

{
  "command": "action.devices.commands.relativeChannel",
  "params": {
    "relativeChannelChange": -1
  }
}

調整裝置版本時發生錯誤。

支援的值:

channelSwitchFailed

action.devices.commands.returnChannel

返回使用者上次造訪/上一個頻道。

參數

參數 類型 說明

沒有任何資源

範例

返回最後一個頻道

{
  "command": "action.devices.commands.returnChannel",
  "params": {}
}

返回裝置的最後一個頻道時發生錯誤。

支援的值:

channelSwitchFailed

裝置錯誤:ERRORS

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