安装 · 连接 · 排障 · 开发者

文档

从你此刻要完成的任务出发,按最短路径找到答案。

01 · 安装

先把两端准备好

Windows

  1. 社区版从 GitHub Releases 下载;官方版从爱发电交付页下载
  2. 首次安装已内置 .NET 运行时;需要虚拟麦克风时按提示安装 VB-CABLE
  3. 官方版发现更新后先下载并校验,确认重启时仅请求一次 UAC
  4. 新版启动健康检查失败会自动回滚;跨度过大时改用完整 Setup

Android

  1. 社区版从 GitHub Releases 下载;官方版从爱发电交付页下载 APK
  2. 首次安装或更新时,按 Android 提示允许本来源安装未知应用
  3. 下载完成后由系统安装界面确认;同包名且签名一致时保留应用数据
  4. 打开应用,默认「在家」链路自动发现电脑

02 · 连接

按环境选择路线

LAN在家 · 局域网即开即用,无需任何配置。
Wi-Fi Direct万能 · 扫码直连没有 Wi-Fi / 路由器 AP 隔离时也能用。
Bluetooth经典 · 蓝牙适合近距离、低带宽场景。
USB有线 · USB延迟最低、最稳定。

连接前五项确认

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

03 · 排障

常见问题

声音与连接

推流后电脑没有声音?

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

虚拟麦克风怎么启用?

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

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

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

推流中切换链路会断吗?

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

版本与开发

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

应用层核心源码始终按 GPLv3 开源。社区版可从 GitHub 自行下载或构建、无官方自动更新;官方版通过爱发电交付,收费内容是官方打包、闭源国内自动更新工具与持续维护,不是核心功能解锁。

可以二次开发吗?

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

更新与恢复

Windows 官方版如何更新和回滚?

发现新版本后会弹窗说明版本、大小与更新原因。增量包或完整 Setup 下载并校验成功后,由你确认重启;更新助手仅在替换程序时请求一次 UAC。新版未通过启动健康检查会自动回滚到上一版,现有数据不会因此删除。

Android 官方版如何更新?

应用下载并校验完整 APK 后打开 Android 系统安装界面。首次需允许墨堤安装未知来源应用;包名和签名一致的覆盖安装会保留数据。若提示签名不一致,请停止安装并从爱发电重新下载官方包。

提示 UPDATE_AUTH_REJECTED 怎么办?

这表示官方国内更新通道凭据已失效。自动更新会停止,但现有功能不受影响,你可以继续使用当前版本;从爱发电或官网入口重新下载官方版即可恢复后续更新。

更新失败时需要提交什么?

先保留界面显示的错误码和版本号,再从 Windows「关于」页导出脱敏日志。不要上传安装凭据、密钥、完整用户目录或未经脱敏的原始日志。

04 · 开发者

应用开放,协议边界明确

应用层 GPL-3.0;MoDi Protocol 0.1.1 为专有冻结版本,协议仓库与规范面向受邀开发者。
查看 GitHub 源码查看发行包
返回顶部 ↑