HC3 Lua シーン
ユーザーの言語で回答し、識別子は英語のままにします。初心者にはどこをクリックするか説明してください。
シーンかQuickAppか？
| ニーズ | シーン | QuickApp |
|---|---|---|
| イベント（ボタン、ドア、時間、変数）に反応し、いくつかのアクションを実行する | ✅ | 負荷が大きい |
| メモリに状態を保持し、常時実行し、デバイスと通信する（HTTP、TCP、MQTT） | ❌ 毎回ゼロから開始 | ✅ |
| UI内のボタン/ラベル | ❌ | ✅ |
| 経験則：QuickAppはドライバーであり、シーンはQAメソッドを呼び出してアクションを連鎖させます | ||
（fibaro.call(qaId, "setMode", "Away")）。QuickAppについては hc3-quickapp スキルを使用してください。 |
2つの部分
- 宣言（条件/トリガー）：コードではなくLuaのテーブル — シーンがいつ起動するか。
- アクション：各起動時に実行されるLuaコード。 ユーザーへのヒント：ブロックモードでシーンを構築し、「Luaに変換」をクリックしてください。HC3が正確な宣言（プロパティ名、曜日番号）を書き出します。変換は一方向です。
宣言
{
operator = "all", -- "all" (AND) | "any" (OR); グループはネスト可能
conditions = {
{ type = "device", id = 201, property = "value", operator = "==", value = true, isTrigger = true },
{ type = "date", property = "cron", operator = "match", value = {"*", "*", "*", "*", "*", "*"}, isTrigger = false },
}
}
isTrigger = true：この条件の変更がシーンを起動します（その後すべての条件が評価されます）。false：フィルタのみ。少なくとも1つのトリガーが必要です。そうでなければシーンは自動的に起動しません。- 演算子：
==、!=、>、>=、<、<=、anyValue（任意の変更）、match（日付）。 - デバイス条件の
duration = 60：60秒間真の状態が続く必要があります [V]（変換されたブロックシーンで表示されます）。 条件の種類と例：references/declarations.md（デバイス、セントラルシーンボタン、cron、日の出/日の入り、グローバル変数、カスタムイベント、アラーム、ロケーション、天気、HC3起動）。
アクション
fibaro.debug("MyScene", json.encode(sourceTrigger)) -- 開発中の最初の行：何が起動したか確認する
if sourceTrigger.type == "device" then -- .id、.property、.value
elseif sourceTrigger.type == "date" then
elseif sourceTrigger.type == "user" then -- 手動で起動（実行ボタン、アプリ）
end
関数：fibaro.call、fibaro.getValue、fibaro.get（値＋タイムスタンプ）、fibaro.getGlobalVariable / setGlobalVariable（文字列）、fibaro.getSceneVariable / setSceneVariable（同じシーンの実行間で永続化）、fibaro.alert、fibaro.emitCustomEvent、fibaro.scene("execute"|"kill", {ids})、fibaro.profile、fibaro.alarm、fibaro.setTimeout(ms, fn)、api.*、net.HTTPClient、json。ログにはタグが必要です：fibaro.debug("Tag", "msg")。
通知：QuickAppと同じルール（ユーザー vs 電話ID、クリティカルプッシュなし）— hc3-quickapp スキル、references/notifications.md を参照してください。
落とし穴（「シーンが動かない」と答える前に読んでください）
- 実行間でメモリは保持されない → シーン変数またはグローバル変数を使用します。
- 「実行中のシーンの再起動を許可」 オプション：はい＝新しいトリガーが実行中のインスタンスを強制終了し（保留中の
setTimeoutは失われます）、再起動します — 「最後の動きから5分後に消灯」に適しています；いいえ＝実行中（setTimeout待機中も含む）はトリガーが無視されます。 - 手動モードでは宣言は無視されます。
- トリガーは変更時にのみ発火します：同じ値が再び来ても何も起こりません。
- 値の型：スイッチは
true/false、調光器/シャッターは0–99、センサーは数値；グローバル変数は常に文字列です（"1"に等しい、1ではありません）；宣言では引用符なしでvalue = trueと記述します。 - 自身のトリガーデバイスを変更するシーンはループする可能性があります：
sourceTriggerでフィルタリングします。 - デバイスのプロパティのみがシーンをトリガーします；QuickAppの内部変数はトリガーしません（グローバル変数はトリガーし、QAプロパティの更新（
valueなど）はトリガーします）。 while true/ 長いfibaro.sleepは避けてください：トリガー、setTimeout、またはQuickAppを使用します。- cronの曜日番号と一部のプロパティ名は異なる場合があります：変換されたブロックシーンを確認してください [V]。
成果物
宣言ブロック＋アクションブロック（個別に、コピーして貼り付け可能）、設定するシーンオプション（再起動の有無、自動モード、部屋）、置き換えるID（ID_DOOR_SENSOR…）またはユーザーのインベントリからの実際のID、およびテスト手順（「ドアを開けると、シーンのコンソールに…が表示されます」）。実例：references/examples.md。