OBS 直播
用你自己的语言直播，观众直接在画面上看到翻译字幕。Whisperr 网页应用实时转写并翻译你的解说，一个透明的叠加层页面以 Browser Source（浏览器源）的形式在 OBS 内渲染字幕——无需插件、无需下载，也不用改动 GPU 编码器设置。叠加层角落还会显示一个小小的二维码：想看其他语言的观众扫一下，就能在手机上用 Whisperr 支持的任意语言同步阅读。
工作原理
- 在 Whisperr 网页应用中开启共享链接并开始广播 —— 这会为你的会话创建一个直播房间
- 生成叠加层 URL，以 Browser Source 的形式添加到 OBS —— 你一开口，翻译字幕就出现在直播画面上
- 观众扫描角落的二维码，在手机上打开房间并选择自己的语言
你需要准备
- 一个 Whisperr 账号，并在 Chrome 中登录网页应用
- OBS Studio（或任何带 Browser Source 的直播软件，比如 Streamlabs）
- 你平时的直播环境 —— Twitch、YouTube Live、Kick，或任何 OBS 能推流的平台
第 1 步 —— 开启共享链接并开始广播
打开网页应用，开始一段新录音：
- 选择你的口述语言，以及要固定烧录到直播画面上的翻译语言
- 选择音频来源 —— 只转写解说就选麦克风音频，想连游戏声音或标签页音频一起转写就选麦克风 + 屏幕
- 打开共享链接，然后开始录音
录音开始后会弹出共享面板，其中有两个标签页：房间（听众可直接加入的链接和二维码）和 OBS（直播用叠加层的设置链接）。
第 2 步 —— 打开叠加层设置页面
在共享面板中点击 OBS 标签页，再点击设置链接旁的打开图标 —— 两处都在下图中用红框标出：
叠加层设置链接的形式如下：
https://whisperr.co/app/overlay/<your-room-id>/choose
设置页面让你无需手动编辑 URL，就能选择直播字幕显示的内容：
第 3 步 —— 选择观众看到的内容并生成 URL
- 翻译 —— 只显示翻译后的字幕（通常选这个）
- 转写 —— 只显示你的原话，作为实时字幕
- 两者 —— 原话在上、翻译在下，类似双语字幕
选择同屏保留的字幕行数，按生成，然后复制 URL：
粘贴到 OBS 的是生成后的 URL，而不是设置页面本身的 URL。设置页面是一个配置界面，把它添加进 OBS 会让配置卡片直接出现在你的直播画面上。
第 4 步 —— 以 Browser Source 形式添加到 OBS
在 OBS 中：
- 在来源中点击 +，选择浏览器
- 把生成的 URL 粘贴到 URL 栏
- 将宽度和高度设置为与画布一致 —— 通常是 1920 × 1080
- 点击确定，然后把该来源放到游戏画面或摄像头图层之上
叠加层背景完全透明 —— 没人说话时，这个来源是不可见的。加载后的第一分钟内会显示一行浅色状态提示（"Whisperr overlay connected — waiting for captions…"，即叠加层已连接、正在等待字幕），方便你在调试时确认它正常工作；第一条字幕出现后状态提示立即消失，也绝不会在直播中途出现。
第 5 步 —— 开播
正常说话即可。字幕会实时出现在直播画面上 —— 一句话尚未说完的部分略显浅色，转写确认后变为正常颜色，说完的行会在你停止说话几秒后淡出。
角落的二维码
烧录进画面的字幕人人可见，但只有一种语言。角落的二维码可以在观众手机上打开你的直播房间，让他们选择自己的语言来阅读，甚至可以用语音朗读来收听。二维码默认开启，下方标注为 "Scan to read in your language"（扫码用你的语言阅读）—— 可通过下面的 URL 参数自定义（例如用 ?qrlabel= 换成适合你观众语言的文案，或用 ?qr=0 移除）。
自定义叠加层
由于 OBS 的浏览器源无法点击，所有选项都是 URL 参数。用 & 追加到生成的 URL 后面：
| 参数 | 默认值 | 作用 |
|---|---|---|
mode | translation | translation（翻译）、transcription（转写）或 both（两者） |
lines | 2 | 同时显示的字幕行数（1–6） |
size | 42 | 字体大小，单位 px（12–120） |
color | ffffff | 文字颜色 —— 不带 # 的十六进制值，或 CSS 颜色名 |
bg | 0 | 每行文字背后的背景不透明度，0–1（0 = 仅文字阴影） |
hold | 8 | 已完成的行在屏幕上停留的秒数（1–60） |
align | bottom | 字幕固定在 bottom（底部）或 top（顶部） |
lang | (all) | 只显示某一种目标语言的翻译，例如 lang=es |
qr | on | qr=0 隐藏角落的二维码 |
qrsize | 132 | 二维码大小，单位 px（64–400） |
qrpos | br | 二维码所在角：br、bl、tr 或 tl |
qrlabel | Scan to read in your language | 二维码下方的说明文字；qrlabel=（留空）则只显示二维码 |
例如，在画面顶部显示更大的黄色字幕，并去掉二维码：
https://whisperr.co/app/overlay/<room-id>?size=56&color=ffcc00&align=top&qr=0
技巧与故障排查
- 来源在 OBS 中什么都不显示 —— 右键点击该 Browser Source，选择刷新当前页面的缓存。如果状态提示一直停在 "connecting…"（连接中）无法连上，请检查网络；如果显示的是 "waiting for captions"（等待字幕），说明叠加层一切正常，只是你的 Whisperr 会话还没有发送语音。
- 每场直播都是新房间 —— 每次录音会话都会生成新的房间 ID，所以开始新直播时要重新生成叠加层 URL，或者整场直播保持同一个 Whisperr 会话不间断运行。
- 免费方案的会话上限为 2 分钟 —— 真正开播时，你需要升级方案，让会话在你直播的全程持续运行。
- 要翻译成多种语言？ 用
lang=把其中一种语言烧录到直播画面上，其他观众用二维码 —— 它正是为此而设计的。