智慧型住宅頻道特性結構定義
action.devices.traits.Channel
- 此屬性屬於支援媒體裝置上的電視頻道的裝置。
availableChannels
屬性,以使用者或裝置的形式分享可用的管道。這份清單會列出使用者或裝置訂閱的所有熱門或熱門頻道。為了確保查詢延遲,建議您將頻道清單維持在更小的狀態 (不超過 30 個管道)。裝置屬性
具有此特性的裝置可能會在 SYNC
作業中回報下列屬性。如要進一步瞭解如何處理 SYNC
意圖,請參閱意圖執行要求一文。
屬性 | 類型 | 說明 |
---|---|---|
availableChannels |
陣列 |
必填。 描述此裝置可用媒體頻道的物件清單。每個項目都描述了使用者可以在這部裝置上選取的頻道。 |
[item, ...] |
物件 |
可用的媒體頻道。 |
key |
字串 |
必填。 這個頻道的專屬 ID。不會向使用者顯示。 |
names |
陣列 |
必填。 使用者看到的管道名稱清單。 |
[item, ...] |
字串 |
頻道名稱。 |
number |
字串 |
這個頻道的自選數字 ID。 |
commandOnlyChannels |
布林 |
(預設: 指出裝置是否支援單向 (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,與其中一個 |
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