Sơ đồ đặc điểm LightEffects của nhà thông minh

action.devices.traits.LightEffects – Đặc điểm này thuộc về những 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 nhiều màu sắc.

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.

Ví dụ

Thiết bị hỗ trợ hiệu ứng đổi màu nối tiếp.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

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

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

TRẠNG THÁI thiết bị

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 thao tác QUERY. Để tìm hiểu thêm về cách xử lý ý định QUERY, hãy xem phần Thực hiện ý định.

Ví dụ

Thiết bị của tôi hiện chịu ảnh hưởng như thế nào?

{
  "activeLightEffect": "colorLoop"
}

Thiết bị của tôi hiện chịu ảnh hưởng như thế nào?

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

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

{}

Lệnh cho 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 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.ColorLoop

Yêu cầu thiết bị chuyển đổi qua một nhóm màu.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Thông số

Ví dụ

Đổi màu đèn trong 60 phút.

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

action.devices.commands.Sleep

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

{
  "supportedEffects": [
    "sleep"
  ]
}

Thông số

Ví dụ

Cho đèn của tôi tạm nghỉ 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.

{
  "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 (nếu muốn) trong một khoảng thời gian.

{
  "supportedEffects": [
    "wake"
  ]
}

Thông số

Ví dụ

Đánh thức đè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à "thức" được mô phỏng mà không cần mã bổ sung. 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âu nói mẫu

LỖI thiết bị