Skip to content

Commit

Permalink
add readme
Browse files Browse the repository at this point in the history
  • Loading branch information
4t145 committed Jul 15, 2023
1 parent 4ac3cd3 commit cc1882c
Showing 1 changed file with 80 additions and 0 deletions.
80 changes: 80 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
# bilive-danmaku
这个库提供模拟bilibili直播的wss连接的功能,持续迭代中

关于发送弹幕等主动api,可以看我这个仓库: https://github.com/4t145/bilibili-client

## 使用
### 通过websocket
通过使用 https://github.com/4t145/rudanmaku-core

这使你可以通过ws来获取事件,计划在未来支持ipc通讯(uds for linux,命名管道 for windows)

`Cargo.toml`中加入
```toml
bilive-danmaku = { version = "0.3", features = ["rt_tokio"] }
```
使用
```rust
use bilive_danmaku::Connector;
use futures_util::StreamExt;

async fn tokio_main() {
let roomid = 851181;
let connector = Connector::init(roomid).await.unwrap();
let mut stream = connector.connect().await.unwrap();
while let Some(maybe_evt) = stream.next().await {
match maybe_evt {
Ok(evt) => {
log::info!("{:?}", evt);
}
Err(e) => {
log::warn!("{:?}", e);
}
}
}
stream.abort();
}
```

数据类型在`model`模块中, 事件类型在`event`模块中
```rust
use model::{User, FansMedal};
use event::Event as BiliEvent;
```
## 已经支持的事件
[参考这个文件](./src/event.rs)

可参考:
- [命令原始数据](./src/tests/mock/cmd/)

## feature flag
|flag|功能|
|:---:|:--:|
|`event`|只启用model和event,不包含连接,默认启用|
|`rt_tokio`|使用tokio连接直播间|
|`rt_wasm`|运行在wasm直播间|
|`bincode`|启用bincode正反序列化|
|`json`|启用json正反序列化|

默认只启用`event`
比如你想把收到的消息序列化为json格式,启用
```toml
[dependencies.bilive-danmaku]
# ****
features = ["rt_tokio", "json"]
```

# 提交代码
提交代码请fork一份,在自己的那一份签出新分支,然后提交到master分支

提交前请进行格式化和clippy check,可以直接运行根目录的脚本文件

windows
```shell
./fix-all
```

linux
```bash
bash fix-all.sh
```

0 comments on commit cc1882c

Please sign in to comment.