mirror of
https://github.com/AynaLivePlayer/blivedm-go.git
synced 2026-05-12 07:34:50 +08:00
95 lines
2.5 KiB
Markdown
95 lines
2.5 KiB
Markdown
# blivedm-go
|
||
|
||
bilibili 直播弹幕 golang 库
|
||
|
||
## 安装
|
||
```shell
|
||
go get github.com/Akegarasu/blivedm-go
|
||
```
|
||
|
||
## 快速开始
|
||
|
||
### 基础使用
|
||
|
||
该库支持以下几种基本事件，并且支持监听自定义事件。
|
||
- 弹幕
|
||
- 醒目留言
|
||
- 礼物
|
||
- 上舰
|
||
- 开播
|
||
|
||
```go
|
||
package main
|
||
|
||
import (
|
||
"fmt"
|
||
"github.com/Akegarasu/blivedm-go/client"
|
||
"github.com/Akegarasu/blivedm-go/message"
|
||
"github.com/tidwall/gjson"
|
||
)
|
||
|
||
func main() {
|
||
c := client.NewClient("8792912")
|
||
// 弹幕事件
|
||
c.OnDanmaku(func(danmuku *message.Danmaku) {
|
||
fmt.Printf("[弹幕] %s：%s\n", danmuku.Sender.Uname, danmuku.Content)
|
||
})
|
||
// 醒目留言事件
|
||
c.OnSuperChat(func(superChat *message.SuperChat) {
|
||
fmt.Printf("[SC] %s: %s, %d 元\n", superChat.UserInfo.Uname, superChat.Message, superChat.Price)
|
||
})
|
||
// 礼物事件
|
||
c.OnGift(func(gift *message.Gift) {
|
||
fmt.Printf("[礼物] %s 的 %s %d 个\n", gift.Uname, gift.GiftName, gift.Num)
|
||
})
|
||
// 上舰事件
|
||
c.OnGuardBuy(func(guardBuy *message.GuardBuy) {
|
||
fmt.Printf("%v\n", guardBuy)
|
||
})
|
||
// 【可选】设置弹幕服务器，不设置就会从 api 获取服务器地址
|
||
// 该函数设置服务器为 wss://broadcastlv.chat.bilibili.com/sub
|
||
c.UseDefaultHost()
|
||
// 启动
|
||
err := c.ConnectAndStart()
|
||
if err != nil {
|
||
fmt.Println(err)
|
||
}
|
||
fmt.Println("started")
|
||
// 需要自行阻塞什么方法都可以
|
||
select {}
|
||
}
|
||
|
||
```
|
||
|
||
### 进阶使用
|
||
|
||
#### 监听自定义事件
|
||
|
||
通过自定义监听事件，可以支持更多事件处理。
|
||
其中，`cmd`为要监听的`cmd`名（下附常见`cmd`名）， `handler`为接收事件消息（字符串的JSON）的函数
|
||
**注意**
|
||
优先执行自定义 eventHandler ，会**覆盖库内自带的 handler**
|
||
例如，如果你`RegisterCustomEventHandler("DANMU_MSG", ...`
|
||
那么你使用`OnDanmaku`则不会再生效
|
||
```go
|
||
func (c *Client) RegisterCustomEventHandler(cmd string, handler func(s string))
|
||
```
|
||
```go
|
||
// 监听自定义事件
|
||
c.RegisterCustomEventHandler("STOP_LIVE_ROOM_LIST", func(s string) {
|
||
data := gjson.Get(s, "data").String()
|
||
fmt.Printf(data)
|
||
})
|
||
```
|
||
|
||
### 常见 CMD
|
||
注：来自blivedm
|
||
```python
|
||
cmd = (
|
||
'INTERACT_WORD', 'ROOM_BANNER', 'ROOM_REAL_TIME_MESSAGE_UPDATE', 'NOTICE_MSG', 'COMBO_SEND',
|
||
'COMBO_END', 'ENTRY_EFFECT', 'WELCOME_GUARD', 'WELCOME', 'ROOM_RANK', 'ACTIVITY_BANNER_UPDATE_V2',
|
||
'PANEL', 'SUPER_CHAT_MESSAGE_JPN', 'USER_TOAST_MSG', 'ROOM_BLOCK_MSG', 'LIVE', 'PREPARING',
|
||
'room_admin_entrance', 'ROOM_ADMINS', 'ROOM_CHANGE'
|
||
)
|
||
```
|