B站视频解析工具bilibili-parse是什么一文讲清部署、参数配置与使用场景【免费下载链接】bilibili-parsebilibili Video API项目地址: https://gitcode.com/gh_mirrors/bi/bilibili-parse做过网站的人多半遇到过这样的场景想在自己页面里嵌一段B站视频却拿不到真实播放地址想批量整理教程素材面对一串 av 号、bv 号却无从下手。B站视频解析工具 bilibili-parse 正是为解决这类问题而生的开源项目——它把繁琐的 B 站 API 调用封装成一个简单接口让你几秒钟就能拿到可直接播放的视频地址也能直接生成播放器页面。本文会从零带你跑通它再讲清参数怎么配、哪些场景最值得用、以及新手最容易踩的坑。一句话理解bilibili-parse 就像一位视频地址翻译官。你把 av 号、bv 号或番剧 ep 号报给它它帮你向 B 站官方接口问路最后把普通人看不懂的 API 响应翻译成一行清晰可用的播放地址或一份结构化 JSON。一、三分钟完成环境准备与部署这套工具的部署成本非常低先看环境要求✅PHP 5.4绝大多数虚拟主机都满足✅Curl 扩展负责向 B 站发请求✅OpenSSL 扩展支持 HTTPS 访问三者缺一不可用php -m | grep -E curl|openssl可快速检查。部署步骤最短路径克隆仓库到服务器站点目录git clone https://gitcode.com/gh_mirrors/bi/bilibili-parse把整个目录上传到支持 PHP 的网站根目录或子目录。浏览器直接访问index.php能看到项目说明页即表示部署成功。验证是否跑通直接在地址栏试这两个请求/index.php?av14661594p1q64otypejson /index.php?av14661594p1otypedplayer第一个返回 JSON 元数据第二个直接弹出一个可播放的 DPlayer 播放器页面。看到有效返回说明解析链路已经打通。二、核心能力盘点它到底能做什么 能力一av / bv / ep 三种编号通吃B 站历史上出现过多种视频编号体系这套工具全部兼容av 号传统编号老视频还在用bv 号现行主流编号B 站页面复制到的多是这种ep 号番剧/课程的剧集编号配合typebangumi使用你不需要关心编号背后要调哪个接口直接传参即可这是它傻瓜化的第一步。️ 能力二清晰度自由选择带自动降级通过q参数控制画质常用档位16流畅、32标清、64高清、80超清。如果你请求的档位视频不支持类库会自动向下匹配到最近的可选档位而不是直接报错。// 请求 1080P若视频不支持会自动降级到可用的最高档 $bp-quality(80);注意部分高画质如 1080P对会员视频有限制返回结果里会有视频清晰度受限可能需要会员的提示这一点下面避坑章节会细讲。 能力三三种输出格式应对三种需求otype 参数返回内容适合场景json完整 JSON含 url、quality、accept_quality 等开发者集成url纯文本播放地址脚本快速取链接dplayer直接渲染 DPlayer 播放器页面想立刻看效果 能力四flv / dash / mp4 三种视频格式flv兼容性好大多数播放器可直接播放dash音视频分离的高清方案返回video和audio两个地址适合有合并能力的播放器如 DPlayermp4最通用的封装格式配合otypedplayer开箱即用⚡ 能力五缓存机制重复请求快 60% 以上同一个视频反复解析会白白消耗带宽开启缓存后第二次起直接读缓存// 文件缓存 1 小时默认 $bp-cache(true)-cache_time(3600); // 服务器支持 APCu 时改用内存缓存更快 $bp-cache(true, apcu)-cache_time(3600);三、真实场景与进阶技巧场景一个人网站嵌入 B 站视频这是最典型的用法。你的页面不需要维护一堆 iframe 外链只需在 PHP 端取一次真实地址再交给前端播放器include src/Bilibili.php; use Injahow\Bilibili; $bp new Bilibili(video); $bp-bvid(BV1xxxxx)-page(1)-quality(64)-format(mp4); $result json_decode($bp-result(), true); // code 为 0 表示解析成功$result[url] 就是可直接播放的地址 if ($result[code] 0) { $videoUrl $result[url]; }上面这段代码做了三件事引入核心类、设定视频与画质参数、拿到并校验结果。把它接到你的接口里就完成了输入编号→输出播放地址的闭环。场景二批量整理系列教程资源追更合集或搬运系列内容时p参数指定集数配合脚本即可批量解析# 依次解析第 1~3 集结果追加到文件 for i in 1 2 3; do curl https://your-domain.com/index.php?av14661594p$iotypeurl urls.txt done拿到的地址可以喂给任意下载工具实现批量离线收藏。开启缓存后重复运行不会重复请求 B 站接口对服务器也更友好。场景三作为 PHP 开发者直接调用类库不通过 HTTP 入口直接在代码里include也可以。除了上面用到的bvid()、quality()、format()类库还提供了几个实用方法cookie(你的登录Cookie)解析部分需要登录态才能看的内容proxy(http://代理地址)服务器网络受限时走代理access_key(xxx)携带应用凭证请求这几个方法在src/Bilibili.php里都有对应实现集成时按需启用即可。四、避坑指南新手最容易踩的 3 个坑坑 1以为能解析所有视频其实只限公开内容付费课程、会员专享、私密投稿都无法解析。这是 B 站权限体系的硬边界工具不会绕过去也别指望它破解。遇到无访问权限或清晰度受限提示先确认视频本身是否公开、你的清晰度档位是否被会员限制。坑 2dash 格式返回两个地址直接拿来当播放地址会失败dash格式返回的是video视频流和audio音频流两个 base_url需要支持合并的播放器才能出声。想要一个地址搞定请选flv或mp4。坑 3开启缓存后找不到缓存文件以为没生效文件缓存的默认路径是cache/cid/目录需要确认该目录存在且 PHP 有写入权限否则缓存静默失效并不报错。另外cache_time的最小值是 60 秒别指望把缓存设得更短来频繁刷新。其他常见问题速答Q需要登录 B 站账号吗A解析公开视频不需要。只有涉及会员画质时才可能需要通过cookie()传入登录态。Q解析失败一般是什么原因A最常见是视频编号写错、视频本身已失效或服务器无法访问 B 站接口海外服务器需确认连通性。Q工具支持下载吗A它只负责解析出播放地址下载需配合其他下载工具完成。五、总结值得记住的 3 点优势✅极低门槛PHP 5.4 三件套即可运行一个index.php走天下部署按分钟计。✅三种编号、三种输出、三种格式从取链接到出播放器页面全覆盖几乎每种集成场景都有对应参数。✅自带缓存与自动降级重复请求快、参数容错好即使请求了不存在的档位也不会直接崩给你看。它的边界也很清晰只解析公开内容、只给地址不负责下载。但如果你需要在自己的网站、脚本或工具链里接入 B 站视频它可能是当前最省事的方案之一。现在就可以动手克隆仓库、上传到你的 PHP 环境然后用一个你熟悉的视频 av 号或 bv 号跑通第一个 JSON 请求。从翻译官上岗到你拿到第一条播放地址整个过程不会超过十分钟。【免费下载链接】bilibili-parsebilibili Video API项目地址: https://gitcode.com/gh_mirrors/bi/bilibili-parse创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考