VOD Station 스트리밍 가이드

VOD Station은 CDN 상품과 연동하여 재생합니다.

채널 생성 시 CDN을 함께 생성했다면, 재생 정보는 VOD Station 채널 상세 정보의 CDN 재생 경로에서 확인이 가능합니다.

별도로 CDN을 생성한 경우 아래 별도 생성 CDN 재생 URL을 참고 부탁드립니다.

미디어 파일의 권한 설정

VOD Station에서 스트리밍할 미디어 파일의 전체 공개 설정은 공개로 설정되어야 합니다. 재생 전 파일의 권한을 확인 부탁드립니다.

bucket-1

① Objcet Storage 상품 > 연동된 Bucket > 재생할 미디어 파일을 선택하여 편집 클릭

② 파일의 권한을 설정하기 위해 권한 관리 클릭

bucket-2

공개 관리 > 전체 공개공개로 설정하고 확인 클릭

원본 미디어 파일 교체 시 주의사항

playback-1

서비스 중인 원본 미디어 파일(예시: vod-5100k.mp4) 교체 시 주의가 필요합니다.

  • 원본 미디어 파일 교체 시 가능하다면 동일한 파일명을 사용하지 않습니다. (예시: vod-5100k.mp4 -> vod-5100k-1.mp4)
  • 동일한 파일명을 사용해야 한다면, 파일 교체 10분 후 CDN 퍼지를 수행해 캐시된 기존 컨텐츠를 제거하여 서비스합니다.

VOD Station 재생 URL

재생 URL 구조
Scheme CDN Domain Streaming protocol Media file name Manifest
https://
example.cdn.ntruss.com
/hls
/dash
/example.mp4
/index.m3u8
/manifest.mpd
url scheme 재생 CDN 도메인 생성한 채널의 스트리밍 프로토콜 Object storage 버킷 내 폴더를 포함한 재생할 미디어 파일의 파일 명 Streaming을 제공하기 위한 Manifest

1. VOD Station CDN 재생 URL

VOD Station 채널을 생성할 때 함께 CDN을 생성한 경우 채널 Detail 탭의 CDN 재생 URL을 참고해 재생할 수 있습니다.

channel-1

  • URL Template: https://example.cdn.ntruss.com/[protocol]/[path]/[video filename]/[manifest]

2. 별도 생성 CDN 재생 URL

VOD Station 채널을 생성할 때 CDN을 생성하지 않고, 별도 생성한 경우 채널 Detail 탭의 CDN 재생 URL이 노출되지 않습니다.

channel-1

  • URL Template: https://[cdnDomain]/[protocol]/[path]/[video filename]/[manifest]

cdnDomain을 대체해 별도 생성한 CDN의 도메인으로 요청합니다.

VOD Station 재생하기

단일 비트레이트 재생

playback-1

① guide bucket 내의 vod-5100k.mp4 재생

bucket 아래 별도의 폴더 없이 존재하는 파일을 재생하므로 path 부분은 생략합니다.

  • URL Template: https://[cdnDomain]/[protocol]/[path]/[video filename]/[manifest]
    • HLS: https://example.cdn.ntruss.com/hls/vod-5100k.mp4/index.m3u8
    • DASH: https://example.cdn.ntruss.com/dash/vod-5100k.mp4/manifest.mpd

playback-2

② guide bucket 내 1-depth 폴더 안의 vod-5100k.mp4 재생

URL Template의 [Path] 부분에 bucket의 폴더명을 추가합니다.

  • URL Template: https://[cdnDomain]/[protocol]/[path]/[video filename]/[manifest]
    • HLS 재생: https://example.cdn.ntruss.com/hls/1-depth/vod-5100k.mp4/index.m3u8
    • DASH 재생: https://example.cdn.ntruss.com/dash/1-depth/vod-5100k.mp4/manifest.mpd

Adaptive 비트레이트 재생

Adaptive 비트레이트 재생을 위한 미디어 파일은 모두 같은 폴더에 위치해야 하며, 모든 파일이 공개로 설정되어야 합니다.

playback-2

① vod-5400k.mp4, vod-2400k.mp4, vod-1200k.mp4, vod-0900k.mp4, vod-0600k.mp4, vod-0300k.mp4 재생

prefix, suffix, 각 파일의 구분자로 쉼표(,)를 사용합니다. suffix 뒤에는 abr 요청임을 구분하는 .smil을 추가합니다.

  • 미디어 파일의 prefix: vod-
  • 미디어 파일의 suffix: k.mp4

  • URL Template: https://[cdnDomain]/[protocol]/[path]/[prefix],[video filenames],[suffix].smil/[manifest]

    • HLS 재생: https://example.cdn.ntruss.com/hls/abr/vod-,5400,2400,1200,0900,0600,0300,k.mp4.smil/master.m3u8 (HLS 요청 시엔 manifest로 index.m3u8이 아닌 master.m3u8을 사용합니다.)
    • DASH 재생: https://example.cdn.ntruss.com/dash/abr/vod-,5400,2400,1200,0900,0600,0300,k.mp4.smil/manifest.mpd

