スマートホーム 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 整数

sleep コマンドの実行時間（秒単位）。

例

ライトを 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 整数

wake コマンドの実行時間（秒単位）。

例

60 分間ライトを起こして。

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

光効果のエミュレーション

デバイスに が実装されている場合は、 Brightness トレイトですが、 LightEffects トレイトの場合、 エミュレートされた「スリープ」モードを「ウェイク」追加のコードは必要ありません。 プラットフォームは一連の EXECUTE インテントを送信することで効果をエミュレートします。

サンプル音声

<ph type="x-smartling-placeholder">

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

デバイスエラー

詳しくは、 エラーと例外をご覧ください。