Home Assistant（略称 HA）の「スクリプト (Script)」について、できるだけ分かりやすい言葉で解説し、「映画鑑賞モード」スクリプトの作り方をゼロから丁寧に説明します。
1. やさしい言葉で：スクリプトとは何か？
Home Assistant を頭の良い執事だと考えてみてください。
- デバイス (Device/Entity)：執事が持っている道具で、照明、テレビ、カーテンなどです。
- オートメーション (Automation)：執事に与える絶対命令で、「もし……ならば……」という形式です。たとえば「もし帰宅したら、照明をつける」。これは受動的に発動します。
- スクリプト (Script)：執事に教える一連のコンボ技、またはスキルセットです。
たとえ話：スクリプトは「マクロ」、あるいは「ワンタップマクロ」です。
スクリプトとオートメーションの最大の違い：
- オートメーション：自分で動きます。条件による発動が必要です（時刻、人の在宅など）。
- スクリプト：あなたの指示で動きます。普段は待機していて、あなた（またはオートメーション）が呼び出すと一度だけ実行されます。
2. 2025.12.2 バージョンのスクリプト作成 完全ガイド
定番の「映画鑑賞モード」スクリプトを作ってみましょう。目標：ワンタップで、リビングのメイン照明が消え、テープライトの明るさが30%になり、テレビがつきます。
ステップ1：作成画面を開く
- Home Assistant の Web ページまたはアプリを開きます。
- 左側のメニューで 設定 (Settings) をクリックします。
- オートメーションとシーン (Automations & Scenes) を選択します。
- 上部のタブバーで スクリプト (Scripts) をクリックします。
- 右下の スクリプトを作成 (Create Script) ボタンをクリックします。
- 新しいスクリプトを作成 (Create new script) を選択します。
ステップ2：スクリプトの基本情報を設定する
上部のエディタで：
- 名前 (Name)：映画鑑賞モード と入力します。
- アイコン (Icon)：テレビのアイコン、たとえば mdi:movie-open を選べます。
- モード (Mode)：デフォルトの 単一 (Single) のままで構いません。スクリプト実行中に再度クリックしても反応せず、重複実行の衝突を防げます。
ステップ3：「アクション」を追加する（ここが核心）
スクリプトは一連のアクション (Actions) です。2025.12 ではインターフェースがさらに直感的になりました。
アクション1：リビングのメイン照明を消す
- アクションを追加 (Add Action) ボタンをクリックします。
- 検索ボックスに オフ または turn off と入力します。
- 注意：HA 2025 では「サービスを呼び出す」は「アクションを実行」に改名され、またはデバイスを直接選択できます。
- 最も簡単な方法：デバイス (Device) を直接クリックし、「デバイス」のドロップダウンで リビングのメイン照明 を探します。
- 「アクション」エリアで オフ (Turn off) を選択します。
アクション2：テープライトをつけて暗くする（任意）
- 再度 アクションを追加 (Add Action) をクリックします。
- 今回は「アクション」で検索します：light.turn_on を検索します。
- ライト：オン (Light: Turn on) をクリックします。
- ターゲットを選択 (Choose entity) をクリックし、リビングのテープライト にチェックを入れます。
- 下に詳細パラメータが表示されます。明るさ (Brightness) にチェックを入れ、スライダーを30%まで動かします。
- 任意：色 (Color) にチェックを入れ、暖かい黄色や赤を選びます。
アクション3：テレビをつける
- 再度 アクションを追加 (Add Action) をクリックします。
- デバイス (Device) を選択し、リビングのテレビ を探します。
- アクションとして オン (Turn on) を選択します。
ステップ4：保存とテスト
- 右下の スクリプトを保存 (Save Script) ボタンをクリックします。
- 保存後、右上の 三点アイコン をクリックし、実行 (Run) を選択します。
- 確認：家の照明が消え、テレビがつきましたか？そうなら、おめでとうございます、スクリプトは成功です。
3. このスクリプトはどう使うのか？
スクリプトができたら、どう呼び出しますか？通常は2通りの使い方があります。
使い方A：ダッシュボードに置いて手動で押す
- HA のホームページ（概要）に戻ります。
- 右上の鉛筆アイコンをクリックしてダッシュボードを編集します。
- 右下の カードを追加 をクリックします。
- ボタン (Button) カードを選択します。
- エンティティ (Entity) で script.guan_ying_mo_shi を検索します。これは先ほど作成したスクリプトで、通常は script. に付けた名前のピンインが続きます。
- 保存をクリックします。 これでダッシュボードにスイッチができました。押すだけで家が映画鑑賞モードになります。
使い方B：オートメーションと組み合わせる（自動実行）オートメーションを作成できます：
- トリガー条件：スマートプラグがテレビの消費電力を50W以上と検知したとき（テレビがついた証拠）。
- 実行アクション：アクション (Action) を選択し、script.turn_on を検索し、映画鑑賞モード を選択します。 これで、リモコンでテレビをつけるたびに、HA が自動で照明を整えてくれます。
4. 上級者向けヒント（2025.12 以降向け）
- YAML 構文の変化：コードを読むのが好きな上級者は注意してください。2025 バージョンでは、スクリプトの基盤となる YAML のキー名は複数形の actions: が推奨されています。古い action: もまだ使えますが、新しい標準は複数形です。
- 待機 (Wait)：テレビの起動が遅い場合、「テレビをつける」アクションの後に 指定時間待つ (Wait for time to pass) アクションを追加して5秒に設定し、さらに「カーテンを閉める」アクションを追加します。こうするとスクリプト実行にリズムが出ます。
- 大規模モデルによる支援：2025.12 は AI 連携がより良くなっています。このスクリプトを Assist（音声アシスタント）に公開し、スマホに向かって「ねえ、映画鑑賞モードを起動して」と言えば実行されます。
このチュートリアルが Home Assistant スクリプトの習得に役立てば幸いです。エラーが出る場合は、デバイスエンティティの名前が正しく選ばれているか確認してください。
