StreamPackage 엔드포인트

엔드포인트는 채널의 입력을 시청자가 가져갈 재생 목록으로 제공하는 출력 구성입니다. 입력 주소는 송출용이고 엔드포인트 URL은 재생용이므로 구분합니다.

사전 준비

채널과 입력 프로토콜을 확인하고 재생 형식, 접근 정책, 타임시프트 및 DRM 필요 여부를 결정합니다. 기본 HLS 재생 확인은 추가 기능 없이 시작하고 필요한 기능을 따로 검증합니다.

콘솔에서 생성

1. 채널 상세의 Output Endpoint 탭을 엽니다.
2. Create Output Endpoint를 선택합니다.
3. Name과 Type을 지정합니다.
4. Playback List Name을 입력합니다. 공식 문서의 Manifest Name에 해당합니다.
5. 필요한 IP Restriction / AuthKey / 타임시프트 / DRM 설정을 확인합니다.
6. Confirm으로 저장하고 생성된 목록에서 URL을 확인합니다.

캡처의 URL은 비공개 처리했습니다. 실제 콘솔에서 자신의 주소를 복사합니다. 기본 재생 목록 이름 main은 HLS에서 main.m3u8에 대응합니다. index로 바꿨다면 index.m3u8을 요청해야 합니다.

접근 정책

설정	확인 사항
IP 제한	실제 요청자가 플레이어인지 CDN 원본 요청 노드인지 구분
AuthKey	HTTP 헤더 X-TENCENT-PACKAGE 기반 인증
HTTPS	재생 도메인에 유효한 인증서 적용
DRM	지원 출력 형식과 라이선스 연동 조건 확인

AuthKey는 오리진 요청의 인증 헤더에 사용합니다. CDN에 필요한 인증 전달을 설정하고 인증 값은 안전하게 보관합니다.

API 조회

tccli mdp DescribeStreamPackageChannel --region ap-seoul --Id YOUR_CHANNEL_ID

조회 결과의 엔드포인트 이름 / 프로토콜 / Manifest / URL을 콘솔과 비교합니다. 프로토콜별 지원값과 필드 필수 여부는 사용하는 API 버전의 스키마를 확인합니다.

타임시프트

Time-shifted Viewing을 활성화하면 보관된 라이브 구간에 대한 재생 요청을 구성할 수 있습니다. 요청 구간은 실제로 저장된 범위 안에 있어야 합니다.

https://YOUR_HOST/YOUR_ENDPOINT/main.m3u8?timeshift=1&start=2026-09-18T00:00:00Z&end=2026-09-18T01:00:00Z

공식 안내 기준 시작 시각은 Startover Windows 안에 있어야 하며, 종료 시각은 시작보다 뒤여야 합니다. 시작 / 종료를 지정한 반환 구간은 최대 24시간입니다.

광고 삽입과 구분

SSAI는 본편 소스 / ADS / 세션을 구성한 뒤 광고 삽입까지 확인합니다. 일반 HLS 재생과 광고 연동을 순서대로 검증합니다.

완료 확인과 삭제

마스터 목록, 미디어 목록, 실제 세그먼트와 영상 / 오디오를 순서대로 확인합니다. 삭제 전에는 사용하는 CDN과 플레이어 주소를 확인합니다. 삭제한 엔드포인트를 재생성하면 URL이 달라질 수 있습니다.

• 공식 엔드포인트 / 접근 제어 / 타임시프트 안내
• CSS CDN 연결
• 재생 검증