播放器调用说明

在线播放

通过视频地址从其他网站或应用打开播放器,可用附加参数设置播放方式。

播放链接使用 #url=,视频地址和其他播放参数均放在 # 后。

创建播放链接

URL
https://m3u8-player.com/zh-cn/#url=https://example.com/video.m3u8
JavaScript
const videoUrl = 'https://example.com/video.m3u8';
const params = new URLSearchParams({
  url: videoUrl, autoplay: '1', muted: '1'
});
const playerUrl = 'https://m3u8-player.com/zh-cn/#' + params;
window.open(playerUrl, '_blank', 'noopener');

将完整视频地址编码一次后放入 url 参数,其他参数用 & 连接。可使用 encodeURIComponent 或 URLSearchParams 生成链接。

播放链接参数

参数取值默认值说明
urlHTTPS URL必填视频链接
title≤ 120auto视频名称
typeauto / hls / videoauto播放格式
autoplay0 / 11自动播放
muted0 / 10静音
volume0–1本地设置音量
rate0.25–4本地设置播放速度
start90 / 01:30 / 00:01:30历史断点起播位置(点播)
loop0 / 1本地设置循环
posterHTTPS URL—封面图片
subtitleHTTPS SRT / VTT URL—字幕
langar / de / en / es / fr / hi / id / it / ja / ko / pt / ru / th / tr / vi / zh-CN / zh-TWauto切换语言
history0 / 1本地设置播放历史
resume0 / 11历史断点
theater0 / 10剧场
lights0 / 10关灯
qualityauto / 720 / 1080 / …auto画质
audio0 / 1 / …auto音轨
aspectauto / 16:9 / 4:3 / 1:1auto画面比例

使用须知

  • autoplay=0 会加载播放器并等待点击;muted=1 有助于自动播放,但浏览器仍可能要求点击。全屏与画中画需要用户操作。
  • 参数只影响本次播放;未指定时使用本地设置。history=0 不记录历史;history=1 仍尊重本地历史开关。start 优先于历史断点;resume=0 禁用断点续播。
  • 清晰度与音轨以视频源和浏览器提供的选项为准。start 用于点播视频;audio 从 0 开始计数。
  • 远程字幕支持 UTF-8 编码的 SRT、VTT,最大 5 MiB;字幕地址需允许跨域访问。