Hướng dẫn tích hợp trình phát

Phát trực tuyến

Mở trình phát từ trang web hoặc ứng dụng khác bằng URL video và tùy chỉnh bằng các tham số không bắt buộc.

Dùng #url= cho liên kết phát video. Đặt URL video và tất cả tùy chọn sau dấu #.

Tạo liên kết phát video

URL
https://m3u8-player.com/vi/#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/vi/#' + params;
window.open(playerUrl, '_blank', 'noopener');

Mã hóa toàn bộ URL video một lần làm giá trị url. Ngăn cách các tùy chọn bằng &. Có thể dùng encodeURIComponent hoặc URLSearchParams để tạo liên kết.

Tham số liên kết phát video

Tham sốGiá trịMặc địnhMô tả
urlHTTPS URLBắt buộcURL video
title≤ 120autoTên video
typeauto / hls / videoautoĐịnh dạng
autoplay0 / 11Tự động phát
muted0 / 10Tắt tiếng
volume0–1Cài đặt cục bộÂm lượng
rate0.25–4Cài đặt cục bộTốc độ phát
start90 / 01:30 / 00:01:30Vị trí đã lưuVị trí bắt đầu (theo yêu cầu)
loop0 / 1Cài đặt cục bộLặp lại
posterHTTPS URL—Ảnh bìa
subtitleHTTPS SRT / VTT URL—Phụ đề
langar / de / en / es / fr / hi / id / it / ja / ko / pt / ru / th / tr / vi / zh-CN / zh-TWautoĐổi ngôn ngữ
history0 / 1Cài đặt cục bộLịch sử
resume0 / 11Vị trí đã lưu
theater0 / 10Rạp phim
lights0 / 10Tắt đèn
qualityauto / 720 / 1080 / …autoChất lượng
audio0 / 1 / …autoÂm thanh
aspectauto / 16:9 / 4:3 / 1:1autoTỷ lệ khung hình

Lưu ý sử dụng

  • autoplay=0 tải trình phát ở trạng thái tạm dừng. muted=1 hỗ trợ tự động phát nhưng trình duyệt vẫn có thể yêu cầu nhấp. Toàn màn hình và hình trong hình cần thao tác người dùng.
  • Tùy chọn chỉ áp dụng cho lần phát này. Giá trị bỏ trống dùng cài đặt cục bộ. history=0 không ghi lại; history=1 vẫn theo công tắc lịch sử cục bộ. start ưu tiên hơn vị trí đã lưu; resume=0 tắt phát tiếp.
  • Tùy chọn chất lượng và âm thanh phụ thuộc vào nguồn video và trình duyệt. start áp dụng cho video theo yêu cầu; số thứ tự audio bắt đầu từ 0.
  • Phụ đề từ xa hỗ trợ tệp SRT và VTT mã hóa UTF-8, tối đa 5 MiB. URL phụ đề phải cho phép truy cập khác nguồn.