直播教程

第一步：安装并打开 OBS Studio

• 前往 OBS Studio 官网下载安装最新版本
• 首次启动时可先跳过自动配置向导，后续再手动调整参数
• 进入主界面后，先确认预览画面和音频电平是否正常显示

第二步：在 VRCLive 获取推流信息

打开 直播 页面并领取推流信息，把 服务器 和 推流码 记下来，稍后分别填入 OBS。

第三步：在 OBS 填写服务器和推流码

• 打开 设置 → 推流
• 服务类型选择 自定义...
• 将直播页里的 服务器 粘贴到 服务器 输入框
• 将直播页里的 推流码 粘贴到 串流密钥 输入框
• 点击 应用 或 确定 保存

第四步：添加画面和声音来源

• 在 来源 中添加 游戏捕获、窗口捕获、显示器捕获 或 媒体源
• 如需麦克风，确认 音频混音器 中的麦克风设备已启用
• 如需桌面声音，确认桌面音频设备有电平变化

第五步：开始直播与观看

• 点击 OBS 主界面的 开始推流
• 浏览器观看建议使用工具箱网页播放器链接
• 如果要在 VRChat 中播放，可使用直播页里的 使用VRChat观看（AVPro） 链接

推荐参数

• 输出模式选择 高级，不要使用简单输出模式
• 编码器优先选择硬件 H.264，码率控制选择 CBR
• 分辨率建议先从 1280x720 开始，帧率建议使用 30 FPS
• 视频码率建议 4500 - 6000 kbps，不要贴近当前服务器上限
• 关键帧间隔设置为 1s 或 2s，推荐先用 2s
• B 帧 设置为 0；关闭 Look-ahead、动态码率和其他会改变帧节奏的增强选项
• 音频使用 AAC，采样率 48 kHz，码率 128 - 192 kbps

第一步：添加自定义浏览器停靠窗口

• 在 OBS 菜单栏打开 停靠窗口 → 自定义浏览器停靠窗口
• 名称可填写 VRCLive
• URL 填写 https://vrclive.top/tools/obs_plugin.html
• 确认后，OBS 主界面会出现包含 开始直播 和 复制链接 的停靠窗口

第二步：开启 OBS WebSocket

• 打开 OBS Studio，进入菜单栏 工具 → WebSocket 服务器设置
• 勾选 启用 WebSocket 服务器
• 确认服务器端口为默认的 4455
• 点击 显示连接信息，复制或记下 服务器密码

第三步：通过停靠窗口开始直播

• 点击停靠窗口里的 开始直播
• 首次使用时输入第二步中复制的 OBS WebSocket 密码；密码会保存在这个停靠窗口的本地存储中，后续无需重复输入
• 插件会自动切换或创建名为 vrclive.top 的 OBS 配置文件，并写入 VRCLive 的服务器地址和推流码
• 如果 OBS 当前尚未推流，插件会自动执行 开始推流

第四步：复制播放链接

• 成功点击 开始直播 后，再点击 复制链接
• 播放链接会复制到剪贴板，可粘贴到浏览器、VRChat 播放器或其他需要观看直播的地方
• 如果提示需要先开始直播，说明停靠窗口还没有获取到本次直播的播放链接，请先点击 开始直播

更换或清除 WebSocket 密码

如果 OBS WebSocket 密码改过，按住 Shift 再点击 开始直播，停靠窗口会清除已保存的密码并要求重新输入。

第一步：下载并启动 VRCLive Studio

• 推荐运行安装包完成安装，再从桌面快捷方式或开始菜单启动
• 临时测试时，也可以直接运行完整解包目录中的 VRCLive Studio.exe
• 不要只复制单个 VRCLive Studio.exe，程序依赖同目录下的 resources、ffmpeg、audio-helper 和 av-helper

第二步：选择开播方式

• 如果想快速开播，开启 自动领取公共推流码
• 程序会在开播前自动填写 服务器地址 和 推流码
• 如果你有自定义 RTMP 地址，也可以在 更多设置 中手动填写服务器和推流码

第三步：选择直播画面

• 当前版本的视频源类型固定为 屏幕
• 视频源 选择要采集的显示器；如果显示器列表变化，可在未推流时刷新后重新选择
• 音频源 可选 无音频 或 桌面音频，常用推荐为 桌面音频

第四步：调整参数后开始直播

• 按需设置分辨率、FPS、码率和编码器，默认建议从 720p / 30 FPS / 2500 kbps 开始
• 点击 开始直播 后，状态通常会依次显示 Ready、Connecting、Streaming
• 结束推流时点击 停止直播，界面会显示 Stopping，随后回到就绪状态

