Giản đồ đặc điểm kênh Nhà thông minh

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 thiết bị đa phương tiện.

Các kênh có sẵn 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ý. Để đảm bảo độ trễ truy vấn thấp, bạn nên giữ cho danh sách kênh nhỏ (tối đa 30 kênh).

Thuộc tính 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 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ả các kênh nội dung nghe nhìn 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 nội dung nghe nhìn có sẵn.
key String

Bắt buộc.

Giá trị nhận dạng duy nhấ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

Mã nhận dạng dạng số (không bắt buộc) cho kênh này.
commandOnlyChannels Boolean

(Mặc định: false)

Cho biết liệu thiết bị có hỗ trợ giao tiếp một chiều (true) hay hai chiều (false) hay không. Đặ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 Báo cáo trạng thái 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ó.

lệnh của 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 quá trình hoạt động 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 các mục 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 duy nhất của kênh được yêu cầu, khớp với một trong availableChannels.
channelName String

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

Giá trị nhận dạng dạng số của 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ố của 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 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 lượng 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 về 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 bạn đã xem

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

Đã xảy ra lỗi khi quay về 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 đủ lỗi và ngoại lệ.