【神奇弹幕】哔哩哔哩直播万能机器人，弹幕姬+答谢姬+回复姬+点歌姬+各种小骚操作

神奇弹幕

简介

神奇

• 主播秘书，一键上播下播、修改分区，直播数据收集与整理

• 根据约束条件（时间、等级、勋章等），按条件智能欢迎/答谢

• 外语自动翻译、AI闲聊回复、生僻字读音等自动化功能

• 粉丝变化、热门榜、大乱斗、船员变化、新人发言等种种数据

• 大乱斗查看双方串门的粉丝、同步视频PK对面消息、跑骚抓人

• 私信处理、感谢分享、最佳助攻、打卡回复、语音播报等

• 全自动点歌、弹幕切歌、自动暂停其它音乐、排队时长提示

• 点歌姬自动切换网易云/QQ/咪咕/酷狗，支持会员与本地导入

• 完全无人值守，远程控制，开播QQ群播报、自动录播

• 播放各音乐平台会员歌曲，没有版权的歌曲自动更换播放源

• 单个粉丝设置特别关心、强制提醒、专属昵称、永久禁言等

• 查看每名观众进来次数、礼物总计、弹幕记录、判断机器人等

• 弹幕语音播放与回复，百度/讯飞/微软语音等多个接口

• 小窗闲聊、迷你视频、快速截图，上班摸鱼挂后台听直播必备

• 自动签到、参与天选、领取小心心、赠送到期礼物

• 大量可编程运算、网页访问，超高自由度的弹幕机器人

• 游戏设计，比如扣1禁言、关注解禁、送礼物优先点歌等

• 更多神奇的隐藏功能，用户自己开发定制或者导入已有扩展

弹幕

答谢姬

• 自动欢迎进入

• 自动感谢送礼

• 实时感谢关注

• 冷却避免刷屏

• 合并礼物连击

• 设置礼物别名

• 智能昵称简化

• 目标强制欢迎

• 舰长单独欢迎

• 自动语音播报

• 个人专属昵称

• 开播下播提醒

• 可编程变量集

• 动态条件运算

• 黑白名单筛选

• 支持远程控制

• 支持语音朗读

• 礼物总结答谢

• 答谢分享直播间

• 答谢PK最佳助攻

• PK对面信息播报

• PK在线舰长播报

• PK连胜数量播报

弹幕姬

• 实时显示弹幕

• 小窗弹幕聊天

• 定时弹幕任务

• 简约聊天模式

• 点歌自动复制

• 查看点歌历史

• 保存弹幕历史

• 每日数据统计

• 外语自动翻译

• 智能沙雕回复

• 特别关心高亮

• 查看粉丝牌子

• 查看礼物价值

• 查看昵称拼音

• 粉丝变化提示

• 房管一键禁言

• 新人发言提示

• 弹幕自由复制

• 定时连接后台

• 喷子自动拉黑

• 新人快速禁言

• 跳转用户主页

• 用户累计数据

• 用户弹幕历史

• PK 历史次数

• 快速百度搜索

• 大乱斗的串门

• 对面消息同步

• 机器小号判断

• 弹幕语音朗读

• 支持讯飞语音

• 支持语音接口

• 弹幕全屏滚动

• 背景图片轮播

• 自动切换勋章

• 发送对面弹幕

• 显示船员数量

• 屏蔽用户进入

• 屏幕天选弹幕

• 发弹幕表情包

点歌姬

• 音源自动切换

• 播放会员歌曲

• 网易云ID点歌

• 点歌自动播放

• 智能匹配歌曲

• 暂停其余音乐

• 点歌历史记录

• 自由显示格式

• 自动点歌队列

• 点歌防止刷屏

• 关键词黑名单

• 伴奏优先播放

• 预计时长回复

• 支持弹幕切歌

• 送礼立即播放

• 背景封面模糊

• 提取主题色调

• 查看桌面歌词

• 收藏夹与历史

• 一键导入歌单

• 导入本地音乐

直播姬

• 修改房间标题

• 一键开播下播

• 切换直播分区

• 直播数据展示

• 实时人气查看

• 每日平均人气

• 一键任命房管

录播姬

• 自动开始录播

• 分割文件大小

• 断联自动重录

回复姬

• 自定义关键词

• 筛选用户条件

• 多条随机回复

• 支持编程变量

• 数量不做限制

• 用户弹幕打卡

• 远程控制程序

• 修改专属昵称

• 弹幕文字替换

• 每日天气预报

• 解析用户私信

视频流

• 匿名查看直播

• 预先连续截图

• 预览PK对面

• 避免PK黑屏

• 自动调整比例

截图制作

• 快速预先截图

• 多图片管理器

• 好图一键提取

• 截图批量裁剪

• 分解GIF动图

• 制作GIF动图

• 制作AVI视频

• 制作字符画图

服务端

• 直播姬可访问

• 无限扩展可能

• 支持B站接口

其他

• 开启大乱斗

• 全局快捷键

• 保存头像封面

• 配置导入导出

• 数据自动备份

• 投稿歌词字幕

• 自动切换勋章

• 每日自动签到

• 自动参与天选

• 赠送到期礼物

• 直播状态查询

• 直播匿名跑骚

• 捕捉黑听舰长

运行与升级

运行

升级

备份

绿化

预览截图

说明书

使用技巧

实时弹幕

设置账号Cookie

1. 浏览器上按F12打开【开发者工具】，Network - XHR

2. 进入或刷新B站主页（没登录的需登录），Name多了一排，点其中任意一个（若找不到Cookie就换个）

3. 复制如下图的cookie至右上角登录账号的菜单中的“设置Cookie”，即可进行发送。

自定义变量

