免费开始开始

vMix 集成

向 vMix 发送实时字幕，用于广播制作。

概览

向 vMix 发送实时字幕，用于广播制作。Maestra 与 vMix 运行在同一台计算机上，并将您的实时字幕发送到 vMix 的标题输入。

开始之前

  • 使用 Google Chrome 并将其更新到最新版本。
  • 确保 vMix 正在运行且 vMix Web Controller 已启用。
  • 在与 vMix 相同的浏览器和同一台计算机上打开 Maestra。

如何设置

  1. 您必须在运行 Maestra Live 的同一台计算机上运行 vMix。
  2. 下载此标题模板，该模板将在 vMix 中显示字幕。通过「添加输入」>「标题/XAML」将此标题模板导入 vMix。在「输入选择」窗口的右上角，点击「浏览...」并选择您下载的标题模板文件。点击「确定」。
  3. 在 vMix 中，前往「设置」>「Web 控制器」，勾选复选框以启用 Web 控制器。
  4. 设置端口或接受默认值。
  5. 复制「vMix 网站地址」并粘贴到 Maestra 中。
  6. 可选：下载 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 版本以及任何控制台错误。