VAM ゲーム同期
手順：プラグインをインストール → VAM に読み込む → デバイスのポートを選択 → 接続開始 → シーンをテスト。
準備
- VAM が正常に起動する Windows PC と、再生可能なシーン。
- 設置・固定済みのデバイス、専用電源、データ転送対応 USB ケーブル。
- GenijoyApp でデバイスが認識されること。
デバイスの電源を接続してから、USB で PC に接続します。ポートの占有を防ぐため、デバイスに接続中のプレーヤーなどを閉じてください。 COM 番号が分からない場合や PC がデバイスを認識しない場合は、先にポートドライバーのインストールと認識確認を行ってください。画像の COM 番号をそのまま使わないでください。
先に他のソフトの接続を解除する
MultifunPlayer、GenijoyApp、およびシリアルポート経由でデバイスを制御している Web ページや他のソフトを閉じるか、接続を解除してください。同じ COM ポートの占有を防ぎます。
SR3 は付属の 8.4V 電源を接続し、側面のスイッチも入れてください。USB ではサーボに給電できません。SR3 の USB 接続を参照してください。
手順1：プラグインファイルをインストールする
VAM プラグインをダウンロードする
- Genijoy 公式サイトのソフトウェア → PC 用ソフトウェアから VAM プラグインをダウンロードします。
- ダウンロードした ZIP から
Yoooi.ToySerialController.19.varを取り出します。 Yoooi.ToySerialController.19.varを VAM のインストール先のAddonPackagesフォルダーにコピーします。
完了後のフォルダー構成は次のようになります：
VAM/
├── AddonPackages/
└── Yoooi.ToySerialController.19.var手順2：VAM にプラグインを読み込む
編集モードに入り、プラグインの実行を許可する
- VAM を起動してシーンを選びます。左下の **Edit Mode（編集モード）**にチェックを入れるか、E キーを押します。
- **User Preferences（ユーザー設定）→ Security（セキュリティ）**を開き、**Enable Plugins（プラグインの有効化）**のすべての機能が有効になっていることを確認します。
セッションプラグインを追加する
- メニューから **Session Plugins（セッションプラグイン）**を開きます。
- **Add Plugin（プラグイン追加）**をクリックし、続いて **Select File（ファイル選択）**をクリックします。
ToySerialControllerを検索し、該当するパッケージを選択します。- パッケージ内の拡張子が
.cslistのファイルをクリックし、プラグインを読み込みます。 - 読み込みに成功すると、セッションプラグインに
ToySerialControllerが表示されます。右側のボタンをクリックしてカスタム画面を開きます。
初回の読み込み時に実行許可を求められる場合があります。ダウンロードしたプラグインであることを確認してから、原チュートリアルと同様に **Allow Always（常に許可）**を選ぶと、次回から確認を省略できます。
読み込み後はセッションプラグインの一覧に表示されます。赤色の場合は接続開始を繰り返さず、まずエラーログで原因を確認してください。
手順3：ポートを選択して接続する
読み込んだプラグインの設定画面を開き、次の順に操作します：
| 設定 | 選択・入力内容 | 意味 |
|---|---|---|
| 1. Select Output Target | Serial を選択 | PC の USB シリアルポートで指令を送信 |
| 2. Select COM port | 自分のデバイスの COM 番号を選択 | 画像の例ではなく、接続するデバイスを指定 |
| 3. Start Serial | クリックして開始 | シリアル接続を開始。シーンに合わせて動き出す場合があります |
COM 番号の確認
COM 番号が分からない場合や PC がデバイスを認識しない場合は、先にポートドライバーのインストールと認識確認を行ってください。画像の COM 番号をそのまま使わないでください。
ワイヤレス接続
ToySerialController は UDP によるワイヤレス接続にも対応しています。デバイスと PC を同じ LAN に接続し、プラグインの設定で Select Output Target → Udp を選択します。デバイスの IP アドレスを入力してください。既定のポート番号は 8000 です。アドレスの確認方法は SR3 の IP アドレス確認を参照してください。
使用上の注意
- シーンを再生し、デバイスが動きに同期するか確認します。
- 初めてのシーンでは、誰も可動部に触れていない状態で無負荷テストを行い、動作範囲と速度を確認してください。シーンの動きが急に大きくなる場合があります。
- 出力を解除するときは Stop Serial をクリックします。異常な動作があれば直ちにサーボの電源スイッチを切り、その後で設定を確認してください。
- VAM を閉じなければ、シーンを切り替えてもセッションプラグインは保持されます。保持されていても、すべてのシーンが正しく同期するとは限りません。シーンの動作ソースとプラグイン設定が一致している必要があります。
任意：次回起動時にプラグインを自動で読み込む
接続テストに成功したら、セッションプラグインの既定プリセットを保存し、毎回追加する手間を減らせます。
- **Session Plugin Presets（セッションプラグインのプリセット）**を開きます。
- **Change User Defaults（ユーザー既定値の変更）**をクリックします。
- **Set Current As User Defaults（現在の設定をユーザー既定値にする）**を選び、画面の案内に従って保存します。
**プラグインの自動読み込みは、デバイスへの自動接続ではありません。**次回 VAM を起動したら、出力方式と COM ポートを確認して Start Serial をクリックしてください。
よくある問題
プラグインや .cslist ファイルが見つからない
起動中の VAM の AddonPackages フォルダーに .var があるか、検索したバージョン番号がファイルと一致しているかを確認します。同じプラグインを何度もコピーしないでください。読み込めない場合は、VAM のエラーログで読み込みエラーや競合を確認してください。
COM 一覧にデバイスが表示されない
USB ケーブルがデータ転送に対応しているか、デバイスの電源が入っているか、Windows が新しいポートを認識しているかを確認します。ドライバーのガイドに沿って確認した後、プラグインの設定を開き直して一覧を確認してください。
Start Serial をクリックすると赤いエラーが出る
COM 番号を確認し、GenijoyApp など同じデバイスに接続している可能性のあるソフトを閉じます。失敗する場合は、原因を調べるためにエラーログの原文、プラグインのバージョン、COM 番号を控えてください。
接続済みなのにデバイスが動かない
シーンが再生中か、シーンの編集モードを終了しているか、プラグインに動作入力があるか、motion source が正しいか、電源と動作範囲の設定を確認します。SR3 は側面のスイッチと速度が 0% でないかも確認してください。シリアル接続成功は通信が開いたことを示すだけで、シーンが有効な動作指令を生成しているとは限りません。
動作が大きすぎる、速すぎる、または大きく振動する
まず出力を止め、デバイスの動作範囲を小さくして無負荷テストを行います。ToySerialController には平滑化、入力倍率、速度予測などの詳細設定がありますが、多くは Launch 直線動作デバイス向けです。SR3／OSR6 共通の推奨値として使わないでください。
一度に一つの設定だけを変更し、元に戻せるよう変更前の値を控えてください。まず接続と基本動作を確認し、その後で詳細設定を検討します。