智慧型住宅 LightEffects 特徵結構定義

action.devices.traits.LightEffects：這個特徵屬於可支援複雜照明指令的裝置，可用於變更狀態，例如循環播放各種顏色。

裝置屬性

具備此特徵的裝置可能會在 SYNC 作業中回報下列屬性。如要進一步瞭解如何處理 SYNC 意圖，請參閱「意圖執行要求」。

屬性 類型 說明
defaultColorLoopDuration 整數

(預設值：1800)

由 action.devices.commands.ColorLoop 指令觸發的效果預設時間長度 (以秒為單位)。
defaultSleepDuration 整數

(預設值：1800)

由 action.devices.commands.Sleep 指令觸發的效果預設時間長度 (以秒為單位)。
defaultWakeDuration 整數

(預設值：1800)

由 action.devices.commands.Wake 指令觸發的效果預設時間長度 (以秒為單位)。
supportedEffects 陣列

必填。

裝置支援的特效清單。
[item, ...] String

支援的特效。

支援的值：

colorLoop
隨機循環顯示各種顏色。
sleep
逐漸降低亮度，並視需要在一段時間內調整色溫。
wake
逐漸調高亮度，並視需要在一段時間內調整色溫。

範例

支援色彩循環效果的裝置。

{
  "supportedEffects": [
    "colorLoop"
  ]
}

支援睡眠/喚醒特效的裝置。

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

裝置狀態

具有此特徵的實體可能會在 QUERY 作業中回報下列狀態。如要進一步瞭解如何處理 QUERY 意圖，請參閱「意圖執行要求」。

州 類型 說明
activeLightEffect String

目前啟用的燈光效果 (如有)。supportedEffects 其中之一。

支援的值：

colorLoop
sleep
wake
lightEffectEndUnixTimestampSec 整數

預期效果結束的 Unix 時間戳記 (如果效果會自行結束)。

範例

這對裝置目前有何影響？

{
  "activeLightEffect": "colorLoop"
}

這對裝置目前有何影響？

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

目前沒有任何燈光效果。

{}

裝置指令

具備此特徵的裝置可能會在 EXECUTE 作業中回應下列指令。如要進一步瞭解如何處理 EXECUTE 意圖，請參閱「意圖執行要求」。

action.devices.commands.ColorLoop

要求裝置循環瀏覽一組顏色。

這個指令需要下列屬性：
{
  "supportedEffects": [
    "colorLoop"
  ]
}

參數

參數 類型 說明
duration 整數

色彩循環指令的時間長度，以秒為單位。

範例

讓燈光以 60 分鐘的速度循環變色。

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

action.devices.commands.Sleep

逐漸調低裝置的亮度，並視需要在一段時間內調整色溫。

這個指令需要下列屬性：
{
  "supportedEffects": [
    "sleep"
  ]
}

參數

參數 類型 說明
duration 整數

休眠指令的時間長度，以秒為單位。

範例

讓燈休眠 60 分鐘。

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

action.devices.commands.StopEffect

停止目前的燈光效果。

參數

參數 類型 說明

沒有任何屬性

範例

停止使用燈光效果。

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

action.devices.commands.Wake

逐漸調高裝置亮度，並視需要在一段時間內調整色溫。

這個指令需要下列屬性：
{
  "supportedEffects": [
    "wake"
  ]
}

參數

參數 類型 說明
duration 整數

喚醒指令的時間長度，以秒為單位。

範例

讓我的燈具喚醒 60 分鐘。

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

燈光效果模擬

如果裝置實作 Brightness 特徵，但未實作 LightEffects 特徵，平台就會支援模擬的「睡眠」和「喚醒」效果，而不需要額外的程式碼。平台會傳送一系列 EXECUTE 意圖來模擬效果。

範例句子

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

裝置錯誤

請參閱錯誤和例外狀況的完整清單。