播放器与备用入口

把一条播放地址,变成更完整的观影体验。 巨量播放器既能直接打开 M3U8,也能为匹配到资源库的影片补充背景、选集与其他线路。你已有的片源可以继续用,播放器负责把观看体验往前推一步。

  • 少些广告干扰: 片头与插播片段过滤,配合画面广告文字、跑马灯和二维码遮挡;支持手动圈选与撤销误遮。
  • 不止一条线路: 精确匹配到库内内容后,自动测速选线;你提供的地址保留为最后的备用。
  • 接入现有网站: 苹果 CMS 可直接添加播放器;也可嵌入自建页面,电脑和手机共用同一入口。

想先体验?从下面的 M3U8 入口开始。要给站点换播放器?直接看「苹果 CMS 添加巨量播放器」。

打开一个 M3U8

复制下面的解析入口,在 url= 后填入完整且经过 URL 编码的 M3U8 地址,然后在浏览器中打开。

https://jimaoys99.com/parse?url=

下面是链接格式示例,请把示例视频地址换成自己的地址:

https://jimaoys99.com/parse?url=https%3A%2F%2Fmedia.example%2Fvideo%2Findex.m3u8

视频地址需要完整进行 URL 编码。 尤其是带有 ?、& 或签名的地址,直接拼接可能丢失参数。不要删去原地址里的参数,也不要重复编码。

收到别人分享的巨量播放链接时,直接打开即可,不需要再套一层解析地址。

主入口与备用入口

主入口:

https://jimaoys99.com/parse?url=

备用入口一:

https://jimaoys97.com/parse?url=

备用入口二:

https://jimaoys95.com/parse?url=

主入口打不开时,将解析链接开头的域名换成备用域名,保留 /parse?url= 及其后的全部内容。三个入口使用相同的播放器。

只更换播放器入口的域名,不要修改 url= 中的视频源域名。备用入口能解决入口访问问题,不能让已经失效或限制访问的视频源恢复播放。

播放时可以做什么

功能使用方法
播放控制暂停、拖动进度、调整音量和播放速度;调过的音量会被记住,换集、换片或重新打开后沿用
手机与电脑观看使用浏览器打开,按设备支持的方式切换全屏
智能选线有多线路时,可在「智能模式」中选择综合推荐、清晰优先、低广告优先或速度优先
切换线路展开线路列表,选择其他可用片源;不同线路的语言或画质可能不同
选择集数匹配到多集内容后,在选集列表中切换
影片背景匹配成功且有图片时,自动显示影片背景与资料
广告屏蔽识别部分片头、片中广告段,以及画面上的广告文字和二维码

页面先使用你提供的地址,影片资料和线路随后加载,不必等背景图或选集列表出现才开始观看。精确匹配后,播放器会自动测速,选择合适的线路。

只有匹配到资源库中的同一内容,且该入口允许访问时,才会补充背景、选集和线路。 没有匹配到时仍可播放原地址。资源库中只有一条可用线路时,也不会凭空增加备用片源。

拖动预览(缩略图)

片库已经有这部影片的缩略图时,将鼠标移到或拖动播放进度条,可以预览对应位置的画面。

匹配到片库内容并且该片已有缩略图时,分享页和解析页都会提供预览,不会因为当前线路的片长不同而隐藏。片库暂时没有缩略图,或缩略图文件、图片读取失败、画面裁剪范围无效时,不显示预览;正常播放和拖动进度不受影响。

线路与智能匹配

传入地址精确匹配到片库中某部影片、某一集的播放地址后,播放器会直接提供智能线路和其他可用线路,并自动测速选线;原地址始终保留在列表末尾,作为最后的备用。

地址没有收录、签名或参数发生变化、同一地址对应多个内容、当前入口无权访问,都可能无法匹配。匹配超时、出错或站点关闭了智能匹配时,会继续使用原地址,不影响原地址本身的播放。

如果只想播放传入地址,在解析链接末尾加上 &match=0,即可关闭本次智能匹配。例如:

https://jimaoys99.com/parse?url=https%3A%2F%2Fmedia.example%2Fvideo%2Findex.m3u8&match=0

