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

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

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