동영상 URL로 다른 웹사이트나 앱에서 플레이어를 열고 추가 매개변수로 재생을 설정할 수 있습니다.
재생 링크에는 #url=을 사용하세요. 동영상 URL과 모든 재생 옵션은 # 뒤에 입력합니다.
재생 링크 만들기
URL
https://m3u8-player.com/ko/#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/ko/#' + params;
window.open(playerUrl, '_blank', 'noopener');전체 동영상 URL을 한 번 인코딩하여 url 값으로 지정하고, 옵션은 &로 연결하세요. encodeURIComponent 또는 URLSearchParams로 링크를 만들 수 있습니다.
재생 링크 매개변수
| 매개변수 | 값 | 기본값 | 설명 |
|---|---|---|---|
url | HTTPS URL | 필수 | 동영상 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부터 시작합니다.
- 외부 자막은 최대 5 MiB의 UTF-8 SRT·VTT 파일을 지원합니다. 자막 URL은 교차 출처 접근을 허용해야 합니다.