match=0 放在播放器链接的参数中,不要放进已经编码的视频地址里。不传这个参数或填写其他值时,默认允许智能匹配;站点关闭智能匹配时,仍只使用传入地址。

广告屏蔽怎么工作

广告形式处理方式
片头或正片中的独立广告段符合识别规则时,过滤相应片段,继续播放正片
角落广告、广告文字条检测并识别文字后,对确认的广告区域进行遮挡
顶部滚动广告识别后遮挡对应区域,减少滚动文字干扰
广告二维码识别到二维码后,遮挡相应区域

画面遮挡不能还原广告下面被盖住的画面。播放器会尽量区分广告文字和影片对白字幕。

在设置中打开「广告屏蔽」,可启用或关闭屏蔽,选择「智能屏蔽」或「仅手动」,并调整遮蔽效果。自动识别遗漏时,可以用「自由圈选」标记需要遮挡的区域;误遮时使用「撤销最近自动屏蔽」,或进入「管理本线路规则」检查已有规则。

广告的剪辑方式、清晰度和浏览器能力各不相同,部分广告可能无法识别,也可能出现误判。片段过滤后,总时长可能缩短;画面识别需要播放后才能逐步生效。系统视频全屏只显示视频本身:片段过滤照常,画面遮挡在全屏期间不显示。哪些情况会进入系统视频全屏,见「嵌入网页的兼容要求」。

P2P 加速

同一部片子,看的人越多越顺。 开启 P2P 后,正在观看同一视频、同一线路的观众之间,可以互相传递已经缓存的视频分片。能从其他观众那里拿到的分片,就不必再从 CDN 下载:站点省下 CDN 流量,热门片子在高峰时段也更不容易卡顿。

什么时候生效: 同一视频、同一线路有其他观众正在看时才会互传。只有你一个人在看,或对方网络无法直连时,视频照常全部从 CDN 加载。P2P 在视频开始播放后才接入,不会拖慢起播;接不上、中途断开都会自动回到 CDN,观看不受影响。

安全与隐私边界:

  • 只在观看同一视频的观众之间传输视频分片,不会传输你设备上的其他内容;
  • 平台不中转、不缓存视频,只负责帮观众互相找到对方;
  • 使用手机流量时默认不开启;手机上无法确认网络类型时,同样默认不开启;
  • 观众可以随时关闭,关闭后只从 CDN 播放。

观众怎么开关: 打开播放器设置 →「P2P」:

选项作用
P2P 加速关闭后完全不使用 P2P,只从 CDN 播放
参与分享关闭后仍可从其他观众那里获取分片,但不再向别人上传(显示为「开启 · 仅下载」)

观众的选择会被记住,并且优先于站点的默认设置。

站长: 通过 /s 分享页和 /parse 解析入口播放的视频自动支持 P2P,无需额外配置;苹果 CMS 的接入方式不变,按下文添加播放器即可。

采集入库可以使用官方推荐的 找资源采集助手,空站约 38 秒导入全量。播放器接入仍按下文。采集步骤见「AppleCMS 采集接入」的「官方推荐:找资源采集助手」。

苹果 CMS 添加巨量播放器

已有 M3U8 片源,也能用上巨量的播放与广告屏蔽能力,不必先重新采集整个站点。 以下以苹果 CMS V10 为例;不同版本的菜单可能显示为「视频」或「内容」。

1. 先确定要接哪一种地址

你现在使用的内容应该怎么接
现有资源库采集到的 M3U8编辑该播放组的播放器,用下面的 M3U8 播放器代码
从巨量采集的播放器组新增播放器,编码填 jlplayer,直接打开完整播放页
从巨量采集的智能线路组编码填 jlm3u8;可用自己的 M3U8 播放器,也可用下面的代码接入巨量播放器,此时自动带上全部线路与选集

2. 添加或编辑播放器

进入后台【视频】-【播放器】,点击【添加】;已有 M3U8 播放组则点击对应播放器的【编辑】。先备份原来的设置与播放器代码,方便恢复。

