diff --git a/README.md b/README.md index ebf1082..7700f64 100644 --- a/README.md +++ b/README.md @@ -116,7 +116,7 @@ - 已购课程 - 分区推荐列表 - 操作 - - 播放&下载地址（视频流） + - [播放&下载地址（视频流）](cheese/videostream_url.md)√ - [直播](live) - [直播间基本信息](live/info.md)x - [直播分区](live/live_area.md)× diff --git a/cheese/info.md b/cheese/info.md index 7018e13..a4bafcd 100644 --- a/cheese/info.md +++ b/cheese/info.md @@ -129,7 +129,7 @@ | page | num | 1 | | | play | num | 课程分集播放量 | | | release_date | num | 课程分集发布时间 | 时间戳 | -| status | num | 分集属性 | 1：可免费试看
2：需要付费观看 | +| status | num | 分集权限属性 | 1：可观看
2：不可观看 | | title | str | 课程分集标题 | | | watched | bool | 是否观看该集 | **需要登录（SESSDATA）且referer为`https://www.bilibili.com`**
false：未观看
true：已观看 | | watchedHistory | num | 该集观看历史 | **需要登录（SESSDATA）且referer为`https://www.bilibili.com`** | @@ -490,7 +490,7 @@ http://api.bilibili.com/pugv/view/web/season?season_id=61 | page | num | 1 | | | play | num | 课程分集播放量 | | | release_date | num | 课程分集发布时间 | 时间戳 | -| status | num | 分集属性 | 1：可免费试看
2：需要付费观看 | +| status | num | 分集权限属性 | 1：可观看
2：不可观看 | | title | str | 课程分集标题 | | | watched | bool | 是否观看该集 | **需要登录（SESSDATA）且referer为`https://www.bilibili.com`**
false：未观看
true：已观看 | | watchedHistory | num | 该集观看历史 | **需要登录（SESSDATA）且referer为`https://www.bilibili.com`** | diff --git a/cheese/videostream_url.md b/cheese/videostream_url.md new file mode 100644 index 0000000..2b3bb75 --- /dev/null +++ b/cheese/videostream_url.md @@ -0,0 +1,237 @@ +# 课程视频流URL + +## 获取课程视频流URL + +> http://api.bilibili.com/pugv/player/web/playurl + +*方式:GET* + +本接口为课程视频专用，故与普通视频不互通 + +获取非试看课程视频及720P以上清晰度视频时需要登录(SESSDATA)购买的课程也需要使用登录进行鉴权 + +高帧率（码率）视频需要带有大会员的账号token(SESSDATA) + +获取的url有效时间为120min，超时失效需要重新获取 + +**部分视频**会有**分段**，需要特别注意 + +**参数：** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ---- | -------------- | ------ | ------------------------------------------------------------ | +| aid | url | 课程avID | 必要 | | +| ep_id | url | 课程epID | 必要 | | +| cid | url | 视频CID | 必要 | | +| qn | url | 视频清晰度选择 | 非必要 | 未登录默认32（480P）
登录默认64（720P）
**值含义见下表** | + +分辨率代码： + +| 值 | 含义 | +| ---- | ---------------------- | +| 16 | 360P 流畅 | +| 32 | 480P 清晰 | +| 64 | 720P 高清（登录） | +| 74 | 720P60 高清（大会员） | +| 80 | 1080P 高清（登录） | +| 112 | 1080P+ 高清（大会员） | +| 116 | 1080P60 高清（大会员） | +| 120 | 4K 超清（大会员） | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ------------------------------------------------------------ | +| code | num | 返回值 | 0：成功
-400：请求错误
-404：无视频
-403：权限不足（未购买） | +| message | str | 错误信息 | 默认为success | +| data | obj | 数据本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------------------ | ------ | ---------------------- | ---------------------------------------- | +| accept_format | str | 视频支持的分辨率的格式 | | +| code | num | 0 | | +| durl | arrary | 视频分段 | | +| seek_param | str | start | | +| no_rexcode | num | 0 | | +| format | str | 视频格式 | | +| fnval | num | 0 | | +| video_project | bool | true | | +| fnver | num | 0 | | +| message | str | 空 | | +| type | str | 视频格式 | | +| accept_quality | arrary | 视频支持的分辨率列表 | | +| quality | num | 视频分辨率代码 | **值含义见上表** | +| timelength | num | 视频长度 | 单位为毫秒
不同分辨率可能有略微差异 | +| result | str | suee | **作用尚不明确** | +| seek_type | str | offset | **作用尚不明确** | +| has_paid | bool | false | **作用尚不明确** | +| supportFormats | arrary | 视频分辨率详细列表 | | +| from | str | local | **作用尚不明确** | +| video_codecid | num | ？？？ | **作用尚不明确** | +| accept_description | arrary | 视频支持的分辨率列表 | | +| status | num | 0 | **作用尚不明确** | + +`data`中的`durl`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ----------------- | ---- | +| 0 | obj | 视频分段1信息 | | +| n | obj | 视频分段(n+1)信息 | | +| …… | obj | …… | | + +`durl`数组中的对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ------ | ------------ | ---------------------------------- | +| size | num | 视频大小 | 单位为Byte | +| ahead | str | 空 | 作用尚不明确 | +| length | num | 视频长度 | 单位为毫秒 | +| vhead | str | 空 | 作用尚不明确 | +| backup_url | arrary | 备用视频流 | | +| url | str | 视频流url | **重要**
链接有效时间为120min | +| order | num | 视频分段序号 | 某些视频会分为多个片段 | + +`durl`数组中的对象中的`backup_url`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------- | ---------------- | +| 0 | str | 备用视频流url | 有效时间为120min | + +`data`中的`supportFormats`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------------- | ---- | +| 0 | obj | 分辨率详细信息1 | | +| n | obj | 分辨率详细信息(n+1) | | +| …… | obj | …… | …… | + +`supportFormats`数组中的对象： + +| 字段 | 类型 | 内容 | 备注 | +| ----------- | ---- | ---------- | ---- | +| format | str | 分辨率名称 | | +| description | atr | 分辨率备注 | | +| quality | num | 分辨率代码 | | + +`data`中的`accept_description`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------------- | ---- | +| 0 | str | 分辨率名称1 | | +| n | str | 分辨率名称(n+1) | | +| …… | str | …… | …… | + +**示例：** + +获取课程`ep790`（CID=`132105993`，avID=`76973173`）的视频流url，清晰度为1080P60 + +http://api.bilibili.com/pugv/player/web/playurl?ep_id=790&avid=76973173&cid=132105993&qn=116 + +```json +{ + "code": 0, + "data": { + "accept_format": "flv_p60,flv720_p60,flv,flv720,flv480,flv360", + "code": 0, + "durl": [ + { + "size": 1105854161, + "ahead": "", + "length": 2222204, + "vhead": "", + "backup_url": [ + "https://upos-sz-mirrorks3c.bilivideo.com/upgcxcode/93/59/132105993/132105993_da2-1-116.flv?e=ig8euxZM2rNcNbNghzTBhwdlhbNz7bUVhoNvNC8BqJIzNbfqXBvEqxTEto8BTrNvN0GvT90W5JZMkX_YN0MvXg8gNEV4NC8xNEV4N03eN0B5tZlqNxTEto8BTrNvNeZVuJ10Kj_g2UB02J0mN0B5tZlqNCNEto8BTrNvNC7MTX502C8f2jmMQJ6mqF2fka1mqx6gqj0eN0B599M=&uipk=5&nbs=1&deadline=1591596728&gen=playurl&os=ks3cbv&oi=606633803&trid=76bea9a9e56f4cb89a9aff2f8213c9acu&platform=pc&upsig=b271bf493bff32ffe62969582c8d18b4&uparams=e,uipk,nbs,deadline,gen,os,oi,trid,platform&mid=0&orderid=1,2&logo=40000000" + ], + "url": "https://upos-sz-mirrorks3.bilivideo.com/upgcxcode/93/59/132105993/132105993_da2-1-116.flv?e=ig8euxZM2rNcNbNghzTBhwdlhbNz7bUVhoNvNC8BqJIzNbfqXBvEqxTEto8BTrNvN0GvT90W5JZMkX_YN0MvXg8gNEV4NC8xNEV4N03eN0B5tZlqNxTEto8BTrNvNeZVuJ10Kj_g2UB02J0mN0B5tZlqNCNEto8BTrNvNC7MTX502C8f2jmMQJ6mqF2fka1mqx6gqj0eN0B599M=&uipk=5&nbs=1&deadline=1591596728&gen=playurl&os=ks3bv&oi=606633803&trid=76bea9a9e56f4cb89a9aff2f8213c9acu&platform=pc&upsig=6a8ae3711bd0bb2a484ec2427d659b14&uparams=e,uipk,nbs,deadline,gen,os,oi,trid,platform&mid=0&orderid=0,2&logo=80000000", + "order": 1, + "md5": "" + } + ], + "seek_param": "start", + "no_rexcode": 0, + "format": "flv_p60", + "fnval": 0, + "video_project": true, + "fnver": 0, + "message": "", + "type": "FLV", + "accept_quality": [ + 116, + 74, + 80, + 64, + 32, + 16 + ], + "quality": 116, + "timelength": 2222204, + "result": "suee", + "seek_type": "offset", + "has_paid": false, + "supportFormats": [ + { + "format": "flv_p60", + "description": "高清 1080P60", + "quality": 116 + }, + { + "format": "flv720_p60", + "description": "高清 720P60", + "quality": 74 + }, + { + "format": "flv", + "description": "高清 1080P", + "quality": 80 + }, + { + "format": "flv720", + "description": "高清 720P", + "quality": 64 + }, + { + "format": "flv480", + "description": "清晰 480P", + "quality": 32 + }, + { + "format": "flv360", + "description": "流畅 360P", + "quality": 16 + } + ], + "from": "local", + "video_codecid": 7, + "accept_description": [ + "高清 1080P60", + "高清 720P60", + "高清 1080P", + "高清 720P", + "清晰 480P", + "流畅 360P" + ], + "status": 0 + }, + "message": "success" +} +``` + + + +## 视频的获取 + +将`data`.`durl`.`[1-n]`.`url`或`data`.`durl`.`[1-n]`.`backup_url`.`[0]`中的内容作为url进行GET操作, 如果有多个视频, 需要手动合并处理 + +需要验证Header中`referer`在 `http://www.bilibili.com`或`https://www.bilibili.com`域名下 + +**无referer或错误的情况会返回403 Forbidden**故无法获取 + +**以上述视频url为例：** + +wget --referer "http://www.bilibili.com" "https://upos-sz-mirrorks3c.bilivideo.com/upgcxcode/93/59/132105993/132105993_da2-1-116.flv?e=ig8euxZM2rNcNbNghzTBhwdlhbNz7bUVhoNvNC8BqJIzNbfqXBvEqxTEto8BTrNvN0GvT90W5JZMkX_YN0MvXg8gNEV4NC8xNEV4N03eN0B5tZlqNxTEto8BTrNvNeZVuJ10Kj_g2UB02J0mN0B5tZlqNCNEto8BTrNvNC7MTX502C8f2jmMQJ6mqF2fka1mqx6gqj0eN0B599M=&uipk=5&nbs=1&deadline=1591596728&gen=playurl&os=ks3cbv&oi=606633803&trid=76bea9a9e56f4cb89a9aff2f8213c9acu&platform=pc&upsig=b271bf493bff32ffe62969582c8d18b4&uparams=e,uipk,nbs,deadline,gen,os,oi,trid,platform&mid=0&orderid=1,2&logo=40000000" -O video.flv + +回复正文将返回一个flv文件的数据 \ No newline at end of file diff --git a/video/videostream_url.md b/video/videostream_url.md index aa4f1e4..fe62cab 100644 --- a/video/videostream_url.md +++ b/video/videostream_url.md @@ -53,27 +53,27 @@ | 字段 | 类型 | 内容 | 备注 | | ------------------ | ------ | ------------------------ | ---------------------------------------- | -| from | str | local | 作用尚不明确 | -| result | str | suee | 作用尚不明确 | -| message | str | 空 | 作用尚不明确 | +| from | str | local | **作用尚不明确** | +| result | str | suee | **作用尚不明确** | +| message | str | 空 | **作用尚不明确** | | quality | num | 视频分辨率代码 | **值含义见上表** | | format | str | 视频格式 | | | timelength | num | 视频长度 | 单位为毫秒
不同分辨率可能有略微差异 | | accept_format | str | 视频支持的分辨率的格式 | | | accept_description | arrary | 视频支持的分辨率列表 | | | accept_quality | arrary | 视频支持的分辨率代码列表 | **值含义见上表** | -| video_codecid | num | ？？？ | 作用尚不明确 | -| seek_param | str | start | 作用尚不明确 | -| seek_type | str | offset | 作用尚不明确 | -| durl | arrary | 视频流地址信息 | | +| video_codecid | num | ？？？ | **作用尚不明确** | +| seek_param | str | start | **作用尚不明确** | +| seek_type | str | offset | **作用尚不明确** | +| durl | arrary | 视频分段 | | `data`中的`accept_description`数组： -| 项 | 类型 | 内容 | 备注 | -| ---- | ---- | ----------- | ---- | -| 0 | str | 分辨率1 | | -| n | str | 分辨率(n+1) | | -| …… | str | …… | …… | +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------------- | ---- | +| 0 | str | 分辨率名称1 | | +| n | str | 分辨率名称(n+1) | | +| …… | str | …… | …… | `data`中的`accept_quality`数组： @@ -91,7 +91,7 @@ | n | obj | 视频分段(n+1)信息 | | | …… | obj | …… | | -`data`中的`durl`数组中的对象： +`durl`数组中的对象： | 字段 | 类型 | 内容 | 备注 | | ---------- | ------ | ------------ | ---------------------------------- | @@ -103,7 +103,7 @@ | url | str | 视频流url | **重要**
链接有效时间为120min | | backup_url | arrary | 备用视频流 | | -`data`中的`durl`数组中的对象中的`backup_url`数组： +`durl`数组中的对象中的`backup_url`数组： | 项 | 类型 | 内容 | 备注 | | ---- | ---- | ------------- | ---------------- |