安装 · 连接 · FAQ · 开发者

文档

过桥之前,先看一眼水路。这里收着安装、连接与排障的全部指引。

常见问题

推流后电脑没有声音?

确认电脑端状态灯为绿色(已连接)。扬声器路线直接出声;虚拟麦克风路线需在目标软件中选择 CABLE Output 作为输入设备。若仍无声,检查手机端音量与媒体音量。

虚拟麦克风怎么启用?

Windows 安装时勾选运行 VB-CABLE 引导(官方渠道静默安装),完成后系统会出现 CABLE Output 设备。选择「虚拟麦克风」或「整活通道」路线即可使用。

没有路由器 / 被 AP 隔离,怎么连?

使用「万能」链路:电脑端显示二维码,手机扫码通过 Wi-Fi Direct 点对点直连,不依赖路由器。

推流中切换链路会断吗?

应用会自动先断开旧链路再建立新链路,切换期间状态灯黄灯(握手中),完成后绿灯——声音不会丢。

社区版和官方版有什么区别?

功能主体一致。社区版源码开放(GPL-3.0)、无自动更新入口;官方版提供自动更新与增值服务,渠道筹备中。

可以二次开发吗?

可以。社区版源码在 GitHub(DSGYDS/MoDi-Connect)开放,遵循 GPL-3.0 许可。协议二进制按 BINARY-REDISTRIBUTION-GRANT 条款使用。

连接排查清单

依次确认,五步过桥
  1. 手机与电脑选择了相同的链路方式。
  2. 局域网模式下,两台设备处于可互通的网络中。
  3. 电脑防火墙允许音频端口 12345 与握手端口 12347。
  4. 使用虚拟麦克风路线时,目标软件选择了 CABLE Output 作为输入设备。
  5. 在「设置」中查看四条链路的实时状态与本机地址。

如需提交问题,可先在「关于」页导出脱敏日志——日志会移除配对凭据、IP 地址和用户目录,再生成可分享的压缩包。

开发者资料

社区版源码(GitHub · GPL-3.0) 安装包下载(GitHub Releases)MoDi Protocol 0.1.1 规范(开发者文档见协议仓库,受邀制)