点歌姬v3已停止维护

点歌姬v3已停止维护，内置的搜索模块已经不能使用，如需使用可以配合西井开发的拓展模块

如果你想自行修改维护点歌姬v3，可以在这里获取源码： https://github.com/Bililive/DGJv3

下面的使用文档仅作为参考保留

---

安装插件

将压缩包中的 DGJv3.dll 解压放到 文档\弹幕姬\Plugins 文件夹，插件文件夹可以在弹幕姬的插件一页用快速打开按钮打开。

安装后，打开弹幕姬，在插件一页右键点歌姬，点击 “管理” 可以打开点歌姬界面。

第一次使用，在点歌之前需要选择使用什么歌曲平台搜索。

点歌前需要弹幕姬连接房间。

弹幕命令

普通命令

• 点歌 搜索关键词 搜索歌曲
  • 或 點歌 關鍵詞
• 取消点歌 取消自己的最后一首还没有开始播放的歌曲
  • 或 取消點歌

房管命令

• 切歌 删除列表中的第一首歌曲
• 暂停 暂停播放
  • 或 暫停
• 播放 继续播放
• 音量 数字 设置音量

输出文本

在 文档\弹幕姬\Plugins\点歌姬v3 文件夹里有 信息.txt 和 歌词.txt 两个文件，可以使用直播软件读取，显示在直播画面上。

OBS Studio 添加来源方法：

1. 在 “来源” 中右键，添加一个 文本 (GDI+) 来源
2. 给来源设置一个容易区分的名字
3. 勾选 “从文件读取”
4. 点击 “浏览” 按钮，选择一个 txt 文件
5. 调整颜色、字体、样式到想要的样子

哔哩哔哩直播姬添加来源方法：

1. 点击左下角的 “文本”
2. 给来源设置一个容易区分的名字
3. 勾选 “从文件读”
4. 点击 “浏览” 按钮，选择一个 txt 文件
5. 调整颜色、字体、样式到想要的样子

OBS Classic 添加来源方法：

1. 在 “来源” 中右键，选择 “添加”、“文字来源”
2. 随便填写一个容易区分的来源名字，确认
3. 勾选 “使用文件中的文字”
4. 点击 “浏览” 按钮，选择一个 txt 文件
5. 调整颜色、字体、样式到想要的样子

输出文本模板

点歌姬v2 使用的是简单的文本替换，而 点歌姬v3 使用了文本模板引擎，功能更强大、可以运行简单的脚本，但使用方法也相对较复杂。

有能力的主播可以自行翻阅文本模板引擎的文档： 语法 内置函数（英语）

简单说明：
在 {{ 和 }} 中间的内容是变量，会被替换成实际的文字，比如 {{ 当前播放时间 }} 会被替换成像 01:34 一样的时间。

默认示例：

播放进度 {{ 当前播放时间 }}/{{ 当前总时间 }}
当前列表中有 {{ 歌曲数量 }} 首歌
还可以再点 {{ 总共最大点歌数量 - 歌曲数量 }} 首歌
每个人可以点 {{ 单人最大点歌数量 }} 首歌

歌名 - 点歌人 - 歌手 - 歌曲平台
{{~ for 歌曲 in 播放列表 ~}}
{{ 歌曲.歌名 }} - {{  歌曲.点歌人 }} - {{ 歌曲.歌手 }} - {{ 歌曲.搜索模块 }}
{{~ end ~}}

只显示列表中前 3 首歌示例：

{{~ 最多显示歌曲数量 = 3 # <=- 修改这里的数字就是修改显示数量 ~}}
播放进度 {{ 当前播放时间 }}/{{ 当前总时间 }}
当前列表中有 {{ 歌曲数量 }} 首歌
还可以再点 {{ 总共最大点歌数量 - 歌曲数量 }} 首歌
每个人可以点 {{ 单人最大点歌数量 }} 首歌

歌名 - 点歌人 - 歌手 - 歌曲平台
{{~ for 歌曲 in 播放列表 ~}}
{{ 歌曲.歌名 }} - {{ 歌曲.点歌人 }} - {{ 歌曲.歌手 }} - {{ 歌曲.搜索模块 }}
{{~
    if for.index + 1 >= 最多显示歌曲数量 
      break
    end
  end
~}}