artplayer-plugin-p2p · P2P 验证台

P2P Verify Console

无损动态开关 · 实时验证台

通过 option.plugins 注入即可为 m3u8 启用 P2P 分发。右键播放器体验「P2P 统计」面板，双标签页打开本页观察 peer 互联；所有开关均经运行时动态配置无损切换，不销毁实例、不中断播放。

artplayer / m3u8 · P2P 未创建

流地址 A · m3u8

流地址 B · m3u8

验收指引：双标签页打开本页观察 peers ≥ 1 与 P2P 占比上升；设置面板或「句柄直控」切换开关—— 播放不中断、peers 归零、下行转纯 HTTP，重新开启后渐进恢复；换源后开关与面板保持；勾选 badge 后点击右上角徽章可展开 / 收起详情（Enter 键同效）； DevTools → Network → WS 在销毁后应无残留连接。

Monitor

对照统计与句柄直控

外部每秒轮询 getStats()，与播放器内「P2P 统计」面板数值逐项对照；直控按钮经 handle.setP2PEnabled / setUploadEnabled 走无损动态切换，与设置面板开关等价。

Peers / 峰值

—

idle

P2P 下行 / 占比

—

HTTP 下行

—

P2P 上行 / 速率

—

句柄直控

handle API

P2P 加速 —

上传开关 —

右上角徽章 —

统计心跳（事件） —

累计总下行 —

与播放器设置面板开关等价；切换即时生效且不断流。

插件配置

重建生效

总闸与展示

ui（UI 总闸） stats（统计面板） badge（右上角徽章） fatalNotice（恢复耗尽提示）

设置开关组 · 按项显示（ui.setting）

「P2P 加速」开关「仅上传模式」开关「P2P 统计」开关

核心开关

enabled（初始 P2P） uploadEnabled（初始上传）

P2P 网络（core / tracker）

swarmId · 留空默认取流地址

tracker announce · 逗号分隔

hls.js 与插件行为

hls.maxBufferLength

lang（界面语言，i18n 演示）

type（customType 名）

fatalRetryMax（默认 2）

验收⑪：关闭 ui / stats 或隐藏全部设置开关后重建，P2P UI 消失而对照统计仍持续工作。 lang 切 en 后重建，设置面板与右键「P2P 统计」显示英文（i18n）；「统计心跳」chip 每秒递增即 p2p:statsTick 事件推送。

节点拓扑

0 peers

SELF（本机）源站（HTTP） P2P 节点活跃连线空闲 / 断开

节点由 p2p:peerConnect / peerClose 事件驱动，连线亮度映射近 1.5 秒内的传输活动；悬停节点查看详情。

事件日志

等待事件…

覆盖 15 个 p2p:* 引擎事件、p2p:stateChange、p2p:fatalError 与播放器生命周期事件。