录播姬设置
设置项
房间号
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
RoomId | 房间单独设置 | 数字 (int32) |
自动录制
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
AutoRecord | 房间单独设置 | 布尔值 (boolean) |
录制模式
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
RecordMode | 全局设置和单独设置 | 枚举 (enum) |
默认值：RecordMode.Standard
| 键 | 值 | 含义 |
|---|---|---|
RecordMode.Standard | 0 | 标准模式 |
RecordMode.RawData | 1 | 原始数据模式 |
关于录制模式的说明见 录制模式
自动分段模式
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
CuttingMode | 全局设置和单独设置 | 枚举 (enum) |
默认值：CuttingMode.Disabled
| 键 | 值 | 含义 |
|---|---|---|
CuttingMode.Disabled | 0 | 不分段 |
CuttingMode.ByTime | 1 | 按视频时长分段 |
CuttingMode.BySize | 2 | 按文件大小分段 |
自动分段数值
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
CuttingNumber | 全局设置和单独设置 | 无符号数字 (uint32) |
默认值：100
根据 CuttingMode 设置的不同：
当按时长分段时，本设置的单位为分钟。
当按大小分段时，本设置的单位为 MiB。
改标题后自动分段
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
CuttingByTitle | 全局设置和单独设置 | 布尔值 (boolean) |
默认值：false
弹幕录制
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
RecordDanmaku | 全局设置和单独设置 | 布尔值 (boolean) |
默认值：false
是否录制弹幕，true 为录制，false 为不录制。
本设置同时是所有“弹幕录制”的总开关，当本设置为 false 时其他所有“弹幕录制”设置无效，不会写入弹幕 XML 文件。
弹幕录制-原始数据
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
RecordDanmakuRaw | 全局设置和单独设置 | 布尔值 (boolean) |
默认值：false
是否记录原始 JSON 数据。
弹幕原始数据会保存到 XML 文件每一条弹幕数据的 raw attribute 上。 当 RecordDanmaku 为 false 时本项设置无效。
弹幕录制-SuperChat
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
RecordDanmakuSuperChat | 全局设置和单独设置 | 布尔值 (boolean) |
默认值：true
是否记录 SuperChat。 当 RecordDanmaku 为 false 时本项设置无效。
弹幕录制-礼物
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
RecordDanmakuGift | 全局设置和单独设置 | 布尔值 (boolean) |
默认值：false
是否记录礼物。 当 RecordDanmaku 为 false 时本项设置无效。
弹幕录制-上船
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
RecordDanmakuGuard | 全局设置和单独设置 | 布尔值 (boolean) |
默认值：true
是否记录上船（购买舰长）。 当 RecordDanmaku 为 false 时本项设置无效。
保存直播封面
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
SaveStreamCover | 全局设置和单独设置 | 布尔值 (boolean) |
默认值：false
直播画质
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
RecordingQuality | 全局设置和单独设置 | 字符串 (string) |
默认值：avc10000,hevc10000
录制的视频编码格式和直播画质 qn 值，以英文逗号分割，靠前的优先。
编码格式支持 avc 和 hevc 两种。
注意：
- 所有主播刚开播时都是只有“原画”的，如果选择不录原画会导致直播开头漏录。
- 如果设置的录制画质里没有原画，但是主播只有原画画质，会导致不能录制直播。
- 录播姬不会为了切换录制的画质主动断开录制。
- 这个设置项 不是录制码率 。
- 这个设置项也不是录制分辨率、录制帧率。
| 画质名字 | qn 值 |
|---|---|
| 杜比 | 30000 |
| 原画真彩 2K 原画 2K 原画 高帧率 | 25000 |
| 4K | 20000 |
| 2K | 15000 |
| 原画 1080P 高码率 1080P 高码率 高帧率 | 10000 |
| 蓝光 1080P 蓝光 | 400 |
| 超清 720P 超清 | 250 |
| 高清 | 150 |
| 流畅 | 80 |
录制文件名模板
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
FileNameRecordTemplate | 仅全局设置 | 字符串 (string) |
默认值：
{{ roomId }}-{{ name }}/录制-{{ roomId }}-{{ "now" | time_zone: "Asia/Shanghai" | format_date: "yyyyMMdd-HHmmss-fff" }}-{{ title }}.flv请参考文件名模板页面。
FLV修复-检测到可能缺少数据时分段
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
FlvProcessorSplitOnScriptTag | 全局设置和单独设置 | 布尔值 (boolean) |
默认值：false
这个设置项是在录播姬 2.1.0 添加的。默认是关闭。2.0.0 以及之前的版本相当于这个设置是开启状态。
直播服务器有时会多次发送本应只在直播流最开头发送一次的 metadata 信息，同时在这前后可能会有重复的直播数据，或者缺少直播数据。录播姬会检测完全一致的重复数据并删除。 造成这个问题的原因可能是直播服务器与它上一级直播服务器的连接断开了。主播连麦 PK、主播直播软件断开重连也可能会导致直播服务器多次发送 metadata 信息。
当这个设置项设置为 开启 状态时，收到 metadata 信息后会对录播文件分段。2.0.0 及更早的版本也是这个行为。
当这个设置项设置为 关闭 状态时，收到 metadata 信息后会在当前录播文件同名的一个 txt 文件里记录当前视频时间等信息，不会分段。
请注意遇到这个问题的位置可能会缺少几秒直播画面，可以根据你自己对录播文件的用法来决定是分开更方便后期处理、还是合并在一起更方便后期处理。
FLV修复-检测到 H264 Annex-B 时禁用修复分段
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
FlvProcessorDisableSplitOnH264AnnexB | 全局设置和单独设置 | 布尔值 (boolean) |
默认值：false
是否在视频文件写入直播信息 metadata
此设置是 高级设置
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
FlvWriteMetadata | 仅全局设置 | 布尔值 (boolean) |
默认值：true
不录制的标题匹配正则
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
TitleFilterPatterns | 全局设置和单独设置 | 字符串 (string) |
默认值：空字符串
WebhookV1
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
WebHookUrls | 仅全局设置 | 字符串 (string) |
默认值：空字符串
请参考Webhook页面。
WebhookV2
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
WebHookUrlsV2 | 仅全局设置 | 字符串 (string) |
默认值：空字符串
请参考Webhook页面。
桌面版在界面显示标题和分区
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
WpfShowTitleAndArea | 仅全局设置 | 布尔值 (boolean) |
默认值：true
只在桌面版（WPF 版）有效
桌面版开播时弹出系统通知
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
WpfNotifyStreamStart | 仅全局设置 | 布尔值 (boolean) |
默认值：false
Cookie
此设置是 高级设置
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
Cookie | 仅全局设置 | 字符串 (string) |
默认值：空字符串
API Host
此设置是 高级设置
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
LiveApiHost | 仅全局设置 | 字符串 (string) |
默认值：https://api.live.bilibili.com
主动检查时间间隔 秒
此设置是 高级设置
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
TimingCheckInterval | 仅全局设置 | 无符号数字 (uint32) |
默认值：180
请求mikufansAPI超时时间 毫秒
此设置是 高级设置
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
TimingApiTimeout | 仅全局设置 | 无符号数字 (uint32) |
默认值：10000
录制断开重连时间间隔 毫秒
此设置是 高级设置
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
TimingStreamRetry | 仅全局设置 | 无符号数字 (uint32) |
默认值：6000
录制无指定画质重连时间间隔 秒
此设置是 高级设置
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
TimingStreamRetryNoQn | 仅全局设置 | 无符号数字 (uint32) |
默认值：90
连接直播服务器超时时间 毫秒
此设置是 高级设置
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
TimingStreamConnect | 仅全局设置 | 无符号数字 (uint32) |
默认值：5000
弹幕服务器重连时间间隔 毫秒
此设置是 高级设置
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
TimingDanmakuRetry | 仅全局设置 | 无符号数字 (uint32) |
默认值：9000
最大未收到直播数据时间 毫秒
此设置是 高级设置
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
TimingWatchdogTimeout | 仅全局设置 | 无符号数字 (uint32) |
默认值：10000
触发刷新弹幕写入缓冲的个数
此设置是 高级设置
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
RecordDanmakuFlushInterval | 仅全局设置 | 无符号数字 (uint32) |
默认值：20
使用的弹幕服务器传输协议
此设置是 高级设置
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
DanmakuTransport | 仅全局设置 | DanmakuTransportMode |
默认值：DanmakuTransportMode.Wss
使用直播间主播的uid进行弹幕服务器认证
此设置是 高级设置
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
DanmakuAuthenticateWithStreamerUid | 仅全局设置 | 布尔值 (boolean) |
默认值：false
此设置项为 true 时，连接弹幕服务器只传递主播的 uid。
此设置项为 false 时，连接弹幕服务器会根据是否设置了 cookie，传递 cookie 所对应的账号信息或完全匿名。
是否使用系统代理
此设置是 高级设置
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
NetworkTransportUseSystemProxy | 仅全局设置 | 布尔值 (boolean) |
默认值：false
允许使用的 IP 网络类型
此设置是 高级设置
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
NetworkTransportAllowedAddressFamily | 仅全局设置 | 枚举 (enum) |
默认值：AllowedAddressFamily.Any
| 键 | 值 | 含义 |
|---|---|---|
AllowedAddressFamily.System | -1 | 由系统控制和决定 |
AllowedAddressFamily.Any | 0 | 由录播姬随机选择任意地址 |
AllowedAddressFamily.Ipv4 | 1 | 由录播姬选择 IPv4 地址 |
AllowedAddressFamily.Ipv6 | 2 | 由录播姬选择 IPv6 地址 |
自定义脚本
此设置是 高级设置
| 设置 ID | 设置类型 | 数据类型 |
|---|---|---|
UserScript | 仅全局设置 | 字符串 (string) |
默认值：空字符串
请参考用户脚本页面。
高级设置
本页面列出了录播姬软件的所有设置，其中有一部分设置被标记为了“ 高级设置 ”。 这些设置项通常不需要被修改，随意修改可能会导致录播姬无法正常工作。所有高级设置均不是录播姬的正式功能，它们的作用是给高级用户提供了一个在不修改源代码自己重新编译的情况下快速调整录播姬的行为的方法。
录播姬桌面版显示高级设置的方式是：鼠标右键点击两次界面左下角的设置按钮。