Lược đồ đặc điểm kênh thông minh trên trang chủ

action.devices.traits.Channel – Đặc điểm này thuộc về các thiết bị hỗ trợ kênh truyền hình trên một thiết bị truyền thông.

Các kênh có sẵn nên được chia sẻ dưới dạng danh sách cho mỗi người dùng hoặc thiết bị trong quá trình SYNC thông qua thuộc tính availableChannels. Danh sách này nên bao gồm tất cả các kênh hàng đầu hoặc phổ biến mà người dùng hoặc thiết bị đã đăng ký. Để đảm bảo độ trễ truy vấn thấp, bạn nên duy trì danh sách kênh có dung lượng nhỏ (30 kênh trở xuống).

ATTRIBUTES thiết bị

Các thiết bị có đặc điểm này có thể báo cáo các thuộc tính sau đây trong quá trình thực hiện SYNC. Để tìm hiểu thêm về cách xử lý ý định SYNC, hãy xem phần Thực hiện ý định.

Thuộc tính Loại Nội dung mô tả
availableChannels Mảng

Bắt buộc.

Danh sách đối tượng mô tả các kênh truyền thông có sẵn cho thiết bị cụ thể này. Mỗi mục mô tả một kênh mà người dùng có thể chọn trên thiết bị này.
[item, ...] Đối tượng

Kênh truyền thông hiện có.
key Chuỗi

Bắt buộc.

Giá trị nhận dạng duy nhất cho kênh này. Không được hiển thị cho người dùng.
names Mảng

Bắt buộc.

Danh sách tên hiển thị cho người dùng của kênh này.
[item, ...] Chuỗi

Tên kênh.
number Chuỗi

Số nhận dạng tùy chọn cho kênh này.
commandOnlyChannels Boolean

(Mặc định: false)

Cho biết thiết bị có hỗ trợ giao tiếp một chiều (đúng) hay hai chiều (sai) hay không. Đặt thuộc tính này thành đúng nếu thiết bị không thể phản hồi ý định QUERY hoặc Trạng thái báo cáo cho đặc điểm này.

Ví dụ

Thiết bị hỗ trợ hai kênh.

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

Thiết bị STATES

Không có.

Thiết bị COMMANDS

Các thiết bị có đặc điểm này có thể phản hồi các lệnh sau đây trong thao tác EXECUTE. Để tìm hiểu thêm về cách xử lý ý định EXECUTE, hãy xem phần Thực hiện ý định.

action.devices.commands.selectChannel

Đặt kênh hiện tại thành một giá trị cụ thể.

Các tham số

Trọng tải chứa một trong những mục sau:

Chọn kênh theo mã nhận dạng

Các tham số Loại Mô tả
channelCode Chuỗi

Bắt buộc.

Giá trị nhận dạng duy nhất của kênh được yêu cầu, khớp với một trong các giá trị availableChannels.
channelName Chuỗi

Tên thân thiện của người dùng của kênh được yêu cầu.
channelNumber Chuỗi

Giá trị nhận dạng dạng số cho kênh được yêu cầu.

Chọn kênh theo số

Các tham số Loại Mô tả
channelNumber Chuỗi

Bắt buộc.

Giá trị nhận dạng dạng số cho kênh được yêu cầu.

Ví dụ

Đổi sang KTVU

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

Chuyển sang kênh 3.

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

Đã xảy ra lỗi khi chọn kênh mới trên thiết bị.

Các giá trị được hỗ trợ:

noAvailableChannel
noChannelSubscription
channelSwitchFailed

action.devices.commands.relativeChannel

Điều chỉnh kênh hiện tại theo số tiền tương đối.

Các tham số

Các tham số Loại Nội dung mô tả
relativeChannelChange Số nguyên

Bắt buộc.

Số kênh tăng hoặc giảm.

Ví dụ

Chuyển sang kênh tiếp theo

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

Chuyển sang kênh trước

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

Đã xảy ra lỗi khi điều chỉnh kênh của thiết bị.

Các giá trị được hỗ trợ:

channelSwitchFailed

action.devices.commands.returnChannel

Quay lại kênh trước đó/trước đó của người dùng.

Các tham số

Các tham số Loại Nội dung mô tả

Không có thuộc tính nào

Ví dụ

Quay lại kênh cuối cùng

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

Đã xảy ra lỗi khi quay lại kênh cuối cùng của thiết bị.

Các giá trị được hỗ trợ:

channelSwitchFailed

Thiết bị ERRORS

Xem danh sách đầy đủ các lỗi và ngoại lệ.