Genijoy 教程中心

简体中文

English
日本語

简体中文

English
日本語

切换主题

VAM游戏同步教程 ​

操作顺序：安装插件 → 在 VAM 中加载 → 选择设备端口 → 启动连接 → 测试场景。

开始前准备 ​

  • 已能正常启动 VAM 的 Windows 电脑，以及可播放的场景。
  • 已安装固定的设备、设备配套电源，以及可传输数据的 USB 线。
  • GenijoyApp中能够识别出设备。

先给设备接好电源，再用 USB 线连接电脑,关闭正在连接设备的播放器等软件，避免它们占用端口。 不会查看 COM 编号，或电脑没有识别设备时，先完成端口驱动安装与识别检查。不要照抄截图里的 COM 编号。

先释放设备连接

关闭或断开 MultifunPlayer、GenijoyApp，以及正在通过串口控制设备的网页或其他程序，避免它们占用同一个 COM 端口。

SR3 用户还需接好随附的 8.4V 电源并打开侧面开关，USB 不能为舵机供电。详见 SR3 USB 连接。

第一步：安装插件文件 ​

下载VAM插件 ​

  1. 访问 Genijoy 官网，在“软件 → PC 端软件”中下载“VAM插件”。
  2. 从下载到的Zip包中解压出插件Yoooi.ToySerialController.19.var。
  3. 将Yoooi.ToySerialController.19.var拷贝至VAM安装目录下的 AddonPackages 文件夹中。

完成后，目录应类似：

text
VAM/
├── AddonPackages/
    └── Yoooi.ToySerialController.19.var
100%
第一步
滚轮或双指缩放 · 拖动平移 · 双击重置 · Esc 关闭 打开原图

第二步：在 VAM 中加载插件 ​

进入编辑模式并允许插件运行 ​

  1. 启动 VAM，选择一个场景。勾选左下角 Edit Mode（编辑模式），或按 E。
  2. 打开 User Preferences（用户偏好）→ Security（安全），确认 Enable Plugins（启用插件） 下的所有功能都启用。
100%
VAM 用户偏好的 Security 页面及 Enable Plugins 选项
滚轮或双指缩放 · 拖动平移 · 双击重置 · Esc 关闭 打开原图

添加会话插件 ​

  1. 打开菜单中的 Session Plugins（会话插件）。
  2. 点击 Add Plugin（添加插件），再点击 Select File（选择文件）。
  3. 搜索 ToySerialController，选择对应的插件包。
  4. 点击包内的 **.cslist**后缀文件，开始加载插件。
  5. 加载插件成功后，会话插件会出现名为 ToySerialController的插件包，此时点击右边的打开自定义界面。

首次加载可能出现插件运行许可提示。确认来源是刚才下载的插件后，可按原教程选择 Allow Always（始终允许），以后加载该插件时不再重复询问。

加载完成后，插件应出现在会话插件列表中。若显示红色，先打开错误日志查看原因，不要继续反复启动连接。

100%
第一步
滚轮或双指缩放 · 拖动平移 · 双击重置 · Esc 关闭 打开原图

第三步：选择端口并启动连接 ​

打开刚加载的插件的设置界面，依次操作：

设置如何填写含义
1. Select Output Target选择 Serial使用电脑的 USB 串口发送指令
2. Select COM port选择自己设备的 COM 编号指定要连接的设备，不是选截图里的示例编号
3. Start Serial点击启动开始串口连接，设备可能随场景动作开始运动

COM编号查询

不会查看 COM 编号，或电脑没有识别设备时，先完成端口驱动安装与识别检查。不要照抄截图里的 COM 编号。

无线连接

ToySerialController同样支持使用UDP网络协议进行无线连接。确保设备和PC处于同一局域网下，然后在插件的设置界面依次选择Select Output Target-> Udp。 然后填入设备的IP地址，端口号默认8000。IP地址查询详见 SR3 IP地址查询。

注意事项

  1. 播放场景，观察设备是否跟随动作运行。
  2. 第一次使用某个场景时，先在无人接触运动部件的情况下完成空载测试，检查动作幅度和速度。场景中的动作可能突然变大。
  3. 需要断开插件输出时，点击插件中的 Stop Serial。若动作异常，立即关闭设备的舵机电源开关，再排查设置。
  4. 只要没有关闭 VAM，会话插件可在切换场景后继续保留。保留插件不代表每个场景都一定能正确同步：场景动作来源和插件设置仍需匹配。
100%
第一步
滚轮或双指缩放 · 拖动平移 · 双击重置 · Esc 关闭 打开原图

可选：下次启动时自动加载插件 ​

连接测试成功后，可以保存会话插件默认预设，减少每次重新添加插件的操作。

  1. 打开 Session Plugin Presets（会话插件预设）。
  2. 点击 Change User Defaults（修改用户默认设置）。
  3. 选择 Set Current As User Defaults（将当前配置设为用户默认），按提示完成保存。

**自动加载插件不等于自动连接设备。**下次启动 VAM 后，仍需确认输出方式和 COM 端口，再点击 Start Serial。

常见问题 ​

搜不到插件，或找不到 .cslist 文件 ​

先检查 .var 文件是否在当前启动的 VAM 的 AddonPackages 文件夹中，搜索的版本号是否与文件一致。不要把同一个插件重复复制多份。若仍无法加载，查看 VAM 错误日志，检查是否存在加载失败或插件冲突。

COM 列表里没有设备 ​

检查 USB 线是否支持数据传输、设备是否通电，以及 Windows 是否识别到新端口。按端口驱动教程完成检查后，再重新打开插件设置查看端口列表。

点击 Start Serial 后出现红色错误 ​

确认 COM 编号正确，并关闭 GenijoyApp 等可能正在连接同一设备的软件。若仍失败，记录错误日志原文、插件版本和 COM 编号，便于定位问题。

显示连接成功，但设备没有动作 ​

检查场景是否正在播放、是否已经退出场景编辑模式、插件是否有动作输入，插件的motion source是否选择正确，以及设备的供电和行程设置。SR3 还需检查侧面电源开关和速度是否为 0%。串口连接成功只说明通信入口已打开，不代表场景已经产生有效动作。

动作太大、太快，或明显抖动 ​

先停止输出，缩小设备的运动范围，再空载测试。ToySerialController包含平滑度、输入倍数和速度预测等高级参数，其中不少针对 Launch 线性设备，不要直接作为 SR3／OSR6 的通用推荐值。

调整时一次只修改一项，并记下原值，便于恢复；先保证连接和基础动作正确，再考虑高级参数。

返回电脑游戏联动，或查看其他游戏联动教程。

Genijoy 设备使用与技术支持