设置项怎么填
状态启用
编码与影片的播放组编码完全一致;接现有片源时保留原编码
名称巨量播放器,或你希望观众看到的线路名称
打开方式当前窗口
解析状态关闭;由下方播放器代码直接打开巨量入口
解析接口地址留空
排序按自己的线路显示顺序设置

名称给观众看,编码用来对应片源。 只新增一个不对应任何片源的编码,不会让已有影片自动切换播放器。

3. 填写 M3U8 播放器代码

切换到【播放器代码】,粘贴下面的 JavaScript,不要额外包上 <script> 标签。

var frame = document.createElement('iframe');
frame.src = 'https://jimaoys99.com/parse?url=' + encodeURIComponent(MacPlayer.PlayUrl);
frame.style.cssText = 'width:100%;height:100%;border:0;';
frame.allow = 'autoplay; fullscreen; picture-in-picture';
frame.allowFullscreen = true;
MacPlayer.Html = frame.outerHTML;
MacPlayer.Show();

代码会完整保留 M3U8 的查询参数,带签名的地址也不需要手动拆分或修改。不要同时开启 CMS 的二次解析,否则可能加载另一个播放器。

代码已带上全屏需要的属性。若你的模板把播放区本身也放在 iframe 里,外层 iframe 同样要允许全屏,否则全屏按钮没有反应,见「嵌入网页的兼容要求」。

如果你接的是巨量播放器组 jlplayer, 采集到的已经是完整播放页。上面代码只需将 frame.src 那一行改成:

frame.src = MacPlayer.PlayUrl;

其余代码保持不变。不要把完整分享页再次放进 /parse?url=。

4. 保存、清缓存、打开一部影片

保存播放器后,点击后台【清缓存】。打开一部属于该播放组的影片,选择相应线路,确认出现巨量播放器并能播放;再打开设置,检查「广告屏蔽」菜单。

如果仍是旧播放器,强制刷新播放页,并检查站点 CDN 是否仍缓存旧的播放器脚本。若提示播放器不存在,核对影片播放组编码是否与刚保存的编码一致,以及后台保存时是否报错。

先用一部电影和一部多集内容确认播放、选集都正常,再应用到更多播放组。主入口访问不稳定时,只需把代码中的播放器域名换成本页备用域名,保存并清缓存;不要批量改写片源地址。

在自己的网站中使用

如果网站后台提供「解析地址」设置,填写本页的解析入口,并确认网站会对视频地址进行一次 URL 编码。

自建页面可以用下面的方式生成播放链接:

const videoUrl = 'https://media.example/video/index.m3u8';
const playerUrl = 'https://jimaoys99.com/parse?' + new URLSearchParams({ url: videoUrl });

将生成的 playerUrl 用作跳转地址,或作为页面内播放器 iframe 的 src。嵌入时请允许全屏;是否允许自动播放由浏览器决定,必要时让观众点击播放。

通过 CMS 采集巨量资源时,巨量播放器组已经提供完整播放页地址,无需再填写解析入口。巨量智能线路组提供 M3U8,可用站点自己的播放器直接播放。具体设置见帮助中心的「AppleCMS 采集接入」。

嵌入网页的兼容要求

大部分站长是把巨量播放器放进自己页面的 iframe 里使用的。 按下面写,电脑和手机上的全屏、自动播放与广告屏蔽才能正常工作。苹果 CMS 用户按上文粘贴播放器代码即可,代码已包含这些属性。

iframe 写法

<div style="position:relative;width:100%;aspect-ratio:16/9;">
  <iframe
    src="https://jimaoys99.com/parse?url=经过URL编码的M3U8地址"
    allow="autoplay; fullscreen; picture-in-picture"
    allowfullscreen
    style="position:absolute;inset:0;width:100%;height:100%;border:0;"
  ></iframe>
</div>
要求不这样做会怎样
allow 包含 fullscreen,并加上 allowfullscreen浏览器拒绝全屏:点全屏只能铺满嵌入区域,无法铺满整个屏幕
播放器外面的每一层 iframe 都允许全屏模板若把播放区嵌套在另一个 iframe 里,任意一层缺少,全屏都会失败
allow 包含 autoplay部分浏览器不允许自动播放;即使加上,是否自动播放仍由浏览器决定
不要给 iframe 加 sandbox播放器脚本或全屏会被禁止,可能无法播放
给外层容器固定比例或高度容器高度为 0 时,播放器显示不出来
不要在 iframe 上方覆盖透明元素会挡住播放、全屏和设置按钮的点击