%upname%=小明

语法说明

[必须满足条件1]*****(发送选项)弹幕内容1\n第二条弹幕\n第三条弹幕
[必须满足条件2]***(发送选项)弹幕内容2
[必须满足条件3]*(发送选项)弹幕内容3

• 条件（带方括号）

• 优先级（星号，数量越多优先级越高）

• 发送选项（带小括号）

• 弹幕内容

欢迎弹幕

普通的欢迎：%ai_name%，%greet%%tone/punc% 将发送：某某某，早上好啊~

欢迎舰长：[%guard%]*欢迎%guard_name% %ai_name% 回家~

一周至一个月没来：[%come_time%>%timestamp%-3600*24*30, %come_time%<%timestamp%-3600*24*7, 0]*%ai_name%，太久没来了哦~

大乱斗对面来人：[%pk_opposite%]***欢迎%ai_name%串门哦~

示例：只欢迎戴自己勋章

[%guard% = 0, %anchor_room_id%!=%room_id%, !%strong_notify%]**

示例：指定用户欢迎语

[%uid%=12345678]***欢迎%ai_name%，说好的今天上总督呢~
[%uname%=用户昵称]***欢迎%ai_name%，今天记得上总督哦~

送礼答谢

• 普通的答谢：谢谢 %ai_name% 的%gift_name%~

• 小礼物不理：[%gift_gold%=0, %gift_silver%<1000, %gift_num% < 10]** 也可以写作：[%coin_type%=0, %gift_coin%<1000, %gift_num% < 10]** 1000以下的银瓜子礼物且数量小于10，则忽略。例如忽略6个小心心，但24个小心心则感谢

• 超过80元的礼物：[%gift_gold%>=80000]*哇噢！感谢 %ai_name% 的%gift_name%！\n老板大气！！！！！！ \n表示换行，将分作两条弹幕发送（可以配合<h1>放大字体，仅部分弹幕插件有效）

• 跳过机器人送的吃瓜：[%uid%=%my_uid%,%origin_gift_name%=吃瓜]**

示例：指定礼物专属答谢

[%gift_name%=小电视飞船]**哇！！！谢谢%ai_name%带大家上太空~

示例：不答谢禁言用户

[%blocked%]****

关注答谢

示例：特别关注

[%special%]*(cd21:0)谢谢%ai_name%的特别关注！
感谢 %ai_name% 的关注%punc%

定时任务

示例：今日是否有大航海

[%today_guard%=0]今天XX等到新的舰长了吗？\n老板们救救可怜的XX吧~
[%today_guard%>0]今天XX等到了新的舰长，还有老板想上船嘛

示例：定时联网

>connectNet(要发送数据的网址)

自动回复

示例：关键词自动禁言

>block(%uid%)

示例：房管远程弹幕禁言

[%admin%]>execRemoteCommand(%text%)

示例：不要欢迎我

>ignoreWelcome(%uid%)\n>已关闭您的自动欢迎

示例：设置自己专属昵称

>setLocalName(%uid%, %$1%)\n>设置您的专属昵称为：%$1%

示例：修改指定用户昵称

[%admin%]>setLocalName(%(%$1%)%, %$2%)\n>修改专属昵称成功

浏览器插件

http://localhost:5520/music/index.html

远程控制

• 关闭/开启功能：开关自动欢迎、送礼答谢、关注答谢、自动禁言

• 关闭/开启欢迎

• 关闭/开启关注答谢

• 关闭/开启送礼答谢

• 关闭/开启禁言：新人关键词自动禁言

• 关闭/开启点歌

• 关闭/开启点歌回复

• 关闭/开启定时任务

• 关闭/开启自动连接

• 关闭/开启AI回复：AI回复弹幕

• 关闭/开启录播

• 禁言 [昵称] [小时]：房管权限，根据[昵称]（允许一部分，自动倒找发言人）禁言某用户，[小时]可省略，默认为自动禁言的时长（禁言相关都需要在设置中开启“启用禁言（主播/房管）”）

• 解禁 [昵称]：解除禁言，[昵称]支持用户名中的一部分

• 撤销禁言：依次解禁最近禁言的用户

• 永久禁言 [昵称]：永久禁言某用户，可通过“解禁 [昵称]”、“撤销禁言”远程解除

• 关闭机器人：全局关闭（将无法远程唤醒）

弹幕样式

background: white;
padding:5px;
border-radius: 10px;

padding:10px;
border-image: url(:/bubbles/bubble1)

border-image: url(C:/Path/To/Image.png)

• msg：一些提示

• danmaku：弹幕（样式不影响左边头像显示）

• gift：送礼

• welcome：进入

• order-song：点歌提示文字：[点歌] 歌名

• guard-buy：开通/续费舰长

• welcome-guard：舰长进入

• attention：关注

• block：禁言

• share：分享直播间

• super-chat：醒目留言

#danmaku {
 border-image: url(:/bubbles/bubble1);
 padding: 10px;
}
#gift, #guard-buy {
 background: #FFDAB9;
 padding: 5px;
 border-radius: 10px;
}

多开与备份

无限多开

自动备份、还原

调试日志

可编程设计

工作流的意义

要处理的事项自动回复

不需要对观众的数据进行手动整理

主播只需要将精力集中在关心的互动上

保存所有历史记录

随时看到统计数据

达到无纸化办公的目标

完全支持分布式架构，多设备同时工作

科学管理更近一层，直播效率明显提高

直播间的核心竞争力将有所提升

通过流程自动化与数据库集成，以及各类表单统计查询功能，提高决策能力

简单介绍

• 简单的欢迎：欢迎 %ai_name% 光临~

• 动态语气词：%ai_name%，%greet%%tone/punc%

