Giản đồ về đặc điểm của hiệu ứng ánh sáng nhà thông minh

action.devices.traits.LightEffects – Đặc điểm này thuộc về các thiết bị có thể hỗ trợ các lệnh chiếu sáng phức tạp để thay đổi trạng thái, chẳng hạn như lặp lại qua nhiều màu sắc.

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

Ví dụ

Thiết bị hỗ trợ hiệu ứng lặp màu.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Thiết bị hỗ trợ hiệu ứng ngủ/thức.

{
  "defaultSleepDuration": 300,
  "defaultWakeDuration": 600,
  "supportedEffects": [
    "sleep",
    "wake"
  ]
}

Thiết bị STATES

Các thực thể có đặc điểm này có thể báo cáo các trạng thái sau đây trong quá trình thực hiện thao tác QUERY. Để tìm hiểu thêm về cách xử lý ý định QUERY, hãy xem bài viết Thực hiện ý định.

Ví dụ

Tình trạng hiện tại ảnh hưởng như thế nào đến thiết bị của tôi?

{
  "activeLightEffect": "colorLoop"
}

Tình trạng hiện tại ảnh hưởng như thế nào đến thiết bị của tôi?

{
  "activeLightEffect": "sleep",
  "lightEffectEndUnixTimestampSec": 1595286869
}

Không có hiệu ứng ánh sáng nào đang hoạt động.

{}

LỆNH 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.ColorLoop

Yêu cầu thiết bị luân phiên qua một nhóm màu.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Thông số

Ví dụ

Đèn của tôi chuyển màu trong 60 phút.

{
  "command": "action.devices.commands.ColorLoop",
  "params": {
    "duration": 3600
  }
}

action.devices.commands.Sleep

Dần dần giảm độ sáng của thiết bị và tuỳ ý điều chỉnh nhiệt độ màu trong một khoảng thời gian.

{
  "supportedEffects": [
    "sleep"
  ]
}

Thông số

Ví dụ

Chuyển đèn sang chế độ ngủ trong 60 phút.

{
  "command": "action.devices.commands.Sleep",
  "params": {
    "duration": 3600
  }
}

action.devices.commands.StopEffect

Dừng hiệu ứng ánh sáng hiện tại.

Thông số

Ví dụ

Dừng hiệu ứng trên đèn của tôi.

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

action.devices.commands.Wake

Tăng dần độ sáng của thiết bị và điều chỉnh nhiệt độ màu trong một khoảng thời gian (không bắt buộc).

{
  "supportedEffects": [
    "wake"
  ]
}

Thông số

Ví dụ

Bật đèn của tôi trong 60 phút.

{
  "command": "action.devices.commands.Wake",
  "params": {
    "duration": 3600
  }
}

Mô phỏng hiệu ứng ánh sáng

Nếu thiết bị của bạn triển khai đặc điểm Brightness nhưng không triển khai đặc điểm LightEffects, thì nền tảng sẽ hỗ trợ các hiệu ứng "ngủ" và "đánh thức" được mô phỏng mà không cần thêm mã. Nền tảng này mô phỏng các hiệu ứng bằng cách gửi một loạt ý định EXECUTE.

Cách phát âm mẫu

LỖI thiết bị