vMix 集成
向 vMix 发送实时字幕，用于广播制作。
概览
向 vMix 发送实时字幕，用于广播制作。Maestra 与 vMix 运行在同一台计算机上，并将您的实时字幕发送到 vMix 的标题输入。
开始之前
- 使用 Google Chrome 并将其更新到最新版本。
- 确保 vMix 正在运行且 vMix Web Controller 已启用。
- 在与 vMix 相同的浏览器和同一台计算机上打开 Maestra。
如何设置
- 您必须在运行 Maestra Live 的同一台计算机上运行 vMix。
- 下载此标题模板，该模板将在 vMix 中显示字幕。通过「添加输入」>「标题/XAML」将此标题模板导入 vMix。在「输入选择」窗口的右上角，点击「浏览...」并选择您下载的标题模板文件。点击「确定」。
- 在 vMix 中，前往「设置」>「Web 控制器」，勾选复选框以启用 Web 控制器。
- 设置端口或接受默认值。
- 复制「vMix 网站地址」并粘贴到 Maestra 中。
- 可选：下载 Maestra Companion App，以获得更流畅的体验。安装并运行后，在 vMix 频道设置中启用它，刷新页面，即可在 vMix 中享受字幕功能。
故障排除
如果字幕未能从你的 Maestra 实时会话传送到 vMix，请按顺序完成此检查清单。每一步都会排除一个常见原因，从 Web Controller 设置和 Chrome 网络权限到防火墙、端口以及 vMix 字幕模板。一旦字幕开始在屏幕上更新即可停止。
检查清单
1
确认基本条件
- 在运行 Maestra 的浏览器所在的同一台计算机上运行 vMix Web Controller。
- 确保渠道指向正确的 vMix URL（默认
http://localhost:8088），且字幕标题或模板 GUID 一致。
2
查看 Web Controller 安全选项
- 保持勾选 Allow software on this computer access without login。
- 不要勾选 Enable enhanced security on Web and TCP API。
- 不要勾选 Restrict access to LAN only。
3
在 Chrome 中启用本地网络访问
- 访问
chrome://settings/content/all，然后搜索并选择live.maestra.ai（或使用地址栏的锁形图标，然后选择“网站设置”）。 - 将 Local network access 设置为 Allow，重新加载 Maestra 并重试。
4
检查网络可达性
- 在该计算机上，用任意浏览器打开 Web Controller URL（例如
http://localhost:8088）。 - 如果无法加载或反应迟缓，请先解决该问题：启动 vMix、更正端口并解除防火墙拦截。
5
尝试其他端口
- 如果
8088一直失败，请将 vMix Web Controller 改为未使用的高位端口（例如2025），在 Maestra 中更新 URL 并重新测试。 - 这通常能绕过企业安全过滤器或绑定到常用端口的过期监听器。
6
排除企业或 VPN 拦截
- 临时断开可能禁止 HTTPS 页面访问
http://localhost的 VPN、端点防火墙或杀毒软件。 - 如果字幕开始正常工作，请将 vMix 和浏览器加入白名单，然后重新启用安全工具。
7
验证 vMix 模板
- 在 Title Designer 中，确保 WebCaptionerCaptions 字段存在，且 GUID 与 Maestra 设置一致。
- 在 vMix 中手动编辑该字段，确认它会在屏幕上更新。
8
检查浏览器
- 打开 DevTools，然后切换到 Network 标签页，启用渠道并观察
SetText请求。 - 注意浏览器是否标记了 Mixed Content、Private Network Access 或 CORS，或者请求是否根本没有发出。
9
处理混合内容或专用网络警告
- Chrome、Edge 或 Brave：禁用
chrome://flags/#block-insecure-private-network-requests，然后重启。 - Safari：在测试期间切换“开发”菜单，然后选择 Disable Cross-Origin Restrictions。
- Firefox：将
network.websocket.allowInsecureFromHTTPS设置为 true，并确保已关闭仅 HTTPS 模式。
10
监控结果
- 在字幕运行时保持 DevTools 打开。如果请求看起来成功但文本未更新，请截取 Network 条目和 vMix 预览的屏幕截图。
- 在升级到支持团队之前，收集时间戳、浏览器版本、操作系统以及任何控制台错误。
仍未解决？
如果完成此检查清单后字幕仍未更新，请在应用中打开支持小组件并点击“创建工单”。请注明时间戳、你的浏览器版本、操作系统、vMix 版本以及任何控制台错误。