# 抖音直播伴侣连接指南

更新时间：2026-06-11

本文档适用于 YOUNGKIT 数字人直播建播系统 V5。当前第二优先级：直播伴侣承接。

当前目标是先稳定跑通：

```text
YOUNGKIT Program Output -> OBS / 抖音直播伴侣采集 -> 开播测试
```

本阶段不接真实抖音接口，不抓包、不逆向、不私接推流码。不要优先开发 RTMP，除非后续拿到明确官方推流能力或平台授权。

实机联调时请同时参考：

```text
docs/OBS与抖音直播伴侣实机联调检查清单.md
```

本机预检脚本：

```bash
python scripts/obs_companion_preflight_check.py --json --url http://127.0.0.1:8765/program-output.html
```

当前推荐路线：

```text
Program Output -> OBS 窗口采集 -> OBS Virtual Camera -> 抖音直播伴侣
```

备选路线：

```text
Program Output -> 抖音直播伴侣直接窗口采集
```

说明：直播伴侣覆盖电商直播、虚拟直播等场景；更高级的插件 / 素材通道能力只作为后续官方插件方式预留，当前不做非公开接口、不做逆向和私接推流码。

## 一、推荐方式：OBS 窗口采集

推荐链路：

```text
YOUNGKIT Program Output -> OBS 窗口采集 -> OBS Virtual Camera -> 抖音直播伴侣
```

操作步骤：

1. 打开 YOUNGKIT 播控软件。
2. 进入播控台。
3. 点击打开 Program Output。
4. 打开 OBS。
5. OBS 添加“窗口采集”，选择 Program Output 浏览器窗口。
6. OBS 设置基础画布为 `1080x1920`，竖屏模式以 1080 宽度作为上屏画布基准。
7. OBS 调整窗口采集源铺满画布。
8. OBS 启动虚拟摄像头。
9. 打开抖音直播伴侣。
10. 选择 OBS Virtual Camera。
11. 配置音频输入。
12. 检查画面、字幕、商品卡、声音。
13. 开播。

建议检查点：

- Program Output 画面必须是竖屏 9:16。
- OBS 画布建议设置为 `1080x1920`，保持竖屏模式以 1080 宽度作为上屏画布基准。
- 采集画面不要出现后台菜单、按钮、日志和浏览器控制台。
- 画面中必须常驻“AI数字人主播”标识。

## 二、备选方式：直播伴侣直接窗口采集

如果暂时不使用 OBS，也可以让抖音直播伴侣直接采集 Program Output 窗口。

操作步骤：

1. 打开 Program Output。
2. 直播伴侣添加窗口源。
3. 选择 Program Output。
4. 配置音频。
5. 开播。

注意：直接窗口采集的可控性通常不如 OBS。OBS 更方便统一处理画布尺寸、源缩放、虚拟摄像头和后续多素材组合。

## 三、声音说明

1. OBS 采集画面不代表一定采集声音。
2. 如果 Program Output 播放音频，要确认直播伴侣采集到了系统声音。
3. 可使用系统声音采集、虚拟声卡或直播伴侣音频输入配置。
4. 第一版 V4-1 重点先验证画面输出，音频在 V4-2 完善。
5. `OBS Virtual Camera` 主要承接视频画面，音频必须在 OBS 混音器、系统声音、虚拟声卡或直播伴侣音频输入里单独确认。

声音排查建议：

- 先确认 Program Output 浏览器窗口本身能听到声音。
- 再确认 OBS 的音频混音器里有音量跳动。
- 如果使用 OBS Virtual Camera，仍需要单独确认抖音直播伴侣的音频输入来源。
- 如果直播伴侣没有采集到系统声音，可以改用系统声音采集、虚拟声卡或直播伴侣内置音频输入。
- 如果出现回声，检查是否同时采集了系统声音、OBS 监听输出和麦克风，避免多路重复。

## 四、安全和合规

1. 不抓包推流码。
2. 不逆向直播伴侣。
3. 不使用非公开接口。
4. 不绕过平台风控。
5. 直播画面必须显示 AI数字人主播。
6. 不要优先开发 RTMP，RTMP 官方能力评估不等于当前开发路线。

合规要求：

- 只使用本人或已授权的人像、声音、动作视频和话术。
- 不允许伪装真人直播。
- 不允许隐藏“AI数字人主播”标识。
- 抖音、小红书、视频号等平台能力只能走官方接口或合规授权服务。
- 直播伴侣插件、素材通道和音视频数据推送只能在官方文档、官方授权和平台规则允许时接入；当前仅做后续官方插件方式预留。