不同设备上的全屏

设备嵌在 iframe 里直接打开播放链接
电脑浏览器播放器全屏,功能完整播放器全屏,功能完整
安卓手机浏览器播放器全屏,功能完整播放器全屏,功能完整
安卓微信、QQ 等 App 内置浏览器播放器全屏,功能完整;内置浏览器不支持时,退为铺满嵌入区域在页面内铺满屏幕,功能完整
iPad播放器全屏,功能完整播放器全屏,功能完整
iPhone进入系统视频全屏:片段过滤、插播跳过照常;画面遮挡和巨量控制栏在全屏期间不显示,退出后恢复在页面内铺满屏幕,功能完整

iPhone 不支持把网页中的某一块区域全屏,只能全屏视频本身;嵌在 iframe 里的播放器又无法铺满父页面,所以只能使用系统视频全屏。希望 iPhone 观众全屏时也看到画面遮挡,可以让 iPhone 上的播放按钮在当前窗口直接打开播放链接,而不是嵌入 iframe。

传入巨量自己的线路

巨量智能线路的地址(形如 /public/playback/…/smart.m3u8)也可以放进解析入口。播放器会识别出这是巨量线路,按分享页的方式播放:带上全部线路、选集和自动连播,不会只显示「传入线路」一条。

播放前会先检测各条线路,首次出画面可能比直接播放单个 M3U8 慢几秒。

常见问题

为什么只有视频,没有背景和其他线路?

可能还在匹配,也可能地址未被收录、签名或参数发生变化、对应关系不唯一,或者当前入口没有访问权限。匹配超时、站点关闭智能匹配,或链接带有 match=0 时,也会只播放原地址。请保留完整的视频地址;匹配成功后,会补充资料与线路,自动测速选线,原地址留在最后作为备用。

换了备用入口,视频还是打不开?

先确认原 M3U8 地址是否过期、参数是否完整。视频源可能限制地区、网络或访问方式;更换播放器入口不一定能解决这些限制。已有线路列表时,可以试另一条线路。

能播放,但某条线路提示不可用?

这条片源可能暂时无法访问,选择其他线路重试即可。不同片源的可用性会变化,显示在线路列表中不代表一直可用。

广告还在,或者正片被遮住了?

画面识别需要一定时间,未命中规则的广告可能保留。误遮时先撤销最近自动屏蔽;反馈问题时请提供完整播放链接、所选线路,以及广告或误遮出现的时间,方便定位。

苹果手机上点全屏没反应,或全屏后看不到广告遮挡?

点了没反应:检查嵌入播放器的 iframe 是否允许全屏,包括模板外层的 iframe,见「嵌入网页的兼容要求」。全屏后看不到遮挡:iPhone 嵌入时使用系统视频全屏,片段过滤仍然生效,画面遮挡在退出全屏后恢复;想在全屏时也保留遮挡,请让 iPhone 观众直接打开播放链接。

为什么 P2P 显示 0?

此刻没有其他观众在看同一视频、同一线路,或者对方的网络无法与你直连。这时视频照常从 CDN 播放,速度不受影响。同时观看的人越多,P2P 越容易生效。

手机上为什么没有开启 P2P?

使用手机流量时,P2P 默认不开启,以免消耗你的流量;在部分手机浏览器上无法判断当前是 Wi-Fi 还是流量,也会按流量处理。需要时可以在播放器设置的「P2P」里手动打开。

会不会占用我的上传带宽?

开启「参与分享」时,播放期间会把你已缓存的同一视频分片分享给其他观众,会占用少量上传带宽,关闭页面即停止。不想上传可以关闭「参与分享」,仍能从其他观众那里获取分片。

播放器能下载视频或提供所有清晰度吗?

解析入口用于在线播放。清晰度取决于原片源提供的版本,不会把低清视频转换成高清,也不保证提供下载功能。