playback-2

② vod-0600k.mp4, vod-0300k.mp4, svod-360p.mp4 재생

파일 이름이 다른 경우엔 prefix와 suffix는 공백으로 두고 ","를 추가합니다.

  • 미디어 파일의 prefix: 없음
  • 미디어 파일의 suffix: 없음

  • URL Template: https://[cdnDomain]/[protocol]/[path]/[prefix],[video filenames],[suffix].smil/[manifest]

    • HLS 재생: https://example.cdn.ntruss.com/hls/abr/,vod-0600k.mp4,vod-0300k.mp4,svod-360p.mp4,.smil/master.m3u8
    • DASH 재생: https://example.cdn.ntruss.com/dash/abr/,vod-0600k.mp4,vod-0300k.mp4,svod-360p.mp4,.smil/manifest.mpd

미디어 파일 자르기(Cropping VOD)

VOD Station은 미디어 파일의 Cropping을 지원합니다.

① VOD의 10초 지점부터 재생(vodStart)

시간 단위는 밀리초입니다(1초 = 1000밀리초). Cropping 옵션은 [protocol] 뒤에 위치합니다.

  1. 단일 비트레이트

    • URL Template: https://[cdnDomain]/[protocol]/vodStart/[time]/[path]/[video filename]/[manifest]
      • HLS 재생: https://example.cdn.ntruss.com/hls/vodStart/10000/1-depth/vod-5100k.mp4/index.m3u8
      • DASH 재생: https://example.cdn.ntruss.com/dash/vodStart/10000/1-depth/vod-5100k.mp4/manifest.mpd
  2. Adaptive 비트레이트

    • URL Template: https://[cdnDomain]/[protocol]/vodStart/[time]/[path]/[prefix],[video filenames],[suffix].smil/[manifest]
      • HLS 재생: https://example.cdn.ntruss.com/hls/vodStart/10000/abr/vod-,5400,2400,k.mp4.smil/master.m3u8
      • DASH 재생: https://example.cdn.ntruss.com/dash/vodStart/10000/abr/vod-,5400,2400,k.mp4.smil/manifest.mpd

② VOD의 시작부터 10초까지 재생(vodEnd)

시간 단위는 밀리초입니다(1초 = 1000밀리초). Cropping 옵션은 [protocol] 뒤에 위치합니다.

  1. 단일 비트레이트

    • URL Template: https://[cdnDomain]/[protocol]/vodEnd/[time]/[path]/[video filename]/[manifest]
      • HLS 재생: https://example.cdn.ntruss.com/hls/vodEnd/10000/1-depth/vod-5100k.mp4/index.m3u8
      • DASH 재생: https://example.cdn.ntruss.com/dash/vodEnd/10000/1-depth/vod-5100k.mp4/manifest.mpd
  2. Adaptive 비트레이트

    • URL Template: https://[cdnDomain]/[protocol]/vodEnd/[time]/[path]/[prefix],[video filenames],[suffix].smil/[manifest]
      • HLS 재생: https://example.cdn.ntruss.com/hls/vodEnd/10000/abr/vod-,5400,2400,k.mp4.smil/master.m3u8
      • DASH 재생: https://example.cdn.ntruss.com/dash/vodEnd/10000/abr/vod-,5400,2400,k.mp4.smil/manifest.mpd

③ VOD의 1분 지점부터 2분 지점까지만 재생(vodStart, vodEnd)

시간 단위는 밀리초입니다(1초 = 1000밀리초). Cropping 옵션은 [protocol] 뒤에 위치합니다.

  1. 단일 비트레이트

    • URL Template: https://[cdnDomain]/[protocol]/vodStart/[time]/vodEnd/[time]/[path]/[video filename]/[manifest]
      • HLS 재생: https://example.cdn.ntruss.com/hls/vodStart/60000/vodEnd/120000/1-depth/vod-5100k.mp4/index.m3u8
      • DASH 재생: https://example.cdn.ntruss.com/dash/vodStart/60000/vodEnd/120000/1-depth/vod-5100k.mp4/manifest.mpd
  2. Adaptive 비트레이트

    • URL Template: https://[cdnDomain]/[protocol]/vodEnd/[time]/[path]/[prefix],[video filenames],[suffix].smil/[manifest]
      • HLS 재생: https://example.cdn.ntruss.com/hls//vodStart/60000/vodEnd/120000/abr/vod-,5400,2400,k.mp4.smil/master.m3u8
      • DASH 재생: https://example.cdn.ntruss.com/dash//vodStart/60000/vodEnd/120000/abr/vod-,5400,2400,k.mp4.smil/manifest.mpd

""에 대한 건이 검색되었습니다.

    ""에 대한 검색 결과가 없습니다.

    처리중...