190 lines
6.4 KiB
Markdown
190 lines
6.4 KiB
Markdown
# 直播间视频流
|
||
|
||
## 根据真实直播间号获取直播视频流链接
|
||
|
||
> https://api.live.bilibili.com/xlive/web-room/v2/index/getRoomPlayInfo
|
||
|
||
*请求方式：GET*
|
||
|
||
**url参数：**
|
||
|
||
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||
| ---------- | ----- | -------- | ------ | ---- |
|
||
| room_id | num | 直播间号 | 必要 | 房间号 |
|
||
| no_playurl | num | 无视频流 | 非必要 | 置`0`才有视频流 |
|
||
| mask | num | （？） | 非必要 | 作用未知，未观察到响应改变 默认1 |
|
||
| qn | num | 质量 | 非必要 | 3000杜比 20000 4K 10000 原画 <br /> 400 蓝光 250 超清 150 高清 <br /> 0 应该是默认 |
|
||
| platform | str | 平台 | 非必要 | 参考：`web` |
|
||
| protocol | num[] | 协议 | 非必要 | 参考：`0,1` |
|
||
| format | num[] | 格式 | 非必要 | 参考：`0,1,2` |
|
||
| codec | num[] | 编码 | 非必要 | 参考：`0,1,2` |
|
||
| dolby | num | 杜比 | 非必要 | 参考：`5` |
|
||
| panorama | num | 环绕音 | 非必要 | 参考：`1` |
|
||
|
||
**json回复：**
|
||
|
||
> 由于返回字段数过多，故在响应示例中标记
|
||
>
|
||
> 该示例作出合理修改，以便于阅读，相关情况请自行构造请求
|
||
|
||
<details>
|
||
<summary>查看响应示例及响应含义</summary>
|
||
|
||
请求：
|
||
|
||
```bash
|
||
curl -G 'https://api.live.bilibili.com/xlive/web-room/v2/index/getRoomPlayInfo' \
|
||
--data-urlencode 'room_id=123456789' \ # 请自行替换对应房间号
|
||
--data-urlencode 'qn=0' \
|
||
--data-urlencode 'platform=web'\
|
||
--data-urlencode 'protocol=0,1' \
|
||
--data-urlencode 'format=0,1,2' \
|
||
--data-urlencode 'codec=0,1,2' \
|
||
--data-urlencode 'dolby=5' \
|
||
--data-urlencode 'panorama=1' \
|
||
--header 'accept: application/json'
|
||
```
|
||
|
||
响应：
|
||
|
||
```jsonc
|
||
{
|
||
"code": 0, // 标记是否成功
|
||
"message": "0", // 错误信息（如果有），人类可读
|
||
"ttl": 1,
|
||
"data": { // 主体部分，如果请求错误则为 `null`
|
||
"room_id": 132465798, // 同请求参数同名
|
||
"short_id": 0, // 房间短id
|
||
"uid": 132465798, // 主播用户id （就是主页链接那个https://space.bilibili.com/<uid>）
|
||
"is_hidden": false, // 是否隐藏
|
||
"is_locked": false, // 是否锁定
|
||
"is_portrait": false,
|
||
"live_status": 1, // 直播状态：1为开播，2为未开播，0为下播
|
||
"hidden_till": 0, // 隐藏直到（目前未找到相关样本）
|
||
"lock_till": 0, // 同上，锁定直到
|
||
"encrypted": false,
|
||
"pwd_verified": true,
|
||
"live_time": 1722697729,
|
||
"room_shield": 0,
|
||
"all_special_types": [],
|
||
"playurl_info": { // 播放链接
|
||
"conf_json": "{\"cdn_rate\":10000,\"report_interval_sec\":150}",
|
||
"playurl": { // 播放链接
|
||
"cid": 32497242,
|
||
"g_qn_desc": [ // 清晰度描述（推测用于UI展示）
|
||
{
|
||
"qn": 30000,
|
||
"desc": "杜比",
|
||
"hdr_desc": "",
|
||
"attr_desc": null
|
||
},
|
||
{
|
||
"qn": 20000,
|
||
"desc": "4K",
|
||
"hdr_desc": "",
|
||
"attr_desc": null
|
||
},
|
||
{
|
||
"qn": 10000,
|
||
"desc": "原画",
|
||
"hdr_desc": "",
|
||
"attr_desc": null
|
||
},
|
||
{
|
||
"qn": 400,
|
||
"desc": "蓝光",
|
||
"hdr_desc": "",
|
||
"attr_desc": null
|
||
}
|
||
// ...
|
||
],
|
||
"stream": [ // 直播流信息
|
||
{
|
||
"protocol_name": "http_stream", // 协议信息
|
||
"format": [
|
||
{
|
||
"format_name": "flv", // 格式信息
|
||
"codec": [
|
||
{
|
||
"codec_name": "avc", // 编码格式
|
||
"current_qn": 10000, // 当前质量
|
||
"accept_qn": [ // 应许质量
|
||
10000
|
||
],
|
||
"base_url": "/live-bvc/123465789/live_123_456.flv?", // 详细见下取流部分
|
||
"url_info": [
|
||
{
|
||
"host": "https://cn-cq-cm-01-30.bilivideo.com", // 详细见下取流部分
|
||
"extra": "expires=172270...rc=puv3", // 详细见下取流部分
|
||
"stream_ttl": 0
|
||
}
|
||
],
|
||
"hdr_qn": null,
|
||
"dolby_type": 0,
|
||
"attr_name": ""
|
||
}
|
||
],
|
||
"master_url": ""
|
||
}
|
||
]
|
||
}
|
||
// 其他部分类似，省略
|
||
],
|
||
"p2p_data": { // p2p 相关数据
|
||
"p2p": true,
|
||
"p2p_type": 1,
|
||
"m_p2p": false,
|
||
"m_servers": null
|
||
},
|
||
"dolby_qn": null
|
||
}
|
||
},
|
||
"official_type": 0,
|
||
"official_room_id": 0,
|
||
"risk_with_delay": 0
|
||
}
|
||
}
|
||
```
|
||
|
||
</details>
|
||
|
||
## 视频取流
|
||
|
||
- 取JSON中`data.playurl_info.playurl.stream`记做`streams`
|
||
- 对于`streams`中的每一项，取`format`其中一项（一或若干项，对应不同的编码格式）
|
||
- `format[n].codec[n]`中就是链接相关信息了，取`base_url`、`url_info[n].host`和`url_info[n].extra`
|
||
- 最终链接为 `host + base_url + extra`
|
||
|
||
示例代码（javascript）:
|
||
|
||
```javascript
|
||
function get_stream_url(data) {
|
||
let result = [];
|
||
data.data.playurl_info.playurl.stream.map((stream) =>
|
||
stream.format.map((format) =>
|
||
format.codec.map((codec) =>
|
||
codec.url_info.map((url_info) =>
|
||
result.push(url_info.host + codec.base_url + url_info.extra)
|
||
)
|
||
),
|
||
),
|
||
);
|
||
return result
|
||
}
|
||
```
|
||
|
||
示例代码（python）:
|
||
|
||
```python
|
||
def get_stream_url(data):
|
||
for stream in data['data']['playurl_info']['playurl']['stream']:
|
||
for format in stream['format']:
|
||
for codec in format['codec']:
|
||
for url_info in codec['url_info']:
|
||
yield ''.join([url_info['host'], codec['base_url'], url_info['extra']])
|
||
```
|
||
|
||
最终从响应的链接随意选择一个即可，按照一般视频流处理即可（目前发现有m3u8和flv两种格式），至于编码格式之类问题，相关的下载器应该都能处理，或者自己根据需要在json回应中挑选
|
||
|
||
另外，有注意到部分链接可能包含客户端ip地址，在这方面（现在或者将来）可能有检测
|