Lược đồ đặc điểm LightEffects của 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 nhiều màu.

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 hoạt động SYNC. Để tìm hiểu thêm về cách xử lý ý định SYNC, hãy xem bài viết Thực hiện ý định.

Ví dụ

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

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Thiết bị hỗ trợ hiệu ứng 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 quá trình hoạt động 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ụ

Hiệu ứng hiện tại trên thiết bị của tôi là gì?

{
  "activeLightEffect": "colorLoop"
}

Hiệu ứng hiện tại trên thiết bị của tôi là gì?

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

Hiện 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 bài viết Thực hiện ý định.

action.devices.commands.ColorLoop

Yêu cầu thiết bị chuyển đổi qua một tập hợp màu.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Thông số

Ví dụ

Lặp lại màu đèn của tôi 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à tuỳ ý điều chỉnh nhiệt độ màu trong một khoảng thời gian.

{
  "supportedEffects": [
    "sleep"
  ]
}

Thông số

Ví dụ

Làm cho đèn của tôi 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à tuỳ ý điều chỉnh nhiệt độ màu trong một khoảng thời gian.

{
  "supportedEffects": [
    "wake"
  ]
}

Thông số

Ví dụ

Làm cho đèn của tôi thức 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 này 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.

Mẫu câu

LỖI thiết bị