视频快照

获取视频快照1（用于进度条预览）

api.bilibili.com/x/player/videoshot

方式:GET

参数：

参数名	内容	必要性	备注
aid	视频avID	必要
cid	分P CID	非必要	无为1P
index	json数组截取时间表	非必要	1需要 0不需要

json回复：

字段	类型	内容	备注
code	num	返回值	0成功 40001请求错误 40003无视频
message	str	错误信息	默认为0
ttl	num	1	作用尚不明确
data	obj	信息本体

data 对象：

字段	类型	内容	备注
pvdata	str	bin格式截取时间表url
img_x_len	num	每行图片数	一般为10
img_y_len	num	每列图片数	一般为10
img_x_size	num	每张图片长	一般为160
img_y_size	num	每张图片宽	一般为90
image	array	图片拼版
index	array	json数组格式截取时间表	无为空

image 数组（类型：str）：

项	内容	备注
0	图片拼版1 url	jpg
n	图片拼版(n+1) url	第一张拼版占满时延续第二张
……	……	……

index 数组（类型：num）：

项	内容	备注
0	恒为0
1	图片1 截取时间	视频0秒截取时间
n	图片n 截取时间	单位为秒
……	……	单位为秒

示例：

http://api.bilibili.com/x/player/videoshot?aid=26273789&index=1

{
	"code": 0,
	"message": "0",
	"ttl": 1,
	"data": {
		"pvdata": "//i0.hdslb.com/bfs/videoshot/49075258.bin",
		"img_x_len": 10,
		"img_y_len": 10,
		"img_x_size": 160,
		"img_y_size": 90,
		"image": ["//i0.hdslb.com/bfs/videoshot/49075258.jpg", "//i0.hdslb.com/bfs/videoshot/49075258-1.jpg"],
		"index": [0, 0, 8, 14, 19, 25, 34, 40, 46, 56, 63, 70, 80, 87, 93, 100, 109, 117, 124, 133, 142, 148, 156, 164, 171, 179, 184, 192, 198, 206, 214, 223, 232, 239, 246, 254, 261, 269, 275, 283, 289, 299, 305, 310, 315, 322, 330, 339, 348, 358, 364, 371, 376, 382, 391, 404, 413, 421, 426, 434, 441, 452, 458, 463, 473, 479, 491, 497, 504, 514, 521, 528, 533, 540, 546, 552, 558, 567, 575, 586, 591, 602, 609, 615, 623, 629, 639, 647, 653, 658, 664, 670, 675, 684, 691, 698, 713, 724, 729, 737, 743, 754, 762, 772, 779, 784, 797, 803, 810, 817, 825, 834, 845, 851, 857, 867, 878, 888, 896, 903, 909, 914, 919, 928, 935, 944, 958, 970, 977, 988, 996, 1004, 1011, 1018, 1026, 1035, 1041, 1048, 1055, 1063, 1073, 1079, 1086, 1095, 1106, 1111, 1124, 1135, 1147, 1153, 1159, 1165, 1171, 1184, 1198, 1209, 1215, 1221, 1228, 1236, 1242, 1253, 1258, 1269, 1276, 1284, 1289, 1300, 1306, 1315, 1321, 1328, 1340, 1347, 1354, 1361, 1366, 1371, 1383, 1390, 1396, 1403, 1415]
	}
}

获取视频快照2 （用于封面预览）

api.bilibili.com/pvideo 方式:GET

内容与「获取视频快照1」加参数「index」=1相同，但url带有转义，仅限第1P

参数名	内容	必要性	备注
aid	视频avID	必要

json回复：

字段	类型	内容	备注
code	num	返回值	0成功 40001请求错误 -404无视频
message	str	错误信息	默认为0
ttl	num	1	作用尚不明确
data	obj	信息本体

data 对象：

字段	类型	内容	备注
pvdata	str	bin格式截取时间表url
img_x_len	num	每行图片数	一般为10
img_y_len	num	每列图片数	一般为10
img_x_size	num	每张图片长	一般为160
img_y_size	num	每张图片宽	一般为90
image	array	图片拼版
index	array	json数组格式截取时间表	无为空

image 数组（类型：str）：

项	内容	备注
0	图片拼版1 url	jpg
n	图片拼版(n+1) url	第一张拼版占满时延续第二张
……	……	……

index 数组（类型：num）：

项	内容	备注
0	恒为0
1	图片1 截取时间	视频0秒截取时间
n	图片n 截取时间	单位为秒
……	……	单位为秒

示例：

http://api.bilibili.com/pvideo?aid=26273789

{
	"code": 0,
	"message": "0",
	"ttl": 1,
	"data": {
		"pvdata": "\/\/i0.hdslb.com\/bfs\/videoshot\/49075258.bin",
		"img_x_len": 10,
		"img_y_len": 10,
		"img_x_size": 160,
		"img_y_size": 90,
		"image": ["\/\/i0.hdslb.com\/bfs\/videoshot\/49075258.jpg", "\/\/i0.hdslb.com\/bfs\/videoshot\/49075258-1.jpg"],
		"index": [0, 0, 8, 14, 19, 25, 34, 40, 46, 56, 63, 70, 80, 87, 93, 100, 109, 117, 124, 133, 142, 148, 156, 164, 171, 179, 184, 192, 198, 206, 214, 223, 232, 239, 246, 254, 261, 269, 275, 283, 289, 299, 305, 310, 315, 322, 330, 339, 348, 358, 364, 371, 376, 382, 391, 404, 413, 421, 426, 434, 441, 452, 458, 463, 473, 479, 491, 497, 504, 514, 521, 528, 533, 540, 546, 552, 558, 567, 575, 586, 591, 602, 609, 615, 623, 629, 639, 647, 653, 658, 664, 670, 675, 684, 691, 698, 713, 724, 729, 737, 743, 754, 762, 772, 779, 784, 797, 803, 810, 817, 825, 834, 845, 851, 857, 867, 878, 888, 896, 903, 909, 914, 919, 928, 935, 944, 958, 970, 977, 988, 996, 1004, 1011, 1018, 1026, 1035, 1041, 1048, 1055, 1063, 1073, 1079, 1086, 1095, 1106, 1111, 1124, 1135, 1147, 1153, 1159, 1165, 1171, 1184, 1198, 1209, 1215, 1221, 1228, 1236, 1242, 1253, 1258, 1269, 1276, 1284, 1289, 1300, 1306, 1315, 1321, 1328, 1340, 1347, 1354, 1361, 1366, 1371, 1383, 1390, 1396, 1403, 1415]
	}
}

图片拼版

以160x90像素为一张，横向10张，纵向10张，从左到右从上到下进行裁剪

图1为0s，图2为8s，图3为14s，以此类推……

示例拼版图片url：http://i0.hdslb.com/bfs/videoshot/49075258.jpg

bin格式截取时间表

bin的内容为uint16数组，与json数组格式一一对应

0第项恒为0，从第1项开始作为截取图片的时间（秒）

示例bin格式截取时间表url：http://i0.hdslb.com/bfs/videoshot/49075258.bin

0000000 0000 0000 0800 0e00 1300 1900 2200 2800
0000010 2e00 3800 3f00 4600 5000 5700 5d00 6400
0000020 6d00 7500 7c00 8500 8e00 9400 9c00 a400
0000030 ab00 b300 b800 c000 c600 ce00 d600 df00
0000040 e800 ef00 f600 fe00 0501 0d01 1301 1b01
0000050 2101 2b01 3101 3601 3b01 4201 4a01 5301
0000060 5c01 6601 6c01 7301 7801 7e01 8701 9401
0000070 9d01 a501 aa01 b201 b901 c401 ca01 cf01
0000080 d901 df01 eb01 f101 f801 0202 0902 1002
0000090 1502 1c02 2202 2802 2e02 3702 3f02 4a02
00000a0 4f02 5a02 6102 6702 6f02 7502 7f02 8702
00000b0 8d02 9202 9802 9e02 a302 ac02 b302 ba02
00000c0 c902 d402 d902 e102 e702 f202 fa02 0403
00000d0 0b03 1003 1d03 2303 2a03 3103 3903 4203
00000e0 4d03 5303 5903 6303 6e03 7803 8003 8703
00000f0 8d03 9203 9703 a003 a703 b003 be03 ca03
0000100 d103 dc03 e403 ec03 f303 fa03 0204 0b04
0000110 1104 1804 1f04 2704 3104 3704 3e04 4704
0000120 5204 5704 6404 6f04 7b04 8104 8704 8d04
0000130 9304 a004 ae04 b904 bf04 c504 cc04 d404
0000140 da04 e504 ea04 f504 fc04 0405 0905 1405
0000150 1a05 2305 2905 3005 3c05 4305 4a05 5105
0000160 5605 5b05 6705 6e05 7405 7b05 8705

8.5 KiB Raw Blame History Unescape Escape

视频快照

获取视频快照1（用于进度条预览）

获取视频快照2 （用于封面预览）

图片拼版

bin格式截取时间表

8.5 KiB

Raw Blame History