StreamLive 입력 구성
On this page
Input은 StreamLive가 원본 영상을 받는 연결입니다. 인코더가 직접 보내는 경우와 StreamLink가 중계하는 경우 모두 입력이 필요합니다.
PUSH와 PULL 구분
| 입력 유형 | 연결을 시작하는 쪽 | 사용 예 |
|---|---|---|
| RTMP_PUSH / RTMPS_PUSH | 인코더 또는 중계 서비스 | StreamLive가 제공한 주소로 송출 |
| RTMP_PULL | StreamLive | 접근 가능한 RTMP 원본에서 수신 |
| SRT_PUSH | 송출 측 | StreamLive 수신 주소로 전송 |
| SRT_PULL | StreamLive | 원본 SRT Listener에 연결하여 수신 |
| HLS_PULL | StreamLive | 접근 가능한 HLS 원본에서 수신 |
StreamLink 출력이 SRT Caller라면 수신 측은 Listener 역할이어야 합니다. 입력 목록의 Type과 실제 연결 방향을 먼저 대조합니다.
사전 준비
- 사용할 프로토콜과 원본 영상 / 오디오 형식을 확인합니다.
- PUSH 입력은 입력 보안 그룹을 준비합니다.
- PULL 입력은 원본 주소, 네트워크 접근성과 필요한 인증을 확인합니다.
RTMP 입력 생성
- StreamLive 콘솔에서 Input → Create Input을 선택합니다.
- 이름과 RTMP_PUSH 유형을 지정합니다.
- 보안 그룹을 연결합니다.
- Destination의 application name과 stream name을 입력합니다.
- 사용자 이름 / 비밀번호 인증을 사용하는 경우 송출 측 설정에도 반영합니다.
- 저장 후 생성된 입력 주소를 확인합니다.
입력 이름은 영문 / 숫자 / 밑줄로 1~32자 범위에서 지정합니다.
RTMP_PUSH 입력 생성 폼에서 Security Group을 선택하고 Destination A에 application name과 stream name을 지정한 뒤 Confirm을 누릅니다. Destination B는 두 번째 파이프라인에 사용합니다.
송출 주소 연결
| 수신 측 설정 | 송출 측에 입력할 값 |
|---|---|
| 생성된 RTMP 호스트와 application name | 서버 URL |
| stream name | Stream Key |
| 사용자 이름 / 비밀번호 인증 | 송출 프로그램의 인증 설정 |
FFmpeg처럼 전체 RTMP URL을 받는 프로그램에서는 해당 프로그램 형식에 맞게 조합합니다.
API 예시
YOUR_SECURITY_GROUP_ID를 생성한 그룹 ID로 바꿉니다. 이 예시는 RTMP 입력 생성이며 채널 연결은 별도입니다.
tccli mdl CreateStreamLiveInput --region ap-seoul \
--Name demo_input \
--Type RTMP_PUSH \
--SecurityGroupIds '["YOUR_SECURITY_GROUP_ID"]' \
--InputSettings '[{"AppName":"demo","StreamName":"demo_stream"}]'tccli mdl DescribeStreamLiveInput --region ap-seoul --Id YOUR_INPUT_ID조회 응답에서 입력 유형, 연결된 보안 그룹, application name과 stream name, 생성된 주소를 확인합니다.
채널 연결과 이중화
Input을 Channel에 연결합니다. Attached 상태와 실제 송출 / 수신 지표를 함께 확인합니다.
하나의 Input이 제공하는 A/B 파이프라인과 채널에 여러 Input을 연결하는 구성은 다릅니다. 사용할 입력 전환 정책과 양쪽 원본 송출을 함께 확인합니다.
확인과 테스트 종료
채널을 시작하고 허용된 송출 측에서 테스트 신호를 보냅니다. 주소 / 키 / 프로토콜 / IP / 인증과 출력 재생을 확인합니다.
테스트 송출을 종료하고 전용 Input을 정리합니다.