第五步：获取播放链接

• 使用公共推流码成功开播后，界面会显示 播放链接
• 程序会自动复制播放链接，方便粘贴到 VRChat 等支持播放直播链接的环境中
• 如果使用自定义 RTMP 地址，是否能生成播放链接取决于服务端是否提供

视频采集

• 当前版本只开放 屏幕采集
• 支持多显示器选择，最高输出到 1920x1080
• 暂不支持 窗口采集、应用窗口采集 和 摄像头采集

音频采集

• 当前支持 无音频 和 桌面音频
• 支持音频源热切换，正式推流音频仍以桌面系统音频为主
• 暂不支持单独麦克风、单独应用音频和单独窗口音频

分辨率与 FPS

• 支持 1280x720 与 1920x1080
• FPS 可设置为 10 - 60
• 推荐默认从 720p / 30 FPS 开始，网络稳定后再逐步提高

码率建议

• 可设置范围：500 - 5000 kbps
• 720p 建议从 2500 kbps 开始
• 1080p 可根据网络情况适当提高，但建议先确认推流稳定
• 如果画面卡顿、连接不稳或被服务端限制，优先降低码率

编码器

• 支持 NVIDIA NVENC、Intel QSV、AMD AMF、CPU x264
• 推荐优先使用 自动检测 或硬件编码
• 如果硬件编码初始化失败，可回退到其他编码器或尝试 CPU x264

推荐配置

• 稳定直播建议使用 1280x720 / 30 FPS
• OBS 建议使用高级输出模式、CBR、固定关键帧间隔 2s
• 为减少 RTSP 卡顿，建议将 B 帧 设为 0，并关闭 Look-ahead 与动态码率
• 码率建议从 4500 kbps 起步，最高建议不超过 6000 kbps
• 编码器建议使用 自动检测 或硬件 H.264，音频源建议使用 桌面音频

当前音频支持范围

• 正式推流支持 桌面系统音频
• 暂不支持单独选择麦克风推流
• 界面中如果出现应用音频相关选项，当前仍属于即将支持功能

状态与日志

当状态显示为 Error 时，通常代表启动 FFmpeg、连接 RTMP 服务或采集链路过程中出现异常。此时建议先查看调试面板中的 FFmpeg 日志和 helper 状态。

调试面板

• 按 F8 可打开调试面板
• 可查看 FFmpeg 日志、当前运行状态、音视频 helper 状态和同步信息
• 点击 复制调试信息 后，可一键复制当前状态、RTMP 地址、推流码、分辨率、FPS、码率、编码器和最近日志
• 提交问题时建议直接附带复制出的调试信息

只有画面，没有声音

• 确认 音频源 已选择 桌面音频
• 确认系统当前确实有声音输出，且默认输出设备正确
• 如果仍异常，请打开调试面板检查音频 helper 状态

为什么不能选择麦克风

当前版本还没有开放单独麦克风输入控制，音频采集主要面向 桌面系统音频。

为什么没有窗口采集

当前版本的视频采集管线只开放 屏幕采集。窗口采集和应用窗口采集属于后续功能，所以教程页里也不再提供窗口模式指引。

开播时报 RTMP 地址错误

• 确认服务器地址以 rtmp:// 或 rtmps:// 开头
• 确认服务器地址中没有多余空格
• 确认推流码填写完整；如果使用自动领取公共推流码，请确认领取成功

开播后连接失败或很快停止

• 确认网络可以访问目标 RTMP 服务
• 确认推流码没有过期或被占用
• 先尝试降低码率，或更换编码器后重试
• 结合调试面板中的 FFmpeg 日志查看更具体的错误原因

为什么不能只复制 exe 单独运行

VRCLive Studio 依赖同目录下的 resources、ffmpeg.exe、audio-helper、av-helper 和 Electron 运行时文件，所以必须保留完整安装目录或完整解包目录。

公共推流码领取失败怎么办

• 公共推流码数量有限，名额满时需要等待释放
• 停止推流超过 5 分钟后再次开播，程序通常会重新领取公共推流码
• 如果急需开播，也可以切换为手动填写自定义 RTMP 地址

已知限制

• 当前仅支持 Windows
• 当前只开放 屏幕采集，暂不支持窗口采集和摄像头采集
• 不支持单独麦克风输入控制
• 不支持单应用音频推流
• 安装包未启用代码签名，部分系统可能出现安全提示