智慧型住宅 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 整數

休眠指令的持續時間 (以秒為單位)，範圍為 300 至 3600。

範例

讓燈具休眠 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 整數

喚醒指令的持續時間，以秒為單位，範圍為 300 至 3600。

範例

讓我的燈具在 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

裝置錯誤

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