自定义变量

• %upname%：主播昵称

数据变量

特殊用法

打破“仅直播时发送”

自定义bilibili接口

招呼变量

计算变量

示例：礼物价值

谢谢%ai_name%赠送了价值%[%gift_gold%/1000]%元的%gift_name%！

常量

函数计算

当前时间：%>time(yy-MM-dd hh:mm)%

四则运算

• 开发人员友好，= 可写作 ==

• 不等于 != 也可以是 <>

• 字符串两端可不用加双引号"

数值修改延迟

>setValue(count, %[%{count}%+1]%)\n数量：%{count}%

>setValue(count, %[%{count}%+1]%)\n数量：%[%{count}%+1]%

语法糖

>setValue(data, %[%{daka}%+1]%)

{daka}++

• 赋值：{var} = 20，等同于 >setValue(var, 20)

• 加/减/乘/除/取模：{var} += 10，等同于 >setValue(var, %[%{var}% + 10]%)

• 自增/自减：{var}++ 、{var}--，前者等同于 >setValue(var, %[%{var}% + 1]%)

逻辑运算

• 用户等级为0级：[%level%=0] 或 [%level% == 0]

• 粉丝牌等级介于10级到19级之间：[%medal_level%>=10, %medal_level%<20]

• 名字为某某某：[%uname%=某某某] 或 ["%nickname%"=="某某某"]

• 现在是黑夜：[%time_hour% > 17 || %time_hour% <= 6]

• 带粉丝牌的0级号，或非0级号：[%anchor_room_id%, %level%]

• 付费两万（2千万金瓜子）的老板：[%total_gold% >= 20000000]

• 一小时内重新进入直播间：[%come_time% > %timestamp%-3600]

• 几周没来：[%come_time%>%timestamp%-3600*24*30 && %come_time%<%timestamp%-3600*24*7]

• 某个片哥名字匹配：[[%text% ~ "[\u4e00-\u9fa5]+[\w]{3}[\u4e00-\u9fa5]+"]]>block(%uid%)

优先级

感谢 %ai_name% 的%gift_name%，么么哒~
[%gift_gold%>=10000]感谢 %ai_name% 的%gift_name%，老板大气！
[%gift_gold%>=50000]*(cd15:3)哇塞！感谢 %ai_name% 的%gift_name%！\n老板大气！
[%gift_gold%>=150000]**(cd16:1)哇噢！感谢 %ai_name% 的%gift_name%！\n老板大气！！！！！！

• 当本次礼物的金瓜子总价少于1万时，发送第一项；

• 当本次礼物的金瓜子总价小于5万时，随机发送第一项、第二项；

• 当本次礼物金瓜子总价介于5万到15万时，发送第三项；

• 当本次礼物金瓜子总价超过15万时，发送第四项。

高优先级被忽略情况

注释

// 单行注释，不会被发送
这是弹幕 // 弹幕后面的注释
第一条弹幕//中间的注释1\n第二条弹幕//中间的注释2\n第三条弹幕

软换行

计算结果：%[1 \
 +2 \
 +3]%

多条弹幕

发送选项

冷却通道（cd）：控制弹幕发送频率

等待通道（wait）：控制自己不连续发送弹幕

强制房管权限（admin）：向普通观众的弹幕开放部分权限

[某条件]***(cd20:5,wait12:5)欢迎xxx~

与条件的区别

• 条件的方式：[%cd20%>5]某弹幕

• 选项的方式：(%cd20%:5)某弹幕

• 条件：会判断其他行的弹幕会不会发送，如果可以，则发送出去；

• 选项：不会判断其他弹幕，直接不发送。

强制房管权限

[%medal_level% >= 30](admin)>triggerReply(某回复)

冷却通道

示例：强制欢迎

(cd10:30)欢迎%ai_name%~
[%medal_level%>=25]*(cd11:5)欢迎%ai_name%，请多多关照~
[%guard%]**(cd12:5)欢迎舰长%ai_name%回家！

等待通道

(wait12:3)某定时发送的弹幕

示例：不连续的定时弹幕

[%wait10% < 1]**** // 没有别人发弹幕时，自己不连续发弹幕
(wait10:0)喜欢%upname%的小伙伴可以动动小手点个关注~
(wait10:0)关注主播不迷路,主播带你上高速~
(wait10:0)喜欢主播的可以点点关注哦~
(wait10:0)赠送一个B坷拉，领取主播专属勋章哦~

命令操作

批量修改配置

• _VALUE_替换为当前遍历到的值(value)

• _$x_替换为exp正则捕获的文字，其中x=0时为键(key)，x>0时为正则的捕获组，等同于自动回复中的 %$x%

• _{key}_ 替换为读取配置文件，等同于正常情况下的 %{key}%

• _[exp]_替换为计算表达式（不支持外面再嵌套任意内容）

• 删除7天没来的用户记录： removeValuesIf(not_come_(\d+), [_VALUE_>7])

• 今日没签到的用户重置连续签到为0： setValuesIf(signin_keep_(\d+), [!_{signin_today__$1_}_], 0)

• 用户上船天数+1： setValuesIf(guard_days_\d+, [1], _[_VALUE_+1]_)

显示值列表

示例：显示所有用户积分

>showValueTable(积分查询, integral_(\d+), ID:"_ID_", 昵称:uname__ID_, 积分:integral__ID_:>)

示例：显示所有打卡记录

>showValueTable(今天共第%[%{daka}%+0]%人打卡, daka_sum_(\d+), ID:"_ID_", 累计:daka_sum__ID_:>, 昵称:uname__ID_, 积分:integral__ID_, 连续:daka_keep__ID_, 本月:daka_month__ID_, 今日:daka_today__ID_)

