通过视频地址从其他网站或应用打开播放器,可用附加参数设置播放方式。
播放链接使用 #url=,视频地址和其他播放参数均放在 # 后。
创建播放链接
URL
https://m3u8-player.com/zh-cn/#url=https://example.com/video.m3u8JavaScript
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 生成链接。
播放链接参数
| 参数 | 取值 | 默认值 | 说明 |
|---|---|---|---|
url | HTTPS URL | 必填 | 视频链接 |
title | ≤ 120 | auto | 视频名称 |
type | auto / hls / video | auto | 播放格式 |
autoplay | 0 / 1 | 1 | 自动播放 |
muted | 0 / 1 | 0 | 静音 |
volume | 0–1 | 本地设置 | 音量 |
rate | 0.25–4 | 本地设置 | 播放速度 |
start | 90 / 01:30 / 00:01:30 | 历史断点 | 起播位置(点播) |
loop | 0 / 1 | 本地设置 | 循环 |
poster | HTTPS URL | — | 封面图片 |
subtitle | HTTPS SRT / VTT URL | — | 字幕 |
lang | ar / de / en / es / fr / hi / id / it / ja / ko / pt / ru / th / tr / vi / zh-CN / zh-TW | auto | 切换语言 |
history | 0 / 1 | 本地设置 | 播放历史 |
resume | 0 / 1 | 1 | 历史断点 |
theater | 0 / 1 | 0 | 剧场 |
lights | 0 / 1 | 0 | 关灯 |
quality | auto / 720 / 1080 / … | auto | 画质 |
audio | 0 / 1 / … | auto | 音轨 |
aspect | auto / 16:9 / 4:3 / 1:1 | auto | 画面比例 |
使用须知
- autoplay=0 会加载播放器并等待点击;muted=1 有助于自动播放,但浏览器仍可能要求点击。全屏与画中画需要用户操作。
- 参数只影响本次播放;未指定时使用本地设置。history=0 不记录历史;history=1 仍尊重本地历史开关。start 优先于历史断点;resume=0 禁用断点续播。
- 清晰度与音轨以视频源和浏览器提供的选项为准。start 用于点播视频;audio 从 0 开始计数。
- 远程字幕支持 UTF-8 编码的 SRT、VTT,最大 5 MiB;字幕地址需允许跨域访问。