StreamPackage 채널 구성
On this page
StreamPackage 채널을 생성하면 스트림을 받을 입력 두 개가 만들어집니다. 이 단계에서는 채널과 송출 연결을 준비하고, 다음 단계에서 시청용 엔드포인트를 생성합니다.
시작 전 준비
- StreamPackage 콘솔에 접근할 권한을 확인합니다.
- 작업 리전과 송출 프로토콜을 결정합니다. 이 예제는 서울 리전과 HLS 입력을 사용합니다.
- StreamLive를 연결할 경우 출력 그룹에 지정할 패키저 채널 ID가 필요합니다. 채널 생성 후 확인할 수 있습니다.
1. 채널 생성
- 콘솔에서 작업 리전을 선택합니다.
- Create Channel을 선택합니다.
- 채널 이름을
demo_package, 입력 프로토콜을 HLS로 지정합니다. - 세그먼트와 플레이리스트 길이 제한을 확인한 뒤 Create를 선택합니다.
| 항목 | 의미 | 설정 시 확인 사항 |
|---|---|---|
| Input Protocol | 채널로 들어오는 스트림의 프로토콜 | 송출 측의 HLS 또는 DASH 구성과 일치 |
| Max Segment Duration | 수신할 세그먼트의 최대 길이 | 공식 문서의 기본값은 15초. 실제 송출 세그먼트 길이를 수용하도록 설정 |
| Max Playlist Duration | 수신할 플레이리스트의 최대 총 길이 | 공식 문서의 기본값은 600초. 입력 목록의 전체 재생 시간을 기준으로 확인 |
주 / 예비 입력을 사용하는 경우 공식 문서는 Max Segment Duration에 실제 세그먼트 길이보다 약간의 여유를 둘 것을 권장합니다.
2. 채널 ID와 입력 확인
채널 상세의 Details에서 이름 / ID / 입력 프로토콜을 확인합니다. Input은 수신 주소, Output Endpoint는 재생 주소, CDN은 배포 연결을 확인하는 탭입니다.
캡처의 리소스 이름과 ID는 화면 설명용 예시입니다. 실제 작업할 채널의 값을 사용합니다. 입력 주소는 비공개 처리했습니다.
입력이 두 개 있다는 것은 두 수신 경로가 제공된다는 뜻입니다. 송출 시스템이 두 경로에 신호를 보내는지, 전환 후 타임스탬프와 재생이 이어지는지까지 확인해야 이중화를 검증할 수 있습니다.
3. 송출 시스템 연결
| 송출 방식 | 입력할 목적지 | 설정 위치 |
|---|---|---|
StreamLive의 HLS_STREAM_PACKAGE 출력 |
StreamPackage 채널 ID | StreamLive 출력 그룹의 목적지 |
| 외부 HLS 송출 시스템 | 콘솔에서 복사한 입력 URL과 필요한 HTTP 인증 정보 | 해당 송출 시스템의 전송 설정 |
StreamLive 전용 출력 그룹에는 StreamPackage 채널 ID를 지정합니다. 외부 송출은 입력 URL을 사용합니다.
4. 입력 인증
Input 탭의 Authentication에서 HTTP 인증을 구성할 수 있습니다. 인증을 사용하면 송출 시스템에도 대응하는 사용자 이름과 비밀번호를 적용해야 합니다.
- 입력 HTTP 인증은 누가 스트림을 넣을 수 있는지를 제어합니다.
- 엔드포인트의 AuthKey는
X-TENCENT-PACKAGE헤더를 사용하는 별도 인증 설정입니다. - 시청자용 CDN URL 서명은 CDN의 별도 인증 정책입니다.
입력 인증, 엔드포인트 인증, CDN 인증은 각 경로에 별도로 적용합니다.
Rotate credentials를 실행하면 기존 인증 정보가 무효화됩니다. 운영 송출 중에는 송출 측의 인증 정보 변경과 적용 시점을 함께 계획합니다.
5. 엔드포인트 생성 후 수신 검증
- 엔드포인트 구성에 따라 HLS 재생 주소를 만듭니다.
- 송출 시스템에서 이 채널로 스트림을 전송합니다.
- 재생 목록을 두 차례 이상 받아 미디어 시퀀스 또는 세그먼트 목록이 앞으로 진행하는지 확인합니다.
- 목록에 있는 세그먼트를 요청하고 플레이어로 영상과 오디오를 확인합니다.
입력 URL / 프로토콜 / HTTP 인증 / 송출 상태를 확인하고, 입력 수신과 플레이리스트 갱신 / 캐시 응답을 점검합니다.
API로 생성 / 조회
TCCLI 인증을 설정한 환경에서 실행합니다. 생성 명령은 새로운 리소스를 만듭니다.
tccli mdp CreateStreamPackageChannel --region ap-seoul --Name demo_package --Protocol HLS생성 응답에서 ID를 확인해 다음 명령에 적용합니다.
tccli mdp DescribeStreamPackageChannel --region ap-seoul --Id REPLACE_CHANNEL_ID입력 주소는 API 조회 응답 또는 콘솔에서 복사합니다.
캐시 설정과 구분
채널의 세그먼트 / 플레이리스트 길이 제한, API의 캐시 관련 설정, CDN TTL, 플레이어 버퍼는 서로 다른 계층입니다.
라이브 플레이리스트는 계속 바뀌므로 캐시된 응답만 반복해서 받으면 재생 위치가 뒤로 밀릴 수 있습니다. CDN의 TTL과 캐시 키, 응답의 캐시 헤더, 연속 조회한 플레이리스트의 변화를 함께 확인합니다. API 필드의 단위와 적용 대상은 사용 중인 API 버전의 정의를 확인한 뒤 변경합니다.
종료와 정리
테스트 종료 후 송출을 정지하고 CDN 연결 / 엔드포인트 / 채널 순서로 정리합니다. 리소스 ID와 사용 / 참조 관계를 확인한 뒤 진행합니다.