示例：显示用户总金瓜子

>showValueTable(氪金列表, _counts/gold/(\d+), ID:"_ID_", 金瓜子:gold/_ID_:>, 昵称:_heaps/uname__ID_)

解析JSON：网络数据回调

{
 "data": {
 "room": {
 "roomname": "房间名字"
 },
 "anchor": {
 "uname": "名字",
 }
 }
}

示例：获取主播信息

>getData(https://api.live.bilibili.com/xlive/web-room/v1/index/getInfoByRoom?room_id=%room_id%, RoomInfoCallBack)

>localNotify(舰长数量：%.data.guard_info.count%，\
 粉丝数量：%.data.anchor_info.relation_info.attention%，\
 粉丝团：%.data.anchor_info.medal_info.fansclub%，\
 主播等级：%.data.anchor_info.live_info.level%)

关于多线程安全性

观众1：>setValue(daka, %[%{daka}+1]%)
观众2：>setValue(daka, %[%{daka}+1]%)

观众1：>setValue(daka, 1)
观众2：>setValue(daka, 1)

观众1：>addValue(daka, 1) -> 变成1
观众2：>addValue(daka, 1) -> 变成2

简单命令示例

示例：自动打卡

>sendRoomMsg([直播间房号], 打卡)

示例：自定义朗读弹幕格式

>speakText(%uname%说：%text%)

示例：禁言小游戏

已自动禁言，赠送小心心或关注主播解禁\n>block(%uid%, 1)\n>addGameUser(%uid%)

1. 回复

2. 禁言

3. 添加到游戏用户，等待解除禁言

[%in_game_users%,%origin_gift_name%=小心心]***已解除禁言\n>unblock(%uid%)\n>removeGameUser(%uid%)

[%in_game_users%]*已解除禁言\n>unblock(%uid%)\n>removeGameUser(%uid%)

1. 回复

2. 解除禁言

3. 从游戏用户中移除，后续小心心不再触发该游戏，而是普通的答谢

示例：上船自动私信

[%guard_buy%,%guard_first%=1]感谢%ai_name%开通%gift_name%！\n>sendPrivateMsg(%uid%, 感谢开通大航海，可加入粉丝群：xxx)

示例：送礼优先点歌

[%gift_name%=喵娘]>improveSongOrder(%uname%,5)

[%gift_name%=喵娘]>improveSongOrder(%username%,%[%gift_gold%/1000]%)

示例：弹幕切歌

[%admin%]*>cutOrderSong()
>cutOrderSong(%uname%)

示例：远程开关AI弹幕回复

>execRemoteCommand(开启弹幕回复,0)\n>setValue(reply, 1)\n已开启AI弹幕回复，发送“关闭”结束

[%guard%, %{reply}%]>execRemoteCommand(关闭弹幕回复)\n>setValue(reply, 0)

• >execRemoteCommand：运行仅机器人和主播才能用的远程指令，参数2的0表示不自动回复（因为有自定义的另一个回复，覆盖掉默认的）

• \n：多个指令或多条弹幕，用 \n 标记隔开

• setValue(reply, 1)：设置变量reply的值为1，用来判断是否需要关闭

• [%guard%, %{reply}%]：舰长且reply=1，若是则执行后面的，否则不做操作

示例：远程添加违禁词

[%admin%]>addBannedWord(%$1%,|more_ban)\n>已设置，再发将自动禁言

^[^不都]*(违禁词1|违禁词2|more_ban)

积分查看

示例：所有用户积分

/// 显示所有用户积分
>showValueTable(积分查询, integral_(\d+), ID:"_ID_", 昵称:uname__ID_, 积分:integral__ID_:>, 动作:action__ID_, 坐骑:mount__ID_)

示例：所有打卡记录

/// 显示所有打卡记录
>showValueTable(今天共第%[%{daka}%+0]%人打卡, daka_sum_(\d+), ID:"_ID_", 累计:daka_sum__ID_:>, 昵称:uname__ID_, 积分:integral__ID_, 连续:daka_keep__ID_, 本月:daka_month__ID_, 今日:daka_today__ID_)

事件动作

主程序事件

示例：远程禁言回复

[%uid%=%my_uid%]**>因为太帅无法被禁言
[%uid%=%up_uid%]**>已禁言主播（狗头保命）
[%admin%]*>无法禁言房管
>已禁言：%uname%

时间事件

• 每天0点都会触发

• NEW_DAY：如果神奇弹幕没开，那么第二天启动时需要手动点事件中对应的“发送”按钮

• NEW_DAY_FIRST：启动时会自动执行新的一天的操作

示例：打卡计数

[%{daka_today_%uid%}%]*>您已打过卡
[%living%+1]>打卡成功，您是今天第%[%{daka}%+1]%个，累计%[%{daka_sum_%uid%}%+1]%天\n\
 >setValue(daka, %[%{daka}%+1]%)\n\
 >setValue(daka_today_%uid%, 1)\n\
 >setValue(daka_sum_%uid%, %[%{daka_sum_%uid%}%+1]%)

[%living%+1]>removeValues(daka_today_\d+)\n>setValue(daka, 0)

示例：高级打卡

[
 {
 "anchor_key": "神奇弹幕:AutoReply",
 "enabled": true,
 "key": "^(签到|打卡)\\s*([\\(（].*|\\d+)?$",
 "reply": "/// 记录每位用户是第几个打卡以及累计天数\n[%{daka_today_%uid%}%]*>您已打过卡\n[%living%+1]>签到成功，您是今天第%[%{daka}%+1]%个，本月%[%{daka_month_%uid%}%+1]%天\\n\\\n\t>setValue(daka, %[%{daka}%+1]%)\\n\\\n\t>setValue(uname_%uid%, %uname%)\\n\\\n\t>setValue(daka_today_%uid%, 1)\\n\\\n\t>setValue(daka_sum_%uid%, %[%{daka_sum_%uid%}%+1]%)\\n\\\n\t>setValue(daka_month_%uid%, %[%{daka_month_%uid%}%+1]%)\\n\\\n\t>setValue(daka_keep_%uid%, %[%{daka_keep_%uid%}%+1]%)\\n\\\n\t>setValue(integral_%uid%, %[%{integral_%uid%}%+1000]%)\\n\\\n\t>triggerEvent(DAKA_MONTH_%[%{daka_month_%uid%}%+1]%)"
 },
 {
 "anchor_key": "神奇弹幕:AutoReply",
 "enabled": true,
 "key": "^(查询(打卡|签到)|(打卡|签到)查询)$",
 "reply": "[%living%+1]连续%[%{daka_keep_%uid%}%]%天，本月%[%{daka_month_%uid%}%]%天，累计%[%{daka_sum_%uid%}%]%天"
 },
 {
 "action": "/// 重置每天打卡的人数\n[%living%+1]>setValue(daka, 0)\\n\\ // 重置今日打卡人数\n\t>removeValuesIf(^daka_keep_(\\d+)$, [!_{daka_today__$1_}_])\\n\\ // 未连续签到断开\n\t>removeValues(daka_today_\\d+) // 重置每人是否打卡",
 "anchor_key": "神奇弹幕:EventAction",
 "enabled": true,
 "event": "NEW_DAY_FIRST"
 },
 {
 "action": "/// 重置每月打卡天数\n[%living%+1]>setValues(daka_month_\\d+, 0)",
 "anchor_key": "神奇弹幕:EventAction",
 "enabled": true,
 "event": "NEW_MONTH_FIRST"
 },
 {
 "action": "您已打卡满21天，可找主播领小礼物~",
 "anchor_key": "神奇弹幕:EventAction",
 "enabled": true,
 "event": "DAKA_MONTH_21"
 }
]

点歌姬事件

示例：点歌提示未带勋章

(cd35:600)请戴粉丝牌点歌

示例：点歌后立即切歌

["%playing_song%" != "", "%song_order_uname%" = ""]>cutOrderSong()

弹幕事件

示例：复读机

[%uname%=用户昵称]%text%

示例：QQ群推送开播消息

>connectNet(https://push.xuthus.cc/group/[skey]?c=[开播消息])

示例：下播自动关机

>timerShot(30000, >runCommandLine(shutdown -s -t 30))

>runCommandLine(shutdown -a)

示例：感谢分享直播间

感谢%ai_name%分享%upname%的直播间！

示例：上船声音提示

>playSound(%app_path%/audios/guard.mp3)

示例：上船自动设置房管

>postData(https://api.live.bilibili.com/live_user/v1/RoomAdmin/add, admin=%uid%&anchor_id=%room_id%&csrf_token=%csrf%&csrf=%csrf%&visit_id=)

示例：成为第x位船长

恭喜%uname%成为第%number%位船员！

示例：恭喜勋章升级

[%medal_level%>=5, %anchor_room_id%=%room_id%]恭喜%ai_name%勋章升级至%medal_level%~

示例：天选时刻中奖播报

恭喜%uname%中奖：%text%

示例：保存弹幕/送礼记录

大乱斗事件

示例：大乱斗结束前提醒

>timerShot(270000, 离大乱斗结束还有30秒)

示例：大乱斗蹭积分卡

>setValue(pk_ceng, 0)

[%pking%, %{pk_ceng}%=0, %gift_gold% >= 100000, %gift_num%=1]>setValue(pk_ceng, 1)\n>sendGift(20004, 1)

[%{pk_ceng}%=0]>setValue(pk_ceng, 1)\n>postData(https://api.live.bilibili.com/xlive/lottery-interface/v2/pk/join, id=%pk_id%&roomid=%room_id%&type=pk&csrf_token=%csrf%&csrf=%csrf%&visit_id=)

示例：大乱斗最佳助攻

[%level%>0, %gift_coin% >= 100]感谢本场最佳助攻：%uname%

示例：大乱斗尊严票

[%pk_my_votes%=0, %pk_match_votes%>100]>sendGift(20004, 1)

示例：自动开启大乱斗

>timerShot(5000, >joinBattle(1))

示例：主播互相串门

[%pking%, %uid%=%pk_uid%]>sendRoomMsg(%pk_room_id%, 我也来串门啦~)

示例：大乱斗匹配信息

• 主播名称：%.anchor_info.base_info.uname%

• 勋章名称：%.anchor_info.medal_info.medal_name%

• 舰长数量：%.guard_info.count%

• 粉丝数量：%.anchor_info.relation_info.attention%

• 粉丝团：%.anchor_info.medal_info.fansclub%

• 主播等级：%.anchor_info.live_info.level%

• 主播积分：%.anchor_info.live_info.score%

• 房间名称：%.room_info.title%

• 分区名称：%.room_info.area_name%

匹配到：%.anchor_info.base_info.uname%，%.guard_info.count%舰长，%.anchor_info.relation_info.attention%粉丝

示例：大乱斗连胜（旧）

[%level%>0]>setValue(winCount, %[%{winCount}%+1]%)\n>triggerEvent(winCountReport)
[%level%<0]>setValue(winCount, 0)

[%{winCount}%>=3]目前连胜场数：%{winCount}%

>setValue(winCount,5)

>setValue(pk_win, 0)

示例：大乱斗连胜

[%number% > 5]恭喜达到%number%连胜！

示例：对面在线舰长播报

[%number%>30]*危！对面有%number%名舰长在线！
[%number%>20, %.guard1%>0]**对面有%[%number%-%.guard1%]%名舰长在线，%.guard1%名总督
[%number%>0]对面有%number%名舰长在线！

PK对面事件

私信事件

示例：自动回复私信

[%.last_msg.msg_type% != 1]***
[[[%text% ~ hello]]]>localNotify(收到私信：%username%：%text%)\n\
 >sendPrivateMsg(%uid%, 你好~)

示例：私信闲聊机器人

[%.last_msg.msg_type% != 1]***
>aiChat(%text%, >sendPrivateMsg(%uid%, 【自动回复】\%text\%))

示例：解析私信内容

[%.last_msg.msg_type% != 1]*** // 忽略系统通知等无关消息
[[[%text% ~ ^设置我的]]]>triggerReply(%text%)
[[[%text% ~ ^兑换奖品]]]>triggerReply(%text%)
[[[%text% ~ ^我的信息$]]]>sendPrivateMsg(%uid%, 名字：%{info/name_%uid%}%，地址：%{info/addr_%uid%}%，号码：%{info/num_%uid%}%)

[[[%$1% = 名字]]]>setValue(info/name_%uid%, %$2%)\n>sendPrivateMsg(%uid%, 已设置您的名字为：%$2%)
[[[%$1% = 地址]]]>setValue(info/addr_%uid%, %$2%)\n>sendPrivateMsg(%uid%, 已设置您的地址为：%$2%)
[[[%$1% = 号码]]]>setValue(info/num_%uid%, %$2%)\n>sendPrivateMsg(%uid%, 已设置您的号码为：%$2%)

示例：自动生成Excel表单

[[["%{info/name_%uid%}%" = ""]]]*>sendPrivateMsg(%uid%, "请先发送“设置我的名字：xxx”来设置收件人姓名")
[[["%{info/num_%uid%}%" = ""]]]*>sendPrivateMsg(%uid%, "请先发送“设置我的号码：xxx”来设置手机号码")
[[["%{info/addr_%uid%}%" = ""]]]*>sendPrivateMsg(%uid%, "请先发送“设置我的地址：xxx”来设置收件地址")
[[[%$1% = 手作; %$1% = 红包]]]>appendFileLine(兑奖.csv, \
 %uid%, %uname%, %$1%, %{info/name_%uid%}%, %{info/num_%uid%}%, %{info/addr_%uid%}%, %>time(yyyy-MM-dd hh:mm)%)\n\
 >sendPrivateMsg(%uid%, 操作成功)

示例：批量发送Excel信息

>csvEachLine(兑奖.csv, >sendPrivateMsg(\%$1\%, 【发货提醒】您的“\%$3\%”已发货~)%n%>delay(3000))

原始数据

{
 "talker_id": 324495090, // 用户ID
 "session_type": 1,
 "at_seqno": 0,
 "top_ts": 0,
 "group_name": "",
 "group_cover": "",
 "is_follow": 1,
 "is_dnd": 0,
 "ack_seqno": 193772296863792,
 "ack_ts": 1647245795072485,
 "session_ts": 1647309089148477,
 "unread_count": 6,
 // 最后一条消息。例如获取消息类型：%.last_msg.msg_type%
 "last_msg": {
 "sender_uid": 324495090,
 "receiver_type": 1,
 "receiver_id": 20285041,
 "msg_type": 1, // 消息类型，1 用户私信
 "content": "{\"content\":\"测试消息\"}",
 "msg_seqno": 194835318046736,
 "timestamp": 1647309089,
 "at_uids": null,
 "msg_key": 7075138663693631915,
 "msg_status": 0,
 "notify_code": ""
 },
 "group_type": 0,
 "can_fold": 0,
 "status": 0,
 "max_seqno": 194835318046736,
 "new_push_msg": 0,
 "setting": 0,
 "is_guardian": 0,
 "is_intercept": 0,
 "is_trust": 0,
 "system_msg_type": 0,
 "live_status": 0,
 "biz_msg_unread_count": 0,
 // 发送者信息（视网络，可能获取不到）
 "sender": {
 "code": 0,
 "message": "0",
 "ttl": 1,
 "data": {
 "mid": 324495090,
 "name": "般若菠萝包rollora",
 "sex": "女",
 "face": "http://i0.hdslb.com/bfs/face/63340c49aa7915426f4ba5019cd27a5cbec098b8.jpg",
 "face_nft": 0,
 "sign": "自由人，生活向主播，经纪人",
 "rank": 10000,
 "level": 5,
 "jointime": 0,
 "moral": 0,
 "silence": 0,
 "coins": 0,
 "fans_badge": true,
 "fans_medal": {
 "show": false,
 "wear": false,
 "medal": null
 },
 "is_followed": true,
 "live_room": {
 "roomStatus": 1,
 "liveStatus": 0,
 "url": "https://live.bilibili.com/11046586?broadcast_type=0&is_room_feed=1",
 "title": "房间标题",
 "cover": "http://i0.hdslb.com/bfs/live/new_room_cover/5987df8547248533f87bcbb40926742d8ce07a17.jpg",
 "roomid": 11046586,
 "roundStatus": 0,
 "broadcast_type": 0,
 "watched_show": {
 "switch": true,
 "num": 220,
 "text_small": "220",
 "text_large": "220人看过",
 "icon": "https://i0.hdslb.com/bfs/live/a725a9e61242ef44d764ac911691a7ce07f36c1d.png",
 "icon_location": "",
 "icon_web": "https://i0.hdslb.com/bfs/live/8d9d0f33ef8bf6f308742752d13dd0df731df19c.png"
 }
 },
 }
 }
},

过滤器事件

示例：点歌过滤

["%anchor_room_id%" != "%room_id%", !%guard%]>reject()

示例：只显示舰长进入

[!%guard%]>reject()

示例：过滤免费礼物

[%gift_gold% = 0]>reject()

示例：自定义过滤器

示例：自定义词库过滤

示例：自定义正则过滤

录播事件

全局快捷键

警告事件

服务端事件

示例：远程计数

[%text%=SQUAT]>sendToSockets(SQUAT, {"cmd":"SQUAT", "data":%{squat}%})

>setValue(squat, 0)\n>sendToSockets(SQUAT, {"cmd":"SQUAT", "data":0})

>setValue(squat, %[%{squat}%+1]%)\n\
 >sendToSockets(SQUAT, {"cmd":"SQUAT", "data":%[%{squat}%+1]%})

<head>
 <title>神奇弹幕蹲起</title>
 <script src="js/jquery.js"></script>

 <style type="text/css">
 .card {
 background-color: #fff;
 box-shadow: 0 4px 8px 0 rgba(0, 0, 0, 0.2);
 transition: 0.3s;
 /* width: 40%; */
 border-radius: 5px;
 padding-left: 20px;
 padding-right: 20px;
 }

 .card:hover {
 box-shadow: 0 8px 16px 0 rgba(0, 0, 0, 0.2);
 }
 </style>
</head>

<body>
 <div class="card" style="display:inline-block">
 <h1 id='count'>蹲起个数：0</h1>
 </div>

 <script type="text/javascript">
 $(document).ready(function () {
 var ws = new WebSocket("ws://__DOMAIN__:__WS_PORT__");
 ws.onopen = function () {
 ws.send('{"cmd":"cmds", "data":["SQUAT"]}');
 };
 ws.onmessage = function (e) {
 var json = JSON.parse(e.data);
 var cmd = json['cmd'];
 switch (cmd) {
 case 'SQUAT':
 console.log(json);
 var count = parseInt(json['data']); // 这就是个数
 $("#count").html('蹲起个数：' + count);
 break;
 }
 };
 });
 </script>
</body>

Web开发接口

浏览器访问

Socket通讯

var ws = new WebSocket("ws://__DOMAIN__:__WS_PORT__");
ws.onopen = function() {
 ws.send('{"cmd":"cmds", "data":["SONG_LIST"]}');
};

• SONG_LIST：点歌列表

• LYRIC_LIST：歌词

• CURRENT_SONG：正在播放的歌曲

• LIVE_ALL_GIFTS：本场直播所有礼物（同一人同一礼物合并），仅接受一次

主程序发送消息

>sendToSockets(SOME_CMD, \
 {\
 "action": "SOME_ACTION",\
 "data": {"key1": "value1", "key2": 222}\
 })

接收主程序消息

<ol id="songs" class="live numbers"> </ol> <!-- 被修改的ul -->

ws.onmessage = function(e) {
 console.log(e.data); // 打印接收的json格式，类型太多，就不一一说明了
 var json = JSON.parse(e.data);
 var cmd = json['cmd'];
 switch (cmd) {
 case 'SONG_LIST':
 var songs = json['data']; // 歌曲对象组成的数组
 var olHtml = '';
 for (var i = 0; i < songs.length; i++) {
 var song = songs[i]; // 歌曲对象，可获取歌名、歌手、用户等
 olHtml += '<li>' + song['name'] + "</li>";
 }
 $("#songs").html(olHtml);
 break;
 }
};

主程序接收消息

通用消息接收事件

[%.cmd% == ONE_CMD]执行ONE_CMD动作
[%.cmd% == ANOTHER_CMD]执行ANOTHER_CMD动作

独立cmd接收事件

{
 "cmd": "CLICKED",
 "data": {
 "name": "小明"
 }
}

持久化配置

SET_CONFIG：在网页中发送该 cmd 的 json，将会保存配置。 group 为保存的分组，读取时传入该参数可获取该分组下的所有配置。建议一个应用的配置都保存到同一个分组下。

{
 "cmd": "SET_CONFIG",
 "group": "test",
 "data": {
 "key1": 123,
 "key2": "某个值",
 "key3": 10.08,
 "key4": false
 }
}

该命令无返回。

GET_CONFIG：返回同样的 cmd，data 中会包含配置的键值对

{
 "cmd": "GET_CONFIG",
 "group": "test",
 "data": ["key1", "key2", "key3", "key4", "key5"]
}

可以不添加 data 或留空 "data": []，会返回该 group 下的所有配置。
若是 JS 并且使用了默认的 magical_danmaku.js，添加 function readConfig(data)，其中的形参 data 就是返回的 JSON 的 data，可直接读取里面的数值。

{
 "cmd": "GET_CONFIG",
 "data": {
 "key1": 123,
 "key2": "某个值",
 "key3": 10.08,
 "key4": false,
 "key5": null
 }
}

读取主程序信息

{
 "cmd": "GET_INFO",
 "data": {
 "key1": "key1表达式",
 "key2": "key2表达式"
}

function socketInited() {
 var json = {
 cmd: "GET_INFO",
 data: {
 room_id: "%room_id%",
 title : "%room_name%",
 pk : "%pking%"
 }
 }
 appWs.send(JSON.stringify(json));
}

function readInfo(data) {
 roomId = data['room_id']; // 获取到的房间ID
 title = data['title']; // 房间标题
 pking = data['pking']; // 是否正在PK
}

{
 "cmd": "GET_INFO",
 "data": {
 "room_id": "123456",
 "title": "标题",
 "pk": "0"
 }
}

反向控制主程序

{
 "cmd": cmd类型,
 "data": 数据
}

cmds

get_config

set_config

forward：将 data 中的数据发送给其他 socket，data 中要同样再包含一层 cmd 和 data。完整 JSON 如下：

{
 "cmd": "forward",
 "data": {
 "cmd": "[转发的命令]",
 "data": "[转发数据]"
 }
}

set_value：修改主程序的原始配置，重启主程序生效。可以有两种形式：

// 单独修改一项设置
{
 "cmd": "set_value",
 "data": {
 "key": "[key]",
 "value": [value] // 可以是字符串，也可以是整数
 }
}

// V4.7.2新增，同时修改多项设置
{
 "cmd": "set_value",
 "data": {
 "key1": [value1],
 "key2": [value2],
 "key3": [value3]
 }
}

send_msg：使主程序发送弹幕，data为弹幕字符串，使用 \\n 来分隔多条弹幕；不会解析变量，而是直接发送出去

{
 "cmd": "send_msg",
 "data": "要发送的弹幕1\\n弹幕2\\n弹幕3"
}

send_variant_msg：使主程序发送带变量的弹幕或命令，例如 %{key}%；需要用户信息的例如 %uid% 均不可使用。

{
 "cmd": "send_variant_msg",
 "data": "数量：%{count}%"
}

便携接口

用户头像：/api/header?uid=123456，可直接用于 <img> 标签

<img src="http://__DOMAIN__:__PORT__/api/header?uid=123456" />

网络代理：/api/netProxy?url=网址，可解决本地请求无法跨域问题；其中 网址 若带有参数，则建议进行 URL 编码。请求时使用 GET、POST 等不同方法、设置不同 content-type，都会响应转移到代理中，并自动设置当前登录账号的 Cookies。

$.ajax({
 url: "http://__DOMAIN__:__PORT__/api/netProxy?url=http://api.live.bilibili.com/xlive/web-room/v1/giftPanel/giftConfig?platform=pc",
 async: false,
 dataType: "JSON",
 success: function (data) {
 giftList = data["data"]["list"];
 }
});

该接口除了 url 之外的参数都会设置到请求的 header 中，如：/api/netProxy?url=xxx&referer=xxx&content-type=xxx

触发事件：/api/event?event=事件名&data=url编码(json)，会触发指定事件如 SEND_GIFT。若使用 post 方式，data 部分可直接使用 json 来发送而不需要 url 编码。

网页程序打包

{
 "name": "点歌姬", // 扩展整体名字
 "min_version": "4.4.0", // 能用的神奇弹幕最低版本，过低会报警告
 "author": "小乂", // 作者名字
 "list": [ // 允许多个网页，list中一项一个
 {
 "name": "弹幕点歌列表", // 这是显示出来的名字
 "url": "index.html", // 相对于主机地址的URL路径
 "desc": "显示弹幕点歌的实时列表，播放完毕后自动移除", // 简单描述与说明
 "author": "作者名", // （可空）单独的作者名字
 "css": "list.css", // （可空）便于用户修改的CSS文件相对于www文件夹的路径
 "css_custom": "list_custom.css", // （可空）用户自定义CSS，修改后会覆盖上面一项
 "cover": "cover.png", // （可空）扩展封面图片，默认为 cover.png
 "code": [], // （可空）有些弹幕交互程序需要添加的代码，代码块菜单“复制+继续复制”后粘贴到此处
 "config": "config.html", // （可空）扩展的配置页面
 "homepage": "http://xxx", // （可空）主页链接
 "contact": "http://xxx", // （可空）联系作者
 "reward": "http://xxx", // （可空）打赏链接
 "dir": "images", // （可空）打开某一文件夹，比如图片资源，用于用户替换
 "file": "result.txt", // （可空）打开某一文件，比如保存的抽奖结果
 "menus": [ // （可空）自定义扩展的右键菜单
 {
 "name": "自定义菜单",
 "url": "http://xxx",
 "code": "" // 点击这个菜单项要执行的代码/弹幕
 }
 ]
 },
 {
 "name": "当前歌曲名字",
 "url": "/music/playing.html",
 "css": "/music/playing.css",
 "desc": "点歌姬正在播放的歌曲的名字"
 },
 /* ... */
 ]
}

QA

为什么不发送弹幕？

调试模式

• 什么提示都没有，甚至看不到人进来：
• 该用户关闭了进入直播间通知
• 短时间反复进入直播间都不会有消息，静等十分钟后再试

• 正常发送欢迎弹幕

• [冷却中]：还在CD，避免刷屏

• [空弹幕，已跳过]：有如下两种可能：
• 按条件跳过（如未戴勋章），即形如 [xxx]**** 的格式
• 没有符合条件的回复

一直在获取房间信息？

点歌没有反应

1. 检查点歌设置页面的左上角总开关是否开启

2. 要保持播放器页面一直打开（“召唤点歌姬”）

3. 检查点歌表达式是否正确，默认格式：点歌 歌名，无需修改
• 如果格式正确，则点歌姬会自动出现搜索歌曲的列表

4. 查看点歌设置页面底部有没有点歌列表（最下面方块，点右上角的按钮）
• 如果没有这个列表，则表示点歌的格式不对

5. 检查点歌条件，比如勋章限制、连续点歌

6. 检查事件中的代码，点歌过滤器中设置了拒绝点歌

7. 查看音乐播放器页面的点歌列表有没有未播放歌曲
• 手动暂停的话，点歌后依旧保持暂停状态，是不会继续播放的哦

8. 检查是否加入了点歌黑名单（点歌设置页面的右上角）

实时视频不能播放？

讯飞语音没有声音？

怎么添加弹幕窗口到OBS？

怎么提bug？

参考资料