软件设置¶
查看本页面时可以使用目录快速跳转到要找的内容。
电脑上目录在页面内容的右侧。
手机上先点击页面左上角的 图标，再点击当前页面 软件设置 就会打开目录。
高级设置¶
本页面列出了录播姬软件的所有设置，其中有一部分设置被标记为了 “ 高级设置”。 这些设置项通常不需要被修改，随意修改可能会导致录播姬无法正常工作。
录播姬桌面版显示高级设置的方式是：鼠标右键点击两次界面左下角的设置按钮。
设置项¶
房间号¶
| 设置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 上。
当 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) |
默认设置
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 mikufans直播服务器
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
Cookie¶
此设置项为高级设置，不显示在普通设置界面。
| 设置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.Any | 0 | 由录播姬随机选择任意地址 |
AllowedAddressFamily.Ipv4 | 1 | 由录播姬选择 IPv4 地址 |
AllowedAddressFamily.Ipv6 | 2 | 由录播姬选择 IPv6 地址 |
自定义脚本¶
此设置项为高级设置，不显示在普通设置界面。
| 设置ID | 设置类型 | 数据类型 |
|---|---|---|
UserScript | 仅全局设置 | 字符串 (string) |
默认设置
(空字符串)
请参考用户脚本页面。