智慧型住宅照明效果偏差架構

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, ...]	字串	支援的效果。 支援的值： colorLoop 隨機切換各種顏色。 sleep 逐步降低亮度，並視需求調整一段時間內的色溫。 wake 逐步提高亮度，並視需求調整一段時間內的色溫。

範例

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

{
  "supportedEffects": [
    "colorLoop"
  ]
}

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

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

裝置狀態：STATE

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

州	類型	說明
activeLightEffect	字串	目前使用中的燈光效果 (如果有的話)。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

裝置錯誤：ERRORS

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