4. 송출하고 재생 확인하기

앞의 세 단계에서 구성한 전송 경로에 테스트 신호를 보내고, StreamPackage 원본과 CSS CDN을 차례로 확인합니다.

사전 준비

• StreamLink Flow와 StreamLive 채널이 시작된 상태인지 확인합니다.
• StreamLink 입력의 실제 송출 주소를 준비합니다.
• StreamPackage Endpoint URL과 CSS 재생 URL을 준비합니다.
• 송출 IP 허용 정책, 필요한 인증 정보, DNS와 HTTPS 인증서를 확인합니다.
• FFmpeg / ffprobe / ffplay 또는 OBS와 HLS 재생 플레이어를 준비합니다.

아래 URL은 설명용입니다.

1. 테스트 신호 송출

OBS에서는 StreamLink 입력 설정에 맞는 서버 주소와 스트림 키를 입력하고 송출을 시작합니다. FFmpeg를 사용하는 경우 아래와 같이 영상 패턴과 440Hz 테스트음을 보낼 수 있습니다. 테스트음 재생 전 볼륨을 낮춥니다.

STREAM_PUSH_URL='rtmp://YOUR_STREAMLINK_HOST/YOUR_APP/YOUR_STREAM_KEY'
ffmpeg -re \
  -f lavfi -i "testsrc=size=1920x1080:rate=30" \
  -f lavfi -i "sine=frequency=440:sample_rate=48000" \
  -c:v libx264 -preset veryfast -b:v 4000k -maxrate 4000k -bufsize 8000k \
  -pix_fmt yuv420p -g 60 \
  -c:a aac -b:a 128k -ar 48000 \
  -f flv "$STREAM_PUSH_URL"

FFmpeg 로그의 송출 프레임 수와 시간, StreamLink 입력 주소 / 프로토콜 / 포트 / 허용 IP 및 목적지 수신 상태를 확인합니다.

2. 전송과 처리 상태 확인

RUNNING 상태와 입력 / 출력 지표, 최종 재생을 함께 확인합니다.

3. 원본 마스터 플레이리스트 확인

STREAM_ORIGIN_URL='https://YOUR_PACKAGE_HOST/YOUR_ENDPOINT_PATH/index.m3u8'
curl --fail-with-body --show-error --silent --max-time 20 "$STREAM_ORIGIN_URL"

엔드포인트 인증이 설정되어 있다면 해당 요청에 필요한 헤더나 인증 정보를 별도로 적용합니다.

다음은 두 해상도가 포함된 목록의 형식 예시입니다. 파일명과 수치는 실제 설정에 따라 달라집니다.

#EXTM3U
#EXT-X-STREAM-INF:BANDWIDTH=2128000,RESOLUTION=1280x720,FRAME-RATE=30.000
720p.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=4128000,RESOLUTION=1920x1080,FRAME-RATE=30.000
1080p.m3u8

두 항목이 보이면 마스터 목록에 두 출력이 선언된 것입니다. 각 출력의 영상이 정상인지 확인하려면 미디어 목록과 실제 세그먼트까지 내려가야 합니다.

4. 미디어 목록과 세그먼트 확인

마스터에 적힌 미디어 목록 URI를 실제 마스터 URL 기준으로 해석합니다. 파일명만 있으면 같은 디렉터리를, /로 시작하면 같은 호스트의 루트를 기준으로 합니다. 완전한 URL이면 그 주소를 그대로 사용합니다.

STREAM_MEDIA_URL='https://YOUR_PACKAGE_HOST/YOUR_ENDPOINT_PATH/720p.m3u8'
curl --fail-with-body --show-error --silent --max-time 20 "$STREAM_MEDIA_URL"

다음 형식의 목록을 몇 초 간격으로 다시 확인합니다.

#EXTM3U
#EXT-X-TARGETDURATION:4
#EXT-X-MEDIA-SEQUENCE:100
#EXTINF:4.000,
segment100.ts
#EXTINF:4.000,
segment101.ts

• 라이브 송출 중 새 세그먼트가 추가되는지 확인합니다.
• 슬라이딩 목록에서는 시간이 지나면 MEDIA-SEQUENCE도 증가하는지 확인합니다.
• 목록에 적힌 세그먼트 URL이 실제로 접근 가능한지 확인합니다.
• 720p와 1080p 각각에서 영상 / 오디오가 포함되어 있는지 확인합니다.

ffprobe -v error -show_entries stream=codec_type,codec_name,width,height,r_frame_rate \
  -of json "$STREAM_MEDIA_URL"

ffprobe 결과는 미디어 형식 확인에 사용합니다. 검은 화면, 음소거, 끊김 여부는 실제 재생으로 별도 확인해야 합니다.

5. CDN을 통한 재생 확인

StreamPackage에 연결된 CSS 재생 URL로 같은 검사를 반복합니다.

STREAM_CDN_URL='https://YOUR_PLAYBACK_DOMAIN/YOUR_ENDPOINT_PATH/index.m3u8'
curl --fail-with-body --show-error --silent --max-time 20 \
  --dump-header - --output /dev/null "$STREAM_CDN_URL"
ffplay "$STREAM_CDN_URL"

플레이어에서 영상 패턴과 테스트음이 재생되는지, 일정 시간 동안 정지 없이 이어지는지 확인합니다. 자동 화질 선택으로 한 해상도만 재생될 수 있으므로 각 미디어 목록도 따로 검사합니다.

HTTPS 재생은 유효한 인증서 / 호스트 이름 / 인증서 체인으로 확인합니다.

장애 구간 구분

해당 요청의 호스트 / 경로 / 응답 / 구간별 로그를 함께 확인합니다.

완료 기준

1. StreamLink와 StreamLive에서 원본 수신 및 출력 전달 확인
2. StreamPackage 마스터에 필요한 해상도 목록 확인
3. 각 미디어 목록의 갱신과 세그먼트 접근 확인
4. 원본과 CSS CDN에서 실제 영상 / 오디오 재생 확인
5. 재생 중 입력 / 출력 상태와 연속 재생 확인

테스트 종료

FFmpeg는 실행 중인 터미널에서 Ctrl+C로 송출을 종료합니다. 이후 테스트용 StreamLink Flow와 StreamLive 채널을 중지합니다. 삭제는 선택 사항이며, 공유 리소스 여부와 의존성을 먼저 확인합니다.

실행 리소스와 저장 / 전송 사용량을 함께 확인합니다.

관련 문서

• StreamLink Flow 관리
• StreamLive 채널 관리
• StreamPackage 및 CDN 구성