跳转到内容

录播姬设置

设置项

房间号

设置 ID设置类型数据类型
RoomId房间单独设置数字 (int32)

自动录制

设置 ID设置类型数据类型
AutoRecord房间单独设置布尔值 (boolean)

录制模式

设置 ID设置类型数据类型
RecordMode全局设置和单独设置枚举 (enum)

默认值:RecordMode.Standard

含义
RecordMode.Standard0标准模式
RecordMode.RawData1原始数据模式

关于录制模式的说明见 录制模式

自动分段模式

设置 ID设置类型数据类型
CuttingMode全局设置和单独设置枚举 (enum)

默认值:CuttingMode.Disabled

含义
CuttingMode.Disabled0不分段
CuttingMode.ByTime1按视频时长分段
CuttingMode.BySize2按文件大小分段

自动分段数值

设置 ID设置类型数据类型
CuttingNumber全局设置和单独设置无符号数字 (uint32)

默认值:100

根据 CuttingMode 设置的不同:
当按时长分段时,本设置的单位为分钟。
当按大小分段时,本设置的单位为 MiB。

弹幕录制

设置 ID设置类型数据类型
RecordDanmaku全局设置和单独设置布尔值 (boolean)

默认值:false

是否录制弹幕,true 为录制,false 为不录制。
本设置同时是所有“弹幕录制”的总开关,当本设置为 false 时其他所有“弹幕录制”设置无效,不会写入弹幕 XML 文件。

弹幕录制-原始数据

设置 ID设置类型数据类型
RecordDanmakuRaw全局设置和单独设置布尔值 (boolean)

默认值:false

是否记录原始 JSON 数据。
弹幕原始数据会保存到 XML 文件每一条弹幕数据的 raw attribute 上。 当 RecordDanmakufalse 时本项设置无效。

弹幕录制-SuperChat

设置 ID设置类型数据类型
RecordDanmakuSuperChat全局设置和单独设置布尔值 (boolean)

默认值:true

是否记录 SuperChat。 当 RecordDanmakufalse 时本项设置无效。

弹幕录制-礼物

设置 ID设置类型数据类型
RecordDanmakuGift全局设置和单独设置布尔值 (boolean)

默认值:false

是否记录礼物。 当 RecordDanmakufalse 时本项设置无效。

弹幕录制-上船

设置 ID设置类型数据类型
RecordDanmakuGuard全局设置和单独设置布尔值 (boolean)

默认值:true

是否记录上船(购买舰长)。 当 RecordDanmakufalse 时本项设置无效。

保存直播封面

设置 ID设置类型数据类型
SaveStreamCover全局设置和单独设置布尔值 (boolean)

默认值:false

直播画质

设置 ID设置类型数据类型
RecordingQuality全局设置和单独设置字符串 (string)

默认值:10000

录制的直播画质 qn 值,以英文逗号分割,靠前的优先。

注意

  • 所有主播刚开播时都是只有“原画”的,如果选择不录原画会导致直播开头漏录。
  • 如果设置的录制画质里没有原画,但是主播只有原画画质,会导致不能录制直播。
  • 录播姬不会为了切换录制的画质主动断开录制。
  • 这个设置项 不是录制码率
  • 这个设置项也不是录制分辨率、录制帧率。
画质qn 值
杜比30000
4K20000
原画10000
蓝光400
超清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 文件里记录当前视频时间等信息,不会分段。
请注意遇到这个问题的位置可能会缺少几秒直播画面,可以根据你自己对录播文件的用法来决定是分开更方便后期处理、还是合并在一起更方便后期处理。

是否在视频文件写入直播信息 metadata

此设置是 高级设置

设置 ID设置类型数据类型
FlvWriteMetadata仅全局设置布尔值 (boolean)

默认值:true

WebhookV1

设置 ID设置类型数据类型
WebHookUrls仅全局设置字符串 (string)

默认值:空字符串

请参考Webhook页面。

WebhookV2

设置 ID设置类型数据类型
WebHookUrlsV2仅全局设置字符串 (string)

默认值:空字符串

请参考Webhook页面。

桌面版在界面显示标题和分区

设置 ID设置类型数据类型
WpfShowTitleAndArea仅全局设置布尔值 (boolean)

默认值:true

只在桌面版(WPF 版)有效

桌面版开播时弹出系统通知

设置 ID设置类型数据类型
WpfNotifyStreamStart仅全局设置布尔值 (boolean)

默认值:false

此设置是 高级设置

设置 ID设置类型数据类型
Cookie仅全局设置字符串 (string)

默认值:空字符串

API Host

此设置是 高级设置

设置 ID设置类型数据类型
LiveApiHost仅全局设置字符串 (string)

默认值:https://api.live.bilibili.com

主动检查时间间隔 秒

此设置是 高级设置

设置 ID设置类型数据类型
TimingCheckInterval仅全局设置无符号数字 (uint32)

默认值:600

请求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.Any0由录播姬随机选择任意地址
AllowedAddressFamily.Ipv41由录播姬选择 IPv4 地址
AllowedAddressFamily.Ipv62由录播姬选择 IPv6 地址

自定义脚本

此设置是 高级设置

设置 ID设置类型数据类型
UserScript仅全局设置字符串 (string)

默认值:空字符串

请参考用户脚本页面。

高级设置

本页面列出了录播姬软件的所有设置,其中有一部分设置被标记为了“ 高级设置 ”。 这些设置项通常不需要被修改,随意修改可能会导致录播姬无法正常工作。所有高级设置均不是录播姬的正式功能,它们的作用是给高级用户提供了一个在不修改源代码自己重新编译的情况下快速调整录播姬的行为的方法。

录播姬桌面版显示高级设置的方式是:鼠标右键点击两次界面左下角的设置按钮。