请注意：

▶blivechat目前主要分支有原版和只熊老师魔改版 二者在弹幕适配上存在差别 请在使用前确认所使用的版本

▶您可以查看评论区置顶的链接获取视频版教程

目录

▶下载和安装

▶初次使用配置

▶后续使用方法

▶升级新版本

▶常见问题解答

下载和安装

【如果购买了CSS样式的，一般会附带软件下载，可以跳过此部分】

通过github下载

这是软件的github的页面

点击右侧Release

选择.zip文件下载

下载地址

熊改版（更多功能）：https://github.com/DoodleBears/blivechat

原版（纯净）：https://github.com/xfgryujk/blivechat

初次使用配置

解压后点击blivechat.exe，即可启动软件

启动完成后会打开如图所示的浏览器窗口，在【直播间ID】填写您的直播间ID，其它配置按照您的需求修改即可

*本人推荐的设置方法见下图

*部分主题需按照推荐方式设置，否则可能会出现显示bug。请在购买弹幕样式前咨询卖家。

*除了浏览器外还会打开一个黑色窗口，请不要关闭，可以最小化

如您下载的是熊改版，则下载后会默认自带弹幕表情。如您不需要或希望自定义表情，可以切换到浏览器的【自定义表情】选项，红框内的为当前已添加的表情。

*本人推荐设置方式如下图

●删除表情

点击右侧的红色按钮即可删除表情

也可点击此处删除所有表情（建议删除所有初始表情）

●添加表情（步骤较为复杂，建议直接使用UP大表情功能或咨询弹幕样式卖家）

将您的弹幕表情贴图放置到\frontend\dist\static\img\emoticons文件夹中，并在本页面中选择【添加表情】。如以下图为例配置则当弹幕中出现关键词"哈哈"，就会显示图片"1.png"

设置完成后，在OBS中新建浏览器源

*后续若修改了首页上的任何设置都必须重新绑定URL才会生效

单击【复制房间URL】

替换obs浏览器源的【URL】项目

高度和宽度可根据您的个人需要进行调整。

*部分弹幕样式有宽高限值，请按卖家的建议数值设置，否则会出现bug

如您购买了弹幕样式，请将发送给您的CSS/txt文件以记事本打开后替换此处的【自定义CSS】内容

如果您没有购买，可以在【样式生成器】中简单调整后复制底部的结果，替换【自定义CSS】内容

点击确定，调整组件在OBS中的位置和比例大小。

您可以此时进入自己的直播间（无需开播）发送弹幕查看当前的设置效果。

调整完成后关闭浏览器和黑色窗口即可。

后续使用

直播前需要提前打开blivechat，关闭弹出的浏览器，保留黑色窗口（可最小化）。

直播结束后即可关闭黑色窗口。

升级/合并

部分定制弹幕样式需要读取本地图片文件，因此建议通过以下方式升级/重装blivechat新版本。

也可以通过此方式合并多个弹幕样式文件。

1.备份旧版文件（请务必进行备份避免误操作导致文件异常）

2.下载新版本blivechat压缩包并解压打开

3.在此文件夹内全选所有文件并复制

4.打开旧的安装目录的相同位置（看着文件名都差不多的）粘贴，选择替换目标中所有文件

5.测试能否正常使用

常见问题解答

▶弹幕显示模糊

如果需要调整弹幕区域大小，请更改浏览器源的宽高，不要使用鼠标拖拽放大。

▶无法获取头像的问题

1.黑色窗口是否被关闭

2.检查blivechat是否为最新版

3.检查电脑防火墙设置

4.参考下方清除直播软件浏览器缓存

▶购买的弹幕样式显示异常

1..blivechat标准版和熊改版是否下载正确

2.一些弹幕样式需要读取本地文件，请检查是否打开了正确位置的blivechat

3.重启直播软件/电脑

4.清除直播软件浏览器源缓存：

把obs或直播姬完全退出，按照以下操作删除浏览器缓存

obs：

删除 C:\Users\%USERNAME%\AppData\Roaming\obs-studio\plugin_config\obs-browser 下的cache文件夹 

直播姬：

(1.打开C:\Users\%USERNAME%\AppData\Local\bililive\User Data

(2.打开名称为Browser Cache+一串数字的文件夹

(3.打开Cache文件夹

(4.删除文件夹内所有内容

※如您同时使用多个路径的blivechat软件，会导致浏览器缓存异常影响显示，建议参考上方升级教程将所有弹幕样式提供的文件合并为同一个后使用。

▶无法显示弹幕

点击进入房间

查看打开的【新窗口】中是否有弹幕显示

●若能收到弹幕，请尝试：

1.obs版本低于27会导致显示异常，建议更新到较新版本

2.重新复制替换obs内浏览器源的URL和CSS

3.检查obs能否联网，可将url改为百度，如无法打开则obs被屏蔽网络，可检查防火墙/升级obs/重新安装obs

4.复制上方【新窗口】的网页地址（如果不显示地址栏可以右键→复制网页地址），替换obs浏览器源的URL

5.更改页面权限

●若不能收到弹幕，请尝试：

1. 检查直播间ID是否填写正确

2. 检查blivechat是否被防火墙屏蔽

3. 升级/重新安装blivechat