跳转至

软件设置

查看本页面时可以使用目录快速跳转到要找的内容。
电脑上目录在页面内容的右侧。
手机上先点击页面左上角的 图标,再点击当前页面 软件设置 就会打开目录。

高级设置

本页面列出了录播姬软件的所有设置,其中有一部分设置被标记为了 “ 高级设置”。 这些设置项通常不需要被修改,随意修改可能会导致录播姬无法正常工作。

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

设置项


房间号

设置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 设置类型 数据类型
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 值,以英文逗号分割,靠前的优先。

注意

  • 所有主播刚开播时都是只有 “原画” 的,如果选择不录原画会导致直播开头漏录。
  • 如果设置的录制画质里没有原画,但是主播只有原画画质,会导致不能录制直播。
  • 录播姬不会为了切换录制的画质主动断开录制。
  • 这个设置项 不是录制码率
  • 这个设置项也不是录制分辨率、录制帧率。
画质 ID 对照表
画质 qn 值
杜比 30000
4K 20000
原画 10000
蓝光(杜比) 401
蓝光 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 信息,同时在这前后可能会有重复的直播数据,或者缺少直播数据。录播姬会检测完全一致的重复数据并删除。 造成这个问题的原因可能是直播服务器与它上一级直播服务器的连接断开了。

flowchart RL
  subgraph B站直播服务器
    s1
    c
    c1
  end
  s1[推流服务器<br>或<br>其他直播 CDN] --- s[主播]
  c[直播 CDN] --怀疑是这里断了--> s1
  z11[其他观众] --> c1[直播 CDN] --> s1
  z12[其他观众] --> c1
  p1[观众 1] --> c
  p2[观众 2] --> c

主播连麦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

请求B站API超时时间 毫秒

此设置项为高级设置,不显示在普通设置界面。

设置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.Random

是否使用系统代理

此设置项为高级设置,不显示在普通设置界面。

设置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)

默认设置

(空字符串)

请参考用户脚本页面。