スクリプトで動的応答を作る（C# で状態保持・分岐）

このページでできること

スクリプト応答の主役は 3 つです。①と②でスクリプトならではの価値を実感でき、③まで行くと自分で書き換える足がかりになります。

• ① 状態保持（State でカウンタ）：READ を送るたびに VAL:1 → VAL:2 → VAL:3 … と毎回違う値が返る。固定値テンプレートでは絶対にできない「前回値を覚えて次を返す」をスクリプトで実現する。
• ② 受信での分岐：PING → PONG、RESET → カウンタを 0 に戻す、未知コマンド → 受信内容をエコー。1 つのスクリプトが受信内容を見て応答を組み立てる。
• ③ 書き換え（構文チェック）：応答文字列やコマンドを自分で書き換え、「構文チェック」で確認してから反映する。

題材プロトコル CounterDev とスクリプト

CounterDev は、本チュートリアル用の小さなテキスト行プロトコルです。クライアントが 1 行のコマンド（末尾 \r\n）を送ると、CommSim 本体の1 つのインライン C# スクリプトが内容に応じて応答を生成します。この 1 台に、あらゆる受信で起動するパケット一致オートメーションが 1 つあり、その送信ステップが Script（スクリプト応答）です。

スクリプト本体（メソッド本体だけを書きます。クラス定義・using は不要）：

// 受信した1行コマンドに応じて動的に応答する（State でカウンタを保持）
var cmd = ReceivedText.Trim();
if (cmd == "PING")  return Utf8("PONG\r\n");
if (cmd == "RESET") { State["seq"] = 0; Log("カウンタをリセットしました"); return Utf8("OK reset\r\n"); }
if (cmd == "READ")
{
    var n = (int)(State.TryGetValue("seq", out var v) ? v! : 0) + 1;
    State["seq"] = n;                 // セッション内で持続（毎回違う値）
    return Utf8($"VAL:{n}\r\n");
}
return Utf8($"ERR unknown:{cmd}\r\n"); // 未知コマンドは受信内容をエコー

用意するもの

これは CommSim.Sample の実行フォルダ内 samples/script-response/ に同梱されています。必要なのは CommSim 本体と CommSim.Sample の 2 本だけで、上流の実機は不要です（CommSim.Sample のクライアント役がアプリ役を演じます）。

ステップ1：スクリプト実行を有効化する（トラスト）

スクリプト応答は既定で無効です。スクリプトを含むプロジェクトを開くと、ウィンドウ上部に確認バナーが出ます。まずこれを有効化します。

1. CommSim 本体で samples/script-response/script-response.commsim を開く（「ファイル」→「ファイルから開く…」／Ctrl+O）。
2. 上部のバナー「このプロジェクトはスクリプトを含みます。実行するには有効化してください」の ［有効化する］ をクリックし、確認ダイアログで承認する。
   （または「プロジェクト」→「プロジェクト設定...」→「スクリプト / プラグイン」タブ →「スクリプト応答を有効にする」をオンにする。）

ステップ2：動かしてカウンタと分岐を見る（すぐ試せる）

1. 「オートメーション」タブを開き、「コマンド応答（スクリプト）」を選んで ［編集］→ 送信データの Script ステップの ［編集…］ でコードを一望する（§題材プロトコルのコードが入っています）。
2. セッション「スクリプト応答スタブ TCP 7400」を「起動」する。
3. CommSim.Sample を起動し、「動かすサンプル」で「スクリプト応答（C# で動的応答・CounterDev）」を選ぶ。① ペインを「接続」（7400 へ接続）して「デモ送信」を押す（READ×3 → PING → RESET → READ → HELLO が順に送られます）。

観察できること

• ◀READ① が送信（1 回目）
• ▶VAL:1カウンタ＝1
• ◀READ① が送信（2 回目）
• ▶VAL:2State で +1 されて 2
• ◀READ① が送信（3 回目）
• ▶VAL:33（毎回違う＝テンプレ不可）
• ◀PING分岐
• ▶PONGPING → PONG
• ◀RESET状態を書き換え
• ▶OK resetカウンタを 0 に
• ◀READRESET 後の READ
• ▶VAL:11 に戻る＝State が効いた証明
• ◀HELLO未知コマンド
• ▶ERR unknown:HELLO受信内容をエコー

ステップ3：スクリプトを少し書き換える

スクリプトは自分で書き換えられます。応答を変えてみましょう。

1. 「オートメーション」タブ →「コマンド応答（スクリプト）」→ ［編集］→ Script ステップの ［編集…］を開く。
2. たとえば READ の応答を return Utf8($"VAL:{n} (count)\r\n"); に変える、PING の応答を "PONG v2\r\n" にする、新しいコマンド if (cmd == "HELLO") return Utf8("HI THERE\r\n"); を READ の前に足す、など。
3. ［構文チェック］を押してエラーが無いことを確認する（OK 表示）。エラーがあれば 行N: 内容 が出ます。
4. ［OK］で保存し、セッションを起動し直してから ① で再度デモ送信して、応答が変わったことを確認する。

自分のケースへの当てはめ方

自分の機器の「動的な応答」を、どう書くかの判断の糸口です。

次に読む

• スクリプト応答 — 使える変数・ヘルパ、コード例、実行時の動作、セキュリティの詳細（記述の正）
• スクリプト応答の編集 — 編集ダイアログの画面項目
• オートメーションを使いこなす — トリガー（パケット一致）と送信ステップ（スクリプトはその一種）
• ← チュートリアル一覧に戻る