import{_ as e,c as r,a,b as s,d as l,e as o,w as p,r as d,o as c}from"./app-Dgsdh8A6.js";const i={};function D(u,n){const t=d("RouteLink");return c(),r("div",null,[n[30]||(n[30]=a('

播放器

web 播放器信息

web 播放器的信息接口，提供正常播放需要的元数据，包括：智能防挡弹幕、字幕、章节看点等。

https://api.bilibili.com/x/player/wbi/v2
https://api.bilibili.com/x/player/v2

请求方式：GET

URL参数:

参数名类型内容必要性备注
aidnum稿件 avid必要 (可选)aid 与 bvid 任选
bvidstr稿件 bvid必要 (可选)aid 与 bvid 任选
cidnum稿件 cid必要
season_idnum番剧 season_id不必要
ep_idnum剧集 ep_id不必要
w_ridstrWBI 签名不必要
wtsnum当前 unix 时间戳不必要

JSON回复:

根对象:

字段类型内容备注
codenum返回值0: 成功
-400: 请求错误
messagestr错误信息默认为 0
ttlnum1
dataobj数据本体

data 对象:

字段类型内容备注
aidnum视频 aid
bvidstr视频 bvid
allow_bpbool
no_sharebool禁止分享?
cidnum视频 cid
dm_maskobjwebmask 防挡字幕信息若无则没有防挡功能
subtitleobj字幕信息若无则没有字幕, 若不登陆则为空
view_pointsarray分段章节信息
ip_infoobj请求 IP 信息
login_midnum登录用户 mid
login_mid_hashstr
is_ownerbool是否为该视频 UP 主
namestr
permissionnum
level_infoobj登录用户等级信息
vipobj登录用户 VIP 信息
answer_statusnum答题状态
block_timenum封禁时间?
rolestr
last_play_timenum上次观看时间?
last_play_cidnum上次观看 cid?
now_timenum当前 UNIX 秒级时间戳
online_countnum在线人数
need_login_subtitlebool是否必须登陆才能查看字幕是的
preview_toaststr为创作付费，购买观看完整视频|购买观看
interactionobj互动视频资讯若非互动视频，则无该栏位（直接没有该键，而非栏位值为空）
optionsobj
guide_attentionany
jump_cardany
operation_cardany
online_switchobj
fawkesobj播放器相关信息?
show_switchobj
bgm_infoobj背景音乐信息
toast_blockbool
is_upower_exclusivebool是否为充电专属视频
is_upower_playbool
is_ugc_pay_previewbool
elec_high_levelobj充电专属视频信息
disable_show_up_infobool

data 对象中的 options 对象:

字段类型内容备注
is_360bool是否 360 全景视频
without_vipbool

data 对象中的 bgm_info 对象:

字段类型内容备注
music_idstr音乐 id
music_titlestr音乐标题
jump_urlstr跳转 URL

data 对象中的 dm_mask 对象 (如果有):

字段类型内容备注
cidnum视频 cid
platnum未知
fpsnumwebmask 取样 fps
timenum未知
mask_urlstrwebmask 资源 url
',18)),s("p",null,[n[1]||(n[1]=l("解析 webmask 请看 ")),o(t,{to:"/docs/danmaku/webmask.html"},{default:p(()=>n[0]||(n[0]=[l("智能防挡弹幕")])),_:1,__:[0]})]),n[31]||(n[31]=a("

data 对象中的 subtitle 对象:

字段类型内容备注
allow_submitbooltrue
lanstr""
lan_docstr""
subtitlesarray不登录为 []

subtitle 对象中的 subtitles 数组内的元素:

字段类型内容备注
ai_statusnum
ai_typenum
idnum
id_strstr和 id 不一样
is_lockbool
lanstr语言类型英文字母缩写
lan_docstr语言类型中文名称
subtitle_urlstr资源 url 地址
typenum0

data对象中的view_point 数组内的元素:

字段类型内容备注
contentstr分段章节名
fromnum分段章节起始秒数
tonum分段章节结束秒数
typenum
imgUrlstr图片资源地址
logoUrlstr""
team_typestr
team_namestr

data 对象中的 interaction 对象 (如果有):

字段类型内容备注
graph_versionnum剧情图id
msgstr未登入有机会返回 登录后才能体验全部结局哦～
error_toaststr错误信息？所有互动视频皆返回 剧情图被修改已失效，不确定有没有例外
marknum0?
need_reloadnum0?

data对象中的elec_high_level对象：

",9)),s("table",null,[n[17]||(n[17]=s("thead",null,[s("tr",null,[s("th",null,"字段"),s("th",null,"类型"),s("th",null,"内容"),s("th",null,"备注")])],-1)),s("tbody",null,[s("tr",null,[n[4]||(n[4]=s("td",null,"privilege_type",-1)),n[5]||(n[5]=s("td",null,"num",-1)),n[6]||(n[6]=s("td",null,"解锁视频所需最低定价档位的代码",-1)),s("td",null,[n[3]||(n[3]=l("见")),o(t,{to:"/docs/electric/monthly.html#%E5%85%85%E7%94%B5%E6%A1%A3%E4%BD%8D%E4%BB%A3%E7%A0%81privilege_type%E4%B8%8E%E5%AE%9A%E4%BB%B7"},{default:p(()=>n[2]||(n[2]=[l("充电档位代码与定价")])),_:1,__:[2]})])]),n[7]||(n[7]=s("tr",null,[s("td",null,"title"),s("td",null,"str"),s("td",null,"提示标题"),s("td",null,[s("code",null,"该视频为「{充电档位名称}」专属视频")])],-1)),n[8]||(n[8]=s("tr",null,[s("td",null,"sub_title"),s("td",null,"str"),s("td",null,"提示子标题"),s("td",null,[s("code",null,"开通「{充电档位定价}元档包月充电」即可观看")])],-1)),n[9]||(n[9]=s("tr",null,[s("td",null,"show_button"),s("td",null,"bool"),s("td",null,"是否显示按钮"),s("td")],-1)),n[10]||(n[10]=s("tr",null,[s("td",null,"button_text"),s("td",null,"str"),s("td",null,"按钮文本"),s("td",null,[s("code",null,"去开通")])],-1)),n[11]||(n[11]=s("tr",null,[s("td",null,"jump_url"),s("td",null,"obj"),s("td",null,"跳转url信息"),s("td",null,"详细信息有待补充")],-1)),n[12]||(n[12]=s("tr",null,[s("td",null,"intro"),s("td",null,"str"),s("td",null,"充电介绍语"),s("td")],-1)),n[13]||(n[13]=s("tr",null,[s("td",null,"open"),s("td",null,"bool"),s("td",null,"（？）"),s("td")],-1)),n[14]||(n[14]=s("tr",null,[s("td",null,"new"),s("td",null,"bool"),s("td",null,"（？）"),s("td")],-1)),n[15]||(n[15]=s("tr",null,[s("td",null,"question_text"),s("td",null,"str"),s("td",null,"（？）"),s("td")],-1)),n[16]||(n[16]=s("tr",null,[s("td",null,"qa_detail_link"),s("td",null,"str"),s("td",null,"（？）"),s("td")],-1))])]),n[32]||(n[32]=a(`

示例:

未登录, aid=1906473802

curl -G 'https://api.bilibili.com/x/player/wbi/v2' \\
--url-query 'bvid=BV1MU411S7iJ' \\
--url-query 'aid=1906473802' \\
--url-query 'cid=1625992822'
查看响应示例:
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "aid": 1906473802,
    "bvid": "BV1MU411S7iJ",
    "allow_bp": false,
    "no_share": false,
    "cid": 1625992822,
    "max_limit": 1000,
    "page_no": 1,
    "has_next": false,
    "ip_info": {
      "ip": "104.28.152.138",
      "zone_ip": " 10.163.150.25",
      "zone_id": 29409280,
      "country": "美国",
      "province": "加利福尼亚州",
      "city": "东洛杉矶"
    },
    "login_mid": 0,
    "login_mid_hash": "",
    "is_owner": false,
    "name": "",
    "permission": "0",
    "level_info": {
      "current_level": 0,
      "current_min": 0,
      "current_exp": 0,
      "next_exp": 0,
      "level_up": 0
    },
    "vip": {
      "type": 0,
      "status": 0,
      "due_date": 0,
      "vip_pay_type": 0,
      "theme_type": 0,
      "label": {
        "path": "",
        "text": "",
        "label_theme": "",
        "text_color": "",
        "bg_style": 0,
        "bg_color": "",
        "border_color": "",
        "use_img_label": false,
        "img_label_uri_hans": "",
        "img_label_uri_hant": "",
        "img_label_uri_hans_static": "",
        "img_label_uri_hant_static": ""
      },
      "avatar_subscript": 0,
      "nickname_color": "",
      "role": 0,
      "avatar_subscript_url": "",
      "tv_vip_status": 0,
      "tv_vip_pay_type": 0,
      "tv_due_date": 0,
      "avatar_icon": {
        "icon_resource": {}
      }
    },
    "answer_status": 0,
    "block_time": 0,
    "role": "",
    "last_play_time": 0,
    "last_play_cid": 0,
    "now_time": 1725002188,
    "online_count": 1,
    "need_login_subtitle": false,
    "view_points": [],
    "preview_toast": "为创作付费，购买观看完整视频|购买观看",
    "options": {
      "is_360": false,
      "without_vip": false
    },
    "guide_attention": [],
    "jump_card": [],
    "operation_card": [],
    "online_switch": {
      "enable_gray_dash_playback": "500",
      "new_broadcast": "1",
      "realtime_dm": "1",
      "subtitle_submit_switch": "1"
    },
    "fawkes": {
      "config_version": 30787,
      "ff_version": 21289
    },
    "show_switch": {
      "long_progress": false
    },
    "bgm_info": {
      "music_id": "MA436038343856245020",
      "music_title": "Unwelcome school",
      "jump_url": "https://music.bilibili.com/h5/music-detail?music_id=MA436038343856245020&cid=1625992822&aid=1906473802"
    },
    "toast_block": false,
    "is_upower_exclusive": false,
    "is_upower_play": false,
    "is_ugc_pay_preview": false,
    "elec_high_level": {
      "privilege_type": 0,
      "title": "",
      "sub_title": "",
      "show_button": false,
      "button_text": "",
      "jump_url": "",
      "intro": "",
      "new": false
    },
    "disable_show_up_info": false
  }
}

已登陆, aid=60977932

curl -G 'https://api.bilibili.com/x/player/v2' \\
--url-query 'aid=60977932' \\
--url-query 'cid=106101299' \\
-b 'SESSDATA=xxx'
查看响应示例:
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "aid": 60977932,
    "bvid": "BV1Jt411P77c",
    "allow_bp": false,
    "no_share": false,
    "cid": 106101299,
    "max_limit": 1000,
    "page_no": 1,
    "has_next": true,
    "ip_info": {
      "ip": "108.181.22.55",
      "zone_ip": " 172.27.132.5",
      "zone_id": 29409296,
      "country": "美国",
      "province": "加利福尼亚州",
      "city": "洛杉矶"
    },
    "login_mid": 616368979,
    "login_mid_hash": "445e7035",
    "is_owner": false,
    "name": "淡紫玲儿",
    "permission": "10000,1001",
    "level_info": {
      "current_level": 3,
      "current_min": 1500,
      "current_exp": 2962,
      "next_exp": 4500,
      "level_up": -62135596800
    },
    "vip": {
      "type": 1,
      "status": 0,
      "due_date": 1665417600000,
      "vip_pay_type": 0,
      "theme_type": 0,
      "label": {
        "path": "",
        "text": "",
        "label_theme": "",
        "text_color": "",
        "bg_style": 0,
        "bg_color": "",
        "border_color": "",
        "use_img_label": true,
        "img_label_uri_hans": "",
        "img_label_uri_hant": "",
        "img_label_uri_hans_static": "https://i0.hdslb.com/bfs/vip/d7b702ef65a976b20ed854cbd04cb9e27341bb79.png",
        "img_label_uri_hant_static": "https://i0.hdslb.com/bfs/activity-plat/static/20220614/e369244d0b14644f5e1a06431e22a4d5/KJunwh19T5.png"
      },
      "avatar_subscript": 0,
      "nickname_color": "",
      "role": 0,
      "avatar_subscript_url": "",
      "tv_vip_status": 0,
      "tv_vip_pay_type": 0,
      "tv_due_date": 0,
      "avatar_icon": {
        "icon_resource": {}
      }
    },
    "answer_status": 0,
    "block_time": 0,
    "role": "0",
    "last_play_time": 0,
    "last_play_cid": 0,
    "now_time": 1725003260,
    "online_count": 1,
    "need_login_subtitle": false,
    "subtitle": {
      "allow_submit": true,
      "lan": "zh-CN",
      "lan_doc": "中文（中国）",
      "subtitles": [
        {
          "id": 13643112644608002,
          "lan": "zh-Hans",
          "lan_doc": "中文（简体）",
          "is_lock": true,
          "subtitle_url": "//aisubtitle.hdslb.com/bfs/subtitle/c49b18a284739d99df1e3723cdf72c0c82db98e0.json?auth_key=1725003260-5d0391a07f4f47f6960f60cf5045dff3-0-fc16c1f67a6b41edcb2a89d5e0c9bfdd",
          "type": 0,
          "id_str": "13643112644608002",
          "ai_type": 0,
          "ai_status": 0
        },
        {
          "id": 13643200114196484,
          "lan": "en-US",
          "lan_doc": "英语（美国）",
          "is_lock": true,
          "subtitle_url": "//aisubtitle.hdslb.com/bfs/subtitle/2b38bc0f5d7671176964d4c3de441ed37568500c.json?auth_key=1725003260-5f709a74aa884751b77f86b6f6a48078-0-9b2fc3c18b99b1bf0cc7c7e63d18f686",
          "type": 0,
          "id_str": "13643200114196484",
          "ai_type": 0,
          "ai_status": 0
        }
      ]
    },
    "view_points": [],
    "preview_toast": "为创作付费，购买观看完整视频|购买观看",
    "options": {
      "is_360": false,
      "without_vip": false
    },
    "guide_attention": [],
    "jump_card": [],
    "operation_card": [],
    "online_switch": {
      "enable_gray_dash_playback": "500",
      "new_broadcast": "1",
      "realtime_dm": "1",
      "subtitle_submit_switch": "1"
    },
    "fawkes": {
      "config_version": 30787,
      "ff_version": 21289
    },
    "show_switch": {
      "long_progress": false
    },
    "bgm_info": null,
    "toast_block": false,
    "is_upower_exclusive": false,
    "is_upower_play": false,
    "is_ugc_pay_preview": false,
    "elec_high_level": {
      "privilege_type": 0,
      "title": "",
      "sub_title": "",
      "show_button": false,
      "button_text": "",
      "jump_url": "",
      "intro": "",
      "new": false
    },
    "disable_show_up_info": false
  }
}

播放反馈

https://app.bilibili.com/x/resource/laser2

请求方式: POST

注: 该接口不传 Cookie

URL参数:

`,12)),s("table",null,[n[29]||(n[29]=s("thead",null,[s("tr",null,[s("th",null,"参数名"),s("th",null,"类型"),s("th",null,"内容"),s("th",null,"必要性"),s("th",null,"备注")])],-1)),s("tbody",null,[n[25]||(n[25]=s("tr",null,[s("td",null,"mid"),s("td",null,"num"),s("td",null,"当前用户 mid"),s("td",null,"不必要"),s("td",null,"未登录为空")],-1)),n[26]||(n[26]=s("tr",null,[s("td",null,"buvid"),s("td",null,"str"),s("td",null,"BUVID (APP) 或 buvid3 (Web)"),s("td",null,"必要"),s("td",null,"可为任意非空字符串")],-1)),n[27]||(n[27]=s("tr",null,[s("td",null,"app_key"),s("td",null,"str"),s("td",null,"APP 密钥"),s("td",null,"必要"),s("td",null,[l("Web: web_player"),s("br"),l("可为任意非空字符串")])],-1)),s("tr",null,[n[21]||(n[21]=s("td",null,"url",-1)),n[22]||(n[22]=s("td",null,"str",-1)),n[23]||(n[23]=s("td",null,"日志 URL",-1)),n[24]||(n[24]=s("td",null,"非必要",-1)),s("td",null,[n[19]||(n[19]=l("从 ")),o(t,{to:"/docs/creativecenter/upload.html#%E4%B8%8A%E4%BC%A0%E6%8E%A5%E5%8F%A3"},{default:p(()=>n[18]||(n[18]=[l("上传接口")])),_:1,__:[18]}),n[20]||(n[20]=l(" 得到的 upos 协议 URL"))])]),n[28]||(n[28]=s("tr",null,[s("td",null,"task_type"),s("td",null,"num"),s("td",null,"任务类型"),s("td",null,"非必要"),s("td",null,[l("300: 播放卡顿"),s("br"),l("301: 进度条君无法调戏"),s("br"),l("354: 校园网无法访问"),s("br"),l("303: 弹幕无法显示"),s("br"),l("553: 跳过首尾时间有误"),s("br"),l("304: 出现浮窗广告"),s("br"),l("305: 无限小电视"),s("br"),l("302: 音画不同步"),s("br"),l("306: 黑屏"),s("br"),l("307: 其他")])],-1))])]),n[33]||(n[33]=a(`

JSON回复:

字段类型内容备注
codenum返回值0: 成功
-400: 请求错误
messagestr错误信息默认为 0
ttlnum1
dataobj数据本体

data 对象:

字段类型内容备注
task_idnum任务 ID?

示例:

播放反馈无限小电视, 不登录, 不传文件, buvid 为 chenrui-in-icu

curl -X POST "https://app.bilibili.com/x/resource/laser2" \\
--data-urlencode "buvid=chenrui-in-icu" \\
--data-urlencode "app_key=web_player" \\
--data-urlencode "task_type=305"
查看响应示例:
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "task_id": 850448532
  }
}
`,8))])}const C=e(i,[["render",D]]),v=JSON.parse('{"path":"/docs/video/player.html","title":"播放器","lang":"zh-CN","frontmatter":{},"git":{"updatedTime":1748079861000,"contributors":[{"name":"holazzer","username":"holazzer","email":"45134013+holazzer@users.noreply.github.com","commits":1,"url":"https://github.com/holazzer"},{"name":"z0z0r4","username":"z0z0r4","email":"z0z0r4@outlook.com","commits":1,"url":"https://github.com/z0z0r4"},{"name":"SessionHu","username":"SessionHu","email":"102411014+SessionHu@users.noreply.github.com","commits":4,"url":"https://github.com/SessionHu"},{"name":"SocialSisterYi","username":"SocialSisterYi","email":"45892418+SocialSisterYi@users.noreply.github.com","commits":1,"url":"https://github.com/SocialSisterYi"},{"name":"Kyrios0","username":"Kyrios0","email":"kyr1os@qq.com","commits":1,"url":"https://github.com/Kyrios0"},{"name":"wuziqian211","username":"wuziqian211","email":"65224318+wuziqian211@users.noreply.github.com","commits":2,"url":"https://github.com/wuziqian211"},{"name":"watermelon1024","username":"watermelon1024","email":"76525576+watermelon1024@users.noreply.github.com","commits":1,"url":"https://github.com/watermelon1024"}],"changelog":[{"hash":"d92d65bfcd0d9f35ff96b7c0cde61d4c6921a837","time":1748079861000,"email":"76525576+watermelon1024@users.noreply.github.com","author":"watermelon","message":"feat: 补齐播放器接口的互动视频资讯 (#1244)","coAuthors":[{"name":"Session小胡","email":"102411014+SessionHu@users.noreply.github.com"}]},{"hash":"4553e3dd1b4590fe0f727cc009ae830ac935f3f5","time":1746445238000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"晨叶梦春","message":"style & fix: improve docs"},{"hash":"7ce8f9c70e2f433624b51c735d247ea7869f21e9","time":1746378286000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"晨叶梦春","message":"feat: #689"},{"hash":"e83c3bd905c8b871ed1304d0eddafb817238d330","time":1734854252000,"email":"kyr1os@qq.com","author":"Kyrios0","message":"Update player.md"},{"hash":"1e24c6b1889160c4c35c01416aa4239501accf5f","time":1726759053000,"email":"102411014+SessionHu@users.noreply.github.com","author":"Session小胡","message":"调整部分接口描述与错误修复 (#1088)","coAuthors":[{"name":"社会易姐QwQ","email":"45892418+SocialSisterYi@users.noreply.github.com"}]},{"hash":"60a0c5d1a2f44fe61335da04571305fa7727a968","time":1724238159000,"email":"102411014+SessionHu@users.noreply.github.com","author":"Session小胡","message":"feat: 各种接口补充与错误修正 (#1066)"},{"hash":"750dd6a924cbeff0c87e9db36d48f4c9fdd3e571","time":1721471929000,"email":"102411014+SessionHu@users.noreply.github.com","author":"Session小胡","message":"feat: 更新部分接口 (#1056)"},{"hash":"1d557be039a887ef25bc25da0c396eb5e03eb42e","time":1714889183000,"email":"45134013+holazzer@users.noreply.github.com","author":"Han Zhang","message":"智能防挡弹幕 (#659)","coAuthors":[{"name":"z0z0r4","email":"z0z0r4@outlook.com"}]}]},"filePathRelative":"docs/video/player.md"}');export{C as comp,v as data};