- 文档发布页 Tab：粘贴链接自动识别 B站 / 爱奇艺 / 优酷 / 腾讯 / YouTube / 直链；爱奇艺页链即时提示须用分享 iframe
- 片源下拉补爱奇艺 / 优酷 / 腾讯；顶栏引导 tip
- 验收 fixture 第 1 集：B站样例 + mp4 直链双线路，前台可切「N 源」
文档扩展
文档视频
给文档挂视频：支持封面、外链或嵌入地址，前台随文章播放。
商品属性
品牌官方插件
语言PHP 8.1+
数据库MySQL 5.7+ / MariaDB
环境PivArk 1.5+ · weapp 标装
类型文档扩展
版本v1.0.0
编码UTF-8
交付方式官方插件 · 授权安装
商品介绍
文档视频是做什么的？
为文章挂载可播放的视频：支持多条外链嵌入，也支持点播剧集（选集、试看、付费、多线路、续播）。前台用 一块输出，模板怎么写请看「前台调用说明」Tab。
适合教程站、影视解说、付费课程、企业宣传片等需要在正文旁展示视频的场景。
核心能力
- 嵌入条目：粘贴 B 站 / YouTube / mp4 等地址，自动 16:9 播放器；
- 点播剧集：剧集 + 单集 + 多线路；登录/等级/单集付费/全集付费；
- 试看与转化：可设试看秒数，结束引导登录或购买；
- 会员观影：「我的观影」续播；「我的购买」查视频订单；
- 智能粘贴：发布页粘贴视频页 URL，可走插件解析（与内核剪贴板引导配合）。
典型场景
站长怎么用（建议 5 步）
- 在「基础设置」打开插件，配置影视会员等级、外置解析 API（按需）、平台 Cookie（番剧等）。
- 「发布页展现」选独立 Tab 或嵌入正文；在文章发布页的「文档视频」面板维护内容。
- 嵌入模式：在「嵌入条目」或发布面板添加播放地址与封面。
- 点播模式：在文档发布页「文档视频」Tab 粘贴主播放地址即可；也可空白处 Ctrl+V 快速加集。权限/试看/备用线路收在「更多设置」。复杂批量仍可去插件中心「点播剧集」。
- 确认主题详情页已放
，用有数据 / 无数据各测一篇；窄屏看 16:9 是否正常。
双轨怎么选？
| 方式 | 后台入口 | 适合 |
|---|---|---|
| 嵌入条目 | 嵌入条目 / 发布页多条 URL | 单篇几个外链，不涉及付费选集 |
| 点播剧集 | 点播剧集 → 单集 | 连载、试看、付费、多线路、续播 |
同一文档若绑定了启用中的点播单集，前台 会优先点播 UI；否则显示嵌入列表。
访客在前台看到什么？
- 嵌入：每条视频 16:9 画面 + 标题；
- 点播：选集列表，点击后加载播放器；可切换线路、试看提示、登录/购买按钮；
- 登录用户：可从上次进度续播（会员中心「我的观影」也有入口）；
- 未配置 / 插件关闭 / 无数据：整块不出现。
运营与维护
- 「运营统计」查看播放趋势、热门单集、解析失败；
- 解析平台规则变更时，在「解析平台自检」中排查并更新 Cookie / API 配置。
常见问题（站长视角）
- 为什么前台没有视频？ 检查插件开关、文章是否有关联条目或单集、单集是否启用。
- 为什么还是外链列表而不是选集？ 单集需填写「文档 ID」且状态启用；迁移后确认
document_id正确。 - 试看结束不能播？ 属预期，需登录或购买；可在单集/剧集设置价格与试看秒数。
- 手机端播放器变形？ 使用默认模板或保留
pv-vod-embed-ratio/pv-video-embed结构，勿给 iframe 写死宽高。
使用说明
写给主题 / 前端
在文章详情页模板插入 点播选集：默认请保持空标签，由插件输出 并自动登记 实际片源、线路、试看、广告点由脚本请求播放 API 后注入，不要在模板里写死 多片源：同一单集可添加多条线路（爱奇艺 / 哔哩哔哩 / 本地等），填写「显示名」与链接；前台右侧「片源」区切换，选集行显示「N 源」。验收 fixture 第 1 集自带 B站 + 直链 双线路，灌数后即可对照切换。 爱奇艺 / 优酷 / 腾讯：普通播放页（ 没有自有片源时（验收用）：后台单集线路可暂时填下面任一公开测试地址，仅用于确认清晰度按钮，与卖刀等业务无关。 CLI 多码率自检（无 CORS，勿用于浏览器）： 样式由插件登记至 禁止给
pv-vod-layout（左 data-pv-vod-player，右选集含 / 等）。自定义内层模板时走旧版竖排 pv-vod-list--legacy。weapp/doc_vod/assets/css/vod.css、weapp/doc_vod/assets/js/player.js，由页脚 输出。标签属性
属性 说明 id / document_id / aid文章 ID，详情页必填其一 （不写） 自动取当前页 document_id（仅详情页）循环变量 · 嵌入条目
变量 含义 说明 标题 纯文本，需自行转义时勿重复包 HTML 播放器 HTML 已含 pv-vod-embed-ratio 16:9 容器，原样输出播放页 URL 直链或平台页 封面 绝对 URL 来源 如 embed 循环变量 · 点播单集
变量 含义 单集 ID（ data-episode-id）剧集 ID / 标题 / 集号 权限提示文案（如试看、购买） 是否已允许播放（0/1，列表态） 封面 URL（可选展示） <video src>。前台效果示意
播放相关 API（自建 UI 时用）
方法 路径 说明 GET /api/v1/plugins/doc_vod/play?episode_id=鉴权后的播放 payload（sources、试看、进度、广告点） POST /api/v1/plugins/doc_vod/progress保存续播位置（需登录 + CSRF） POST /api/v1/plugins/doc_vod/checkout/episode单集下单 POST /api/v1/plugins/doc_vod/checkout/series全集下单 GET /api/v1/plugins/doc_vod/grants我的授权列表 HLS 多清晰度
Access-Control-Allow-Origin（或走同源代理）。无 CORS 的测试流（如 Apple BipBop）在浏览器会报「HLS 播放失败」。connect-src、media-src https:、worker-src blob:（hls.js 解复用 Worker）。内核默认已在 app/home/controller/Base.php 配置。自动 / 1080p / 720p … 按钮组（class pv-vod-quality）。iqiyi.com/v_…）不能像 B 站 BV 一样直接嵌；须在视频页点「分享」复制通用代码里的 iframe src=…open.iqiyi.com… 填到线路。否则前台会提示「前往爱奇艺观看」。https://storage.googleapis.com/shaka-demo-assets/angel-one-hls/hls.m3u8
https://devstreaming-cdn.apple.com/videos/streaming/examples/img_bipbop_adv_example_ts/master.m3u8 · php devtools/daily/scripts/verify_video_hls_master_cli.php样式钩子（自适应）
（路径 /weapp/doc_vod/assets/css/vod.css）。主题覆盖示例：/* 整块宽度 */
.pv-doc-video__list { max-width: 960px; margin-inline: auto; }
/* 嵌入 16:9（勿去掉内层 ratio） */
.pv-video-embed .pv-vod-embed-ratio { border-radius: 12px; }
/* 点播选集 */
.pv-vod-ep--active { border-color: var(--theme-primary); }
/* 窄屏线路按钮全宽 */
@media (max-width: 576px) {
.pv-vod-sources .btn { width: 100%; }
}
内 iframe 写死 width/height 像素值，否则会破坏 16:9。什么时候整段不输出？
id 无效。自检清单
升级日志
- 文档发布页 Tab：主播放址置顶；权限/试看/备用线路折叠；Ctrl+V 粘贴链接快速加集
- 本剧默认权限 chip 化；去掉「剧集管理」外链（批量仍走插件中心）
- 修复：模板字符串吞掉正则 `\/\/` 导致 Tab 一直「加载中」
- 文档挂载视频条目，封面与外联/嵌入地址
- 文档编辑器 inline 视频 Tab 与 `` 标签
- 会员中心「我的观影」已购授权入口
购买与安装
- 登录官网会员，在本页右侧选择限时免费套餐完成开通（到期后须续费或升级）。
- 在 用户中心 → 我的授权 绑定客户站域名并同步到站点后台。
- 客户站 → 应用市场 搜索
doc_vod在线安装并启用。
交易须知
- 交付形式官方插件 · 授权安装；通过应用市场安装，不提供独立源码包下载。
- 授权范围插件授权绑定单个站点域名；小程序类 SKU 规则以套餐说明为准。
- 限时免费免费授权含有效期，到期后功能受限；续费或升级付费套餐可继续使用。
- 退款规则请确认功能需求后再购买；非功能缺陷恕不退款。
- 官方保障官方插件由元舟提供安装指导与技术支持。