Northern_Lights/bilibili-API-collect
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
3b5e5e0658
bilibili-API-collect/docs/live/live_stream.md
TES286 3b5e5e0658
更新直播流文档
2024-08-04 01:48:24 +08:00

12 KiB
Raw Blame History

直播间视频流

根据真实直播间号获取直播视频流链接

https://api.live.bilibili.com/xlive/web-room/v2/index/getRoomPlayInfo ?room_id=23016450 &no_playurl=0 &mask=1 &qn=0 &platform=web &protocol=0,1 &format=0,1,2 &codec=0,1,2 &dolby=5 &panorama=1

请求方式：GET

url参数：

参数名 类型 内容 必要性 备注
room_id num 直播间号 必要 房间号
no_playurl num 无视频流 非必要 置0才有视频流
mask num - - 作用未知，未观察到响应改变 默认1
qn num 质量 非必要 3000杜比 20000 4K 10000 原画
400 蓝光 250 超清 150 高清
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回复：

由于返回字段数过多，故在响应示例中标记

该示例作出合理修改，以便于阅读，相关情况请自行构造请求

查看响应示例 
{
  "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为开播，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
  }
}

视频取流

  • 取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）:

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
}

最终从响应的链接随意选择一个即可，按照一般m3u8处理即可，至于编码格式之类问题，相关的下载器应该都能处理，或者自己根据需要在json回应中挑选

另外，有注意到部分链接可能包含客户端ip地址，在这方面（现在或者将来）可能有检测

根据真实直播间号获取直播视频流 （旧）

https://api.live.bilibili.com/room/v1/Room/playUrl

请求方式：GET

url参数：

参数名 类型 内容 必要性 备注
cid num 目标真实直播间号 必要 直播间的room_id（非短号）
platform str 直播流格式 非必要 h5：hls方式
web：http-flv方式
默认为http-flv方式
quality num 画质 非必要 qn与quality任选其一
2：流畅
3：高清
4：原画
qn str 画质 非必要 qn与quality任选其一
80：流畅
150：高清
400：蓝光
10000：原画
20000：4K
30000：杜比

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-400：参数错误
19002003：房间信息不存在
message str 错误信息 默认为0
ttl str 1
data obj 信息本体

data对象：

字段 类型 内容 备注
current_quality num 当前画质代码qn
accept_quality array 可选画质数参数
current_qn num 当前画质代码quality
quality_description array 可选画质参数quality
durl array 直播流url组

accept_quality数组：

项 类型 内容 备注
0 str qn画质代码1
n str qn画质代码(n+1)
…… str …… ……

quality_description数组：

项 类型 内容 备注
0 obj 画质代码1
n obj 画质代码(n+1)
…… obj …… ……

quality_description数组中的对象：

字段 类型 内容 备注
qn num 画质代码
desc str 该代码对应的画质名称

durl数组：

项 类型 内容 备注
0 obj 主线服务器
n obj 备线n服务器
…… obj …… ……

durl数组中的对象：

字段 类型 内容 备注
url str 直播流url flv或m3u8格式
注：带有转义
length num 0 作用尚不明确
order num 服务器线路序号
stream_type num 0 作用尚不明确
p2p_type num 0 作用尚不明确

示例：

查询直播间cid=14073662的直播间信息

curl -G 'https://api.live.bilibili.com/room/v1/Room/playUrl' \
--data-urlencode 'cid=14073662' \
--data-urlencode 'qn=10000' \
--data-urlencode 'platform=web'
查看响应示例： 
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "current_quality": 3,
    "accept_quality": ["4", "3", "2"],
    "current_qn": 3,
    "quality_description": [
      {
        "qn": 4,
        "desc": "原画"
      },
      {
        "qn": 3,
        "desc": "高清"
      },
      {
        "qn": 2,
        "desc": "流畅"
      }
    ],
    "durl": [
      {
        "url": "https://d1--cn-gotcha04.bilivideo.com/live-bvc/601131/live_14073662_bs_3699814_1500.flv?cdn=cn-gotcha04&expires=1602496530&len=0&oi=1939228219&pt=&qn=150&trid=e6540d81a5d04c2ea459c46ebe77472a&sigparams=cdn,expires,len,oi,pt,qn,trid&sign=20e4ac695fbdd1d11d5dac4f93caa783&ptype=0&src=9&sl=1&order=1",
        "length": 0,
        "order": 1,
        "stream_type": 0,
        "p2p_type": 0
      },
      {
        "url": "https://d1--cn-gotcha01.bilivideo.com/live-bvc/757951/live_14073662_bs_3699814_1500.flv?cdn=cn-gotcha01&expires=1602496530&len=0&oi=1939228219&pt=&qn=150&trid=e6540d81a5d04c2ea459c46ebe77472a&sigparams=cdn,expires,len,oi,pt,qn,trid&sign=9deea67bb9e9c1f0fa3886a34aa09473&ptype=0&src=9&sl=1&order=2",
        "length": 0,
        "order": 2,
        "stream_type": 0,
        "p2p_type": 0
      },
      {
        "url": "https://d1--cn-gotcha04.bilivideo.com/live-bvc/982058/live_14073662_bs_3699814_1500.flv?cdn=cn-gotcha04&expires=1602496530&len=0&oi=1939228219&pt=&qn=150&trid=e6540d81a5d04c2ea459c46ebe77472a&sigparams=cdn,expires,len,oi,pt,qn,trid&sign=8753b270960034660184d975d86c0161&ptype=0&src=9&sl=1&order=3",
        "length": 0,
        "order": 3,
        "stream_type": 0,
        "p2p_type": 0
      },
      {
        "url": "https://d1--cn-gotcha04.bilivideo.com/live-bvc/139554/live_14073662_bs_3699814_1500.flv?cdn=cn-gotcha04&expires=1602496530&len=0&oi=1939228219&pt=&qn=150&trid=e6540d81a5d04c2ea459c46ebe77472a&sigparams=cdn,expires,len,oi,pt,qn,trid&sign=cf93474e923c9ba8288c45d954f81045&ptype=0&src=9&sl=1&order=4",
        "length": 0,
        "order": 4,
        "stream_type": 0,
        "p2p_type": 0
      }
    ]
  }
}