Giản đồ tính trạng 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ị

Những thiết bị có đặc điểm này có thể báo cáo những điều sau trong thao tác SYNC. Để tìm hiểu tìm hiểu thêm về cách xử lý ý định SYNC, hãy xem Thực hiện ý định.

Thuộc tính Loại Mô tả
defaultColorLoopDuration Số nguyên

(Mặc định: 1800)

Thời lượng mặc định (tính bằng giây) cho hiệu ứng được kích hoạt bởi lệnh action.devices.commands.ColorLoop.
defaultSleepDuration Số nguyên

(Mặc định: 1800)

Thời lượng mặc định (tính bằng giây) cho hiệu ứng được kích hoạt bởi lệnh action.devices.commands.Sleep.
defaultWakeDuration Số nguyên

(Mặc định: 1800)

Thời lượng mặc định (tính bằng giây) cho hiệu ứng được kích hoạt bởi lệnh action.devices.commands.Wake.
supportedEffects Mảng

Bắt buộc.

Danh sách hiệu ứng mà thiết bị hỗ trợ.
[item, ...] String

Hiệu ứng được hỗ trợ.

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

colorLoop
Ghép các màu khác nhau một cách ngẫu nhiên.
sleep
Giảm dần độ sáng và điều chỉnh nhiệt độ màu trong một khoảng thời gian (không bắt buộc).
wake
Tăng dần độ sáng và điều chỉnh nhiệt độ màu (không bắt buộc) trong một khoảng thời gian.

Ví dụ

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

{
  "supportedEffects": [
    "colorLoop"
  ]
}

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

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

Thiết bị STATES

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

Tiểu bang Loại Mô tả
activeLightEffect String

Hiệu ứng ánh sáng đang hoạt động, nếu có. Một trong số supportedEffects.

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

colorLoop
sleep
wake
lightEffectEndUnixTimestampSec Số nguyên

Dấu thời gian của Unix khi hiệu ứng dự kiến sẽ kết thúc nếu hiệu ứng đó tự kết thúc.

Ví dụ

Thiết bị của tôi đang bị ảnh hưởng như thế nào?

{
  "activeLightEffect": "colorLoop"
}

Thiết bị của tôi đang bị ảnh hưởng như thế nào?

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

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

{}

lệnh của thiết bị

Những thiết bị có đặc điểm này có thể phản hồi với những đặc điểm sau các lệnh trong thao tác EXECUTE. Để tìm hiểu tìm hiểu thêm về cách xử lý ý định EXECUTE, hãy xem Thực hiện ý định.

action.devices.commands.ColorLoop

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

Lệnh này yêu cầu các thuộc tính sau: 
{
  "supportedEffects": [
    "colorLoop"
  ]
}

Tham số

Tham số Loại Mô tả
duration Số nguyên

Thời lượng của lệnh lặp màu, tính bằng giây.

Ví dụ

Colorloop đè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à điều chỉnh nhiệt độ màu theo ý muốn trong một khoảng thời gian.

Lệnh này yêu cầu các thuộc tính sau: 
{
  "supportedEffects": [
    "sleep"
  ]
}

Tham số

Tham số Loại Mô tả
duration Số nguyên

Thời lượng của lệnh ngủ, tính bằng giây.

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.

Tham số

Tham số Loại Mô tả

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

Ví dụ

Dừng hiệu ứng của đè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 (không bắt buộc) trong một khoảng thời gian.

Lệnh này yêu cầu các thuộc tính sau: 
{
  "supportedEffects": [
    "wake"
  ]
}

Tham số

Tham số Loại Mô tả
duration Số nguyên

Thời lượng của lệnh đánh thức, tính bằng giây.

Ví dụ

Đặt đèn ở chế độ bật 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 phải là LightEffects, nền tảng hỗ trợ "chế độ ngủ" được mô phỏng và "wake" 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

de-DE

  • Den Aufwacheffekt der Lampen starten.
  • Einschlafmodus im Schlafzimmer aktivieren.
  • synchronisiere meine Geräte

en-US

  • Begin the sleep effect on my lights .
  • I want you to start wake effect on the lights

es-ES

  • pon la luz de despertarse lentamente durante 45 minutos
  • pon las luces de dormir

fr-FR

  • Allume doucement les lumières .
  • Éteins progressivement les lumières .

hi-IN

  • बेडरूम में धीरे-धीरे रोशनी बढ़ाओ
  • लाइट को स्लीप मोड में डाल दो

it-IT

  • Accendi le luci gradualmente
  • Avvia le luci per dormire

ja-JP

  • ライト を徐々に明るくなる設定にして
  • 照明 を少しずつ暗くして

ko-KR

  • 안방 전등 기상 모드 시작해
  • 조명 에서 수면 모드 실행

nl-NL

  • Dim de lichten langzaam.
  • Laat mijn lamp langzaam feller worden.

pt-BR

  • Acenda lentamente as luzes do quarto por 1 hora .
  • Ativa as luzes de despertar no quarto dos miudos .
  • Iniciar o modo dormir por 1 hora nas luzes do quarto .
  • Liga a função adormecer das luzes .

sv-SE

  • Starta insomningsläge på lamporna
  • Tänd lamporna långsamt

Thiết bị ERRORS

Xem toàn bộ danh sách lỗi và ngoại lệ.