Sw8Simulator スタッフ用ガイド — 使い方と AI 利用

SuperMiniS3-SW8 の自動演出を、本体なしでパソコンの上で作って確かめる社内アプリ ／ 版 2026-10-17 ／ スタッフ限定・社外に出さないこと

資料: このページの PDF 版 ／ 編集用 Word 版

0. 動画で見る

公開準備中

使い方ガイド(6 分 01 秒・音声つき・字幕あり)

1. 何のためのアプリか・画面の見方
2. ファイルを開いて Art-Net を出す → レインボー・器具チェイス・ch チェイスを再生
3. 種類・サブ・速度の編集、マスター・器具数・暗転、パレットと季節パレット
4. 保存と本体への取込・書戻(画面で説明)・AI から使う

動画では SW8 本体を繋いでいません。Art-Net は同じパソコンの中(127.0.0.1)だけに送り、ArtNetMonitorM5 で受けて表示しています。照明には何も出していません。本体への取込・書戻は画面で説明しています。読み込んだのは動画のために作った試験用の設定ファイルです。操作はすべて HTTP の窓口(127.0.0.1)から行い、マウスは使っていません。音声: VOICEVOX:No.7

1. 何のアプリか

8 個のスイッチで自動演出の DMX を出す M5 の機器 SuperMiniS3-SW8(以下 SW8 本体)の「自動演出」を、本体なしで Windows の上で動かすアプリです。本体のファームの演出の計算(フェードの進み方・色の決め方・チェイス)を C# にそのまま移してあるので、本体と同じ光り方を画面で見ながら、仕込みの段階で演出を作り込めます。

• 演出 1〜8 を、種類・サブ・速度で作る。▶ で再生。
• マスター・速度・器具数、パレット 8 色(RGBW)と季節パレット 10 通り。
• モニタで器具の見た目と 512 チャンネルの値を見る。Art-Net でも送り出せる。
• 設定は sw8_setup_*.json(本体の書き出しと同じ形)。本体から取込・本体へ書戻ができる。
• AI から操作できる(11 章)。

2. 起動と設定

スタートメニューの「Sw8Simulator」を開きます。

• 窓の位置・大きさ、最後のフォルダ、機体 IP、Art-Net の宛先・Universe・fps、灯 ch 幅、実機連動、モニタ別窓の位置、区切りの位置、再生中の演出は config.json(exe と同じフォルダ)に覚えます。
• 編集中の中身(保存していない分も)は閉じるときに last_session.json に書き、次に開くと続きから始まります。
• Art-Net 出力の ON/OFF も覚えます。ON のまま閉じると、次に開いたときも出し始めます。
• Art-Net の既定は宛先 127.0.0.1(この PC の中)・Universe 0・33 fps です。
• Windows のダーク／ライトに合わせて色が変わります。

3. 画面の見方

4. ファイルを開いて Art-Net を出す

1. フォルダに設定ファイルの置き場所を入れて 更新(または 参照)。一覧が出ます。
2. 一覧のファイルを選ぶと読み込み、演出プリセットの中身が入れ替わります。
3. 宛先・Uni・fps を確かめて Art-Net 出力 ON。毎回 512 チャンネルを送ります。値はマスターをかけた後の値です。

5. 演出の種類と再生

各行の ▶ でその演出を再生します(緑が再生中)。再生すると、その演出の速度が「速度」のつまみに入り、演出ON に戻ります。

6. 演出を作る(種類・サブ・速度)

• 種類を変えると、サブは先頭に戻ります。サブの中身は種類ごとに変わります。
• 速度は 0〜99 で、数字が大きいほどゆっくりです(本体と同じ)。0〜9 は色がパッと切り替わり、10 以上はなめらかにフェードします。
• 再生中の演出を直すと、その場でモニタと Art-Net に出ます。
• グローバルの「速度」つまみは、再生中の演出の速さを変えます(ファイルの speed に入ります)。

7. マスター・器具数・暗転

• マスター(0〜255)は、出している値すべてをその割合で下げます。Art-Net にもマスターをかけた後の値が出ます。
• 器具数(1〜128)は、レインボー・器具チェイスの台数です(1 台 4 ch)。モニタの器具の数も変わります。
• 灯 ch 幅(1〜4)はモニタの見え方だけを変えます(1 灯を何 ch として色にするか)。出力は変わりません。
• 演出ON を外すと暗転です。512 ch すべて 0 になり、Art-Net は 0 を送り続けます。

8. パレットと季節パレット

• パレットの色を選び、下の R・G・B・W(0〜255)で直します。種類「パレット」の演出がこの 8 色を巡ります。
• 季節パレットのボタンで、8 色をまとめて入れ替えます。演出の色もすぐ変わります。
• 実機連動に印があると、季節パレットのボタンが本体にも同じ季節を送ります(/api/season)。

9. 保存と本体への取込・書戻

10. 困ったとき

11. AI から使う

Sw8Simulator は、AI(Claude Code など)が HTTP の窓口から読み取り・操作できます(2026-10-17 追加)。動画の操作もすべてこの方法で行っています。127.0.0.1 の 55720 番だけで受けます(使用中なら 55721〜55725。実際の番号は状態の行と status.json の httpPort。認証なし)。

本体への取込・書戻・実機連動の季節と、ファイルの保存・削除は、この窓口からはできません(画面のボタンで人が行う)。/status と / 以外は POST です。curl では本文が空でも -d "" を付けます(付けないと 411 で断られる)。

curl -s http://127.0.0.1:55720/status
curl -s -X POST -d "" "http://127.0.0.1:55720/load?name=sw8_setup_demo_02_show.json"
curl -s -X POST -d "" "http://127.0.0.1:55720/artnet?target=127.0.0.1&universe=0&on=1"
curl -s -X POST -d "" "http://127.0.0.1:55720/preset?n=1&type=1&sub=1&speed=15"
curl -s -X POST -d "" "http://127.0.0.1:55720/recall?n=1"

失敗は {"ok":false,"error":"…"}(400/404/405)で返り、画面に小窓は出ません。成功は {"ok":true,"did":"…","status":{…}}。

状態ファイル

e:\tmp\ai_sw8\ に約 1 秒ごとに書き出します。AI はこれを読むだけで、何を再生していて Art-Net に何を出しているかが分かります。

• latest.txt — ファイル・再生中の演出・マスター/速度/器具数・Art-Net・HTTP の番号・先頭 16 ch(16 進)
• status.json — 同じ内容を JSON で(httpPort を含む)
• README_AI.txt — 読み方

AI への頼み方の例

• 「Sw8Simulator で今どの演出を出しているか、状態ファイルを見て教えて」
• 「演出 3 をレインボーの 2回転・速度 20 にして再生して。Art-Net は 127.0.0.1 の Universe 0 へ」
• 「季節パレットをハロウィンにして、演出 4 を再生して」

止まっているときや再ビルドは、AI が tools/restart_app.ps1 -AppName Sw8Simulator で強制停止 → ビルド → 起動できます(開発担当の作業です)。

Sw8Simulator 2026-10-17 ／ スタッフ限定。図と動画の画面は、SW8 本体を繋がず、Art-Net を 127.0.0.1 にだけ送って撮った画面です(図は動画と同じ窓・同じ状態を作り直して撮ったもの)。概要は同じフォルダの OVERVIEW.md。