Lược đồ đặc điểm kênh nhà thông minh

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

Các kênh hiện có phải được chia sẻ dưới dạng danh sách, theo 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 phải 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ý theo dõi. Để đảm bảo độ trễ truy vấn thấp, bạn nên giữ cho danh sách kênh ở mức nhỏ (tối đa 30 kênh).

THUỘC TÍNH của 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 thao tác 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 Mô tả
availableChannels Mảng

Bắt buộc.

Danh sách các đối tượng mô tả những 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 có sẵn.
key String

Bắt buộc.

Giá trị nhận dạng riêng biệt của kênh này. Không 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, ...] String

Tên kênh.
number String

Giá trị nhận dạng bằng số (không bắt buộc) cho kênh này.
commandOnlyChannels Boolean

(Mặc định: false)

Cho biết thiết bị có hỗ trợ sử dụng giao tiếp một chiều (true) hay hai chiều (false). Đặt thuộc tính này thành true nếu thiết bị không thể phản hồi ý định QUERY hoặc Report State cho đặc điểm này.

Ví dụ

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

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

TRẠNG THÁI THIẾT BỊ

Không có.

LỆNH trên thiết bị

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ể.

Thông số

Tải trọng chứa một trong những nội dung sau:

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

Thông số Loại Mô tả
channelCode String

Bắt buộc.

Giá trị nhận dạng riêng biệt của kênh được yêu cầu, khớp với một trong các availableChannels.
channelName String

Tên thân thiện của kênh được yêu cầu.
channelNumber String

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

Chọn kênh theo số

Thông số Loại Mô tả
channelNumber String

Bắt buộc.

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

Ví dụ

Thay đổi thành 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 một 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 một mức tương đối.

Thông số

Thông số Loại Mô tả
relativeChannelChange Số nguyên

Bắt buộc.

Số lượng kênh cần 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 gần đây nhất/trước đó mà người dùng đã xem.

Thông số

Thông số Loại Mô tả

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

Ví dụ

Quay lại kênh gần đây nhất

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

Đã xảy ra lỗi khi chuyển về kênh cuối cùng của thiết bị.

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

channelSwitchFailed

LỖI thiết bị

Xem danh sách đầy đủ các lỗi và trường hợp ngoại lệ.