StreamPackage Overview
On this page
StreamPackage는 인코딩된 라이브 스트림을 받아 재생용 플레이리스트와 세그먼트를 제공하는 패키징 / 오리진 서비스입니다. StreamLive가 해상도와 비트레이트를 만드는 단계라면, StreamPackage는 그 결과를 플레이어와 CDN이 가져갈 수 있게 제공하는 단계입니다.
전체 흐름
예를 들어 StreamLive에서 만든 1080p와 720p 출력을 StreamPackage로 보냅니다. 플레이어는 HLS 마스터 플레이리스트에서 화질 목록을 확인하고, 선택한 화질의 미디어 플레이리스트와 세그먼트를 차례로 요청합니다. CDN을 연결하면 시청자 요청은 CDN을 통해 처리됩니다.
화질별 인코딩은 앞단에서 준비해야 합니다.
콘솔의 네 가지 구성
| 구성 | 역할 | 확인할 값 |
|---|---|---|
| Channel | 입력과 출력을 묶는 관리 단위 | 리전, 채널 ID, 입력 프로토콜 |
| Input | 송출 시스템이 스트림을 넣는 수신 지점 | 자동 생성된 두 입력 주소와 HTTP 인증 상태 |
| Output Endpoint | 플레이어와 CDN이 스트림을 가져가는 지점 | 출력 유형, 재생 목록 이름, 재생 URL |
| CDN | 시청자에게 전달할 배포 경로 | CSS 연동 권한, 재생 도메인, DNS, HTTPS |
입력 주소는 송출용, 엔드포인트 주소는 재생용, 채널 ID는 리소스 식별에 사용합니다.
기능별 콘솔 탐색
| 작업 | 찾아갈 화면 | 작업 결과 |
|---|---|---|
| 입력 채널 생성 | Channel 관리 → Create Channel | 채널 ID와 두 입력 주소 |
| 입력 인증 | 채널 상세 → Input → Authentication | 송출 측에 적용할 HTTP 인증 |
| 재생 주소 생성 | 채널 상세 → Output Endpoint → Create Output Endpoint | HLS/DASH 또는 지원되는 CMAF 출력 주소 |
| 과거 시점 재생 | Output Endpoint의 Time-shifted Viewing | 보관 범위 내 시점 지정 재생 |
| CSS 배포 | 채널 상세 → CDN | 서비스 간 권한과 재생 도메인 연결 |
| 과거 구간 저장 | Harvest Jobs | 지정 구간을 COS에 저장하는 작업 |
| 광고 삽입 | Server-Side Ad Insertion | ADS / 원본 / 세션을 연결하는 별도 광고 구성 |
| 편성형 채널 | Channel Linear Assembly | 소스와 프로그램 편성으로 선형 채널 구성 |
| 운영 확인 | Usage Statistics / Log Management | 사용량과 요청 / 처리 관련 로그 확인 |
기본 연결은 Channel의 Input / Output Endpoint / CDN 세 화면에서 완료합니다. Harvest와 광고 삽입, 편성형 채널은 별도 기능입니다. 채널 생성 → 엔드포인트 → CDN 순서로 화면과 입력값을 확인합니다.
기본 구성 순서
- 채널 생성: 리전과 입력 프로토콜을 선택합니다.
- 송출 연결: StreamLive 출력 그룹에서 StreamPackage 채널 ID를 지정하거나, 외부 송출 시스템에 입력 주소와 필요한 인증 정보를 설정합니다.
- 엔드포인트 생성: 출력 유형과 재생 목록 이름을 지정합니다.
- 입력 / 출력 확인: 실제 신호를 전송하고 플레이리스트 및 세그먼트가 갱신되는지 확인합니다.
- CDN 연결: 서비스 간 권한과 재생 도메인을 연결하고 DNS / HTTPS / 재생을 검증합니다.
처음 구성할 때는 HLS 입력과 HLS 출력으로 기본 재생을 먼저 확인합니다.
입력과 출력 형식
| 항목 | 지원 구성의 예 | 선택 기준 |
|---|---|---|
| 채널 입력 | HLS, DASH | 송출 시스템이 전송하는 프로토콜 |
| 기본 출력 | 입력 프로토콜에 대응하는 HLS 또는 DASH | 대상 플레이어 호환성 |
| HLS 입력의 추가 출력 | CMAF-HLS, CMAF-DASH | 재패키징과 대상 기기의 지원 여부 |
콘솔에서는 CMAF-HLS와 CMAF-DASH 출력 유형을 구분합니다. DRM 입력의 CMAF 재패키징 등은 제약이 있으므로 엔드포인트 구성에서 확인합니다.
기본 재생 이후의 확장
- 타임시프트: 보관 범위 안의 과거 시점부터 재생합니다.
- Harvest Job: 지정한 과거 구간을 COS에 저장합니다.
- SSAI: 광고 서버와 연동해 시청 세션에 맞는 광고 경로를 재생 목록에 구성합니다.
다음 그림은 일반 재생과 광고 삽입 경로의 역할 구분입니다.
구성 완료 기준
원본 수신, 재생 목록 갱신, 세그먼트 응답, CDN 도메인 재생을 각각 확인합니다. 이중화가 필요하면 두 입력에 신호를 보내고 장애 전환까지 별도로 검증합니다.