透過影片網址從其他網站或應用程式開啟播放器，可用附加參數設定播放方式。
播放連結使用 #url=，影片網址和其他播放參數均放在 # 後。
建立播放連結
URL
https://m3u8-player.com/zh-tw/#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-tw/#' + 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；字幕網址需允許跨來源存取。