# 一、插件的获取与添加

通过网页

打开B站 直播中心，在右上角找到饭盒-饭贩
点击H5插件，找到弹幕点歌，点击获取后点击复制H5插件链接
打开obs，在 "来源" 里添加浏览器源 (歌名界面)
将链接粘贴到url栏中，并勾选“通过OBS控制音频”，确定
现在你已经添加好了“歌名界面”
现在添加“歌词界面”， 无歌词显示需求的可以跳过
回到饭贩-H5插件界面，点击项目名进入项目详情
在H5插件配置里，点击“转到歌词设置”，点击“复制歌词插件链接”
再次添加浏览器源，将链接粘贴到url栏中，设置同 歌名界面
现在你已经添加好“歌词界面”

2. 通过直播姬

打开直播姬，找到H5插件，进入
找到“弹幕点歌“
您可以选择直接添加也可以点击描述进入饭贩详情页
点击添加使用，现在你已经添加好“歌名界面”
（5） 现在添加“歌词界面”， 无歌词显示需求的可以跳过
回到第2步的界面，点击描述进入饭贩详情页
浏览器将自动弹出项目详情
在H5插件配置里，点击“转到歌词设置”，点击“复制歌词插件链接”
回到直播姬，在左侧的场景中添加素材，选择浏览器
将链接粘贴到url栏中，监听设置为“仅监听，声音输出到系统声音”，点击确定
现在你已经添加好“歌词界面”

# 二、设置样式

1. 通过网页

进入详情页，找到H5配置页面
调整完后右上角会出现保存中的提示，请等待提示变化为已保存
歌词样式设置，先切换到“歌词设置”界面

2. 通过直播姬

在右边的场景中找到弹幕点歌的浏览器源，点击编辑
在弹出的插件设置窗口中即可设置样式

3. 附：字体设置方法

字体设置的字体名称为自己系统内字体名称，以下是查看本地系统安装字体的方法
在任务栏的搜索框里搜索“字体设置”，打开。（或打开设置-个性化-字体）
可用字体下面就是本地系统安装的字体，设置字体时请输入蓝色字体名称。

# 三、黑名单设置

用户黑名单

打开任意设置界面，在设置中往下翻到最底，点击“用户”
点击右上角的加号
填好信息按“提交即可”

歌曲黑名单

点击歌曲黑名单
同上 用户黑名单

附: 如何找到uid？

打开直播间评论区，找到想要屏蔽的用户，点击名称-去TA的个人空间
双击网址中的数字部分，复制数字
（这只猫猫狐超可爱快关注他（）

# 四、开始使用点歌

进入详情页，找到H5配置页面，点开“转到歌曲控制台“
①.返回之前的界面
②.自助修复问题
③.当前歌曲信息
④.开始/停止统计弹幕指令。按“开始统计”后，直播间的点歌才会起效。按“停止统计”后，插件不再响应直播间的点歌指令，但已经收集的歌曲仍会按序播放。
⑤.切换歌曲的播放位置

解释和设置起来有些麻烦，以下总结了几种情况的设置：

a) 直播界面里只展示“歌名界面”时，开关应该设置为“由歌名界面播放”
b) 直播界面里只展示“歌词界面”时，开关应该设置为“由歌词界面播放”
c) 直播界面里展示“歌词界面”和“歌名界面”时，开关应该设置为“由歌词界面播放“
⑥.直接添加一首歌曲
a) 要添加的歌曲名字

注意

请准确填写歌曲原名，外语请不要用中文代替
b) 指定是谁唱的这首歌
c) 提交歌曲到播放列表
⑦. 重新播放当前播放的歌曲
⑧. 播放/暂停当前歌曲
⑨. 播放下一首歌曲
⑩. 下一首要播放的歌曲信息（等待播放列表的第一项）
⑪. 下下首要播放的歌曲信息（等待播放列表的第二项）
⑫. 从列表里删除此歌曲
⑬. 立即播放此歌曲（移除当前正在播放的歌曲，播放选择的歌曲）
⑭. 将此歌曲设为下一首播放（移动此歌曲到等待列表的第一项）
⑮. 获取歌曲时产生的成功和失败信息

# 四、如何清除缓存？

OBS

注意

此部分只针对 OBS 28.0 及以上版本

如果你的 OBS 版本在 28.0 以下(如 OBS 27.2.4)，请直接右键浏览器源 > 属性 > 刷新当前页面缓存
打开 OBS 在工具栏找到“文件”中的“打开设置文件夹”
在弹出的文件浏览器中依次点击 plugin_config > obs-browser 文件夹，找到“Cache”，“Code Cache”和“Local Storage”文件夹并删除(需先关闭 OBS )
回到 OBS 选择浏览器源，刷新

直播姬

打开直播姬找到右上角的“更多”按钮，找到“日志文件”下的“文件定位”
在弹出的文件浏览器“Browser Cache”和“Cache”文件夹并删除(需先关闭直播姬)
回到直播姬，右键浏览器源 > 属性 > 刷新当前页面缓存

# Q&A

为什么观众发送点歌弹幕插件没有反应？

A:
（1）请先检查“歌曲控制台”中“开始统计”按钮是否按下变成了“停止统计” 跳转开始使用点歌位置
（2）确定控制台中间的“由歌名界面播放/由歌词界面播放”开关是否处于正确的状态 如何设置此开关？。

注意

更改“由歌名界面播放/由歌词界面播放”开关状态后, 请刷新OBS/直播姬中的浏览器源。(若音频已正确切换请忽略)
（3）检查播放按钮是否处于播放状态，按钮样式为双竖线时为播放状态
（4）检查“点歌信息”是否提示歌曲获取失败。（此问题一般是因为歌曲为vip或无版权歌曲，请尝试更换歌曲）

为什么直播间里有声音而我自己听不到？

A:
请为浏览器源设置监听

Obs设置监听

找到需要设置监听的浏览器源，右键-属性
勾选“使用OBS控制音频”，点击确定
在混音器中找到相同名字的音轨，点击对应的设置齿轮-高级音频设置
找到需要设置监听的浏览器源，将“音频监听”设置为“仅监听(输出静音)”

直播姬设置监听

找到需要设置监听的浏览器源，右键-属性
将“音频监听”设置为“仅监听，声音输出到系统声音”

为什么我没有歌词界面？

详见

为什么我的歌词不会滚动？

一般是“由歌名界面播放/由歌词界面播放”开关未处于正确状态导致的，详见 如何设置此开关？