Documentation Index

Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt

Use this file to discover all available pages before exploring further.

VOD 스트리밍

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

VOD 스트리밍을 위한 채널을 생성하고 CDN 플랫폼과의 연동 설정을 완료했다면 재생 경로 URL로 콘텐츠를 재생해 스트리밍 서비스 구현 상태를 확인할 수 있습니다. 재생 시작 지점과 종료 지점을 설정해 파일 트리밍을 적용하거나 자막을 적용할 수 있습니다.

주의
  • 서비스 중인 원본 미디어 파일을 교체할 때에는 동일한 파일명을 사용하지 마십시오. 동일한 파일명을 사용해야 한다면, 파일을 교체하고 최소 10분이 지난 후에 CDN 퍼지를 수행하여 캐시된 기존 콘텐츠를 제거해 주십시오.
  • 원본 파일명에 #, $, ; 문자가 포함된 경우 재생 경로 URL을 통한 프로토콜 재생이 불가능합니다. 원본 파일명에 해당 특수문자가 포함되지 않도록 주의해 주십시오.
  • VOD Station은 오디오 스트리밍을 지원합니다. VOD Station에서 인코딩된 m4a 파일 또는 VOD Station 채널 입력 사양을 만족하는 m4a 파일을 사용해 주십시오.
    • VOD Station 채널 입력 사양은 사용 가이드를 참조해 주십시오.
  • Live Station에서 생성된 m4a 레코딩 파일은 세그먼트 파일이므로 VOD 스트리밍으로 재생할 수 없습니다.

재생 경로 URL 확인

재생 경로 URL의 구성 요소는 다음과 같습니다.

구성 요소 예시 설명
Scheme https:// URL Scheme
CDN 도메인 example.edge.naverncp.com 재생 CDN 도메인
스트리밍 프로토콜 /hls, /dash 생성한 채널의 스트리밍 프로토콜
파일 이름 /example/example.mp4 Object Storage 버킷 및 폴더 경로를 포함한 재생 미디어 파일 이름
매니페스트 /index.m3u8, /manifest.mpd 스트리밍 제공을 위한 매니페스트 파일

CDN 재생 경로 URL

채널을 생성할 때 CDN을 함께 생성했다면 채널 정보의 CDN 재생 경로 URL을 참고해 재생할 수 있습니다. 채널 목록에서 재생할 채널을 선택하고 [채널 정보] 버튼을 클릭한 후 정보 팝업 창의 CDN 재생경로 영역에서 URL을 확인해 주십시오.

  • URL 템플릿: https://example.edge.naverncp.com/[protocol]/[encryptedBucketName]/[path]/[video filename]/[manifest]

별도 생성 CDN 재생 경로 URL

채널을 생성할 때 CDN을 생성하지 않고 별도로 생성한 경우에는 채널 정보에 CDN 재생 경로 URL이 노출되지 않습니다. CDN 목록에서 생성한 CDN의 서비스 도메인을 확인한 후 URL 템플릿의 [cdnDomain] 부분을 대체해 콘텐츠를 재생해 주십시오.

  • URL 템플릿: https://[cdnDomain]/[protocol]/[encryptedBucketName]/[path]/[video filename]/[manifest]

재생 경로 URL 생성

채널을 생성할 때 Global Edge를 함께 생성했다면 콘텐츠별 CDN 재생 경로 URL을 자동으로 생성할 수 있습니다. 재생 경로 URL을 생성하는 방법은 다음과 같습니다.

  1. 네이버 클라우드 플랫폼 콘솔에서 Menu > Services > Media > VOD Station 메뉴를 차례대로 클릭해 주십시오.
  2. Channel 메뉴를 클릭한 후 채널 목록에서 채널을 선택해 주십시오.
  3. 채널의 콘텐츠 목록에서 자동 URL을 생성할 콘텐츠의 [HLS URL 생성] 또는 [DASH URL 생성] 버튼을 클릭해 주십시오.
    • 생성된 URL로 바로 연결되어 콘텐츠가 재생됩니다.

콘텐츠 재생

채널의 콘텐츠를 재생해 VOD 스트리밍 서비스의 구현 상태를 확인할 수 있습니다. 다음의 예시를 참고하여 콘텐츠를 재생해 주십시오.

단일 비트레이트 재생

단일 비트레이트 콘텐츠의 재생 경로 URL 예시는 다음과 같습니다.

구분 재생 대상 [path] 설정
버킷 루트 파일 guide 버킷 바로 아래의 vod-5100k.mp4 생략
1-depth 폴더 파일 guide 버킷의 1-depth 폴더 아래의 vod-5100k.mp4 1-depth

URL 템플릿은 다음과 같습니다.

https://[cdnDomain]/[protocol]/[encryptedBucketName]/[path]/[video filename]/[manifest]

[path]가 없는 경우 URL에서 [encryptedBucketName] 뒤에 바로 [video filename]을 입력합니다.

버킷 루트 파일의 재생 경로 URL 예시는 다음과 같습니다.

HLS: https://example.edge.naverncp.com/hls/guide/vod-5100k.mp4/index.m3u8
DASH: https://example.edge.naverncp.com/dash/guide/vod-5100k.mp4/manifest.mpd

1-depth 폴더 파일의 재생 경로 URL 예시는 다음과 같습니다.

HLS: https://example.edge.naverncp.com/hls/guide/1-depth/vod-5100k.mp4/index.m3u8
DASH: https://example.edge.naverncp.com/dash/guide/1-depth/vod-5100k.mp4/manifest.mpd

Adaptive 비트레이트 재생

Adaptive 비트레이트 재생을 위한 미디어 파일은 모두 같은 폴더에 있어야 합니다. Adaptive 비트레이트 재생 경로 URL 예시는 다음과 같습니다.

구분 재생 대상 prefix suffix
동일한 파일명 패턴 guide 버킷의 abr 폴더 아래 vod-5400k.mp4, vod-2400k.mp4, vod-1200k.mp4, vod-0900k.mp4, vod-0600k.mp4, vod-0300k.mp4 vod- k.mp4
다른 파일명 패턴 guide 버킷의 abr 폴더 아래 vod-0600k.mp4, vod-0300k.mp4, svod-360p.mp4 없음 없음

URL 템플릿은 다음과 같습니다.

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

동일한 파일명 패턴을 사용하는 경우 prefix, 재생할 파일명 구분값, suffix를 쉼표(,)로 구분합니다. suffix 뒤에는 Adaptive 비트레이트 요청을 구분하는 .smil을 추가합니다.

HLS: https://example.edge.naverncp.com/hls/guide/abr/vod-,5400,2400,1200,0900,0600,0300,k.mp4.smil/master.m3u8
DASH: https://example.edge.naverncp.com/dash/guide/abr/vod-,5400,2400,1200,0900,0600,0300,k.mp4.smil/manifest.mpd
참고

HLS 요청 시 매니페스트 파일은 index.m3u8이 아닌 master.m3u8을 사용해 주십시오.

파일 이름 패턴이 다른 경우 prefix와 suffix 값 없이 재생할 파일명을 쉼표(,)로 구분합니다.

HLS:  https://example.edge.naverncp.com/hls/guide/abr/,vod-0600k.mp4,vod-0300k.mp4,svod-360p.mp4,.smil/master.m3u8
DASH: https://example.edge.naverncp.com/dash/guide/abr/,vod-0600k.mp4,vod-0300k.mp4,svod-360p.mp4,.smil/manifest.mpd

미디어 파일 자르기

미디어 파일의 재생 지점을 설정해 파일 자르기(Cropping) 기능을 사용할 수 있습니다.

재생 시작 지점 지정

다음 예시는 VOD의 재생 시작 지점(vodStart)을 10초로 지정해 재생하는 방법을 보여줍니다. 시간 단위는 밀리초입니다(1초 = 1000밀리초). 파일 자르기 옵션은 [protocol]/[encryptedBucketName] 뒤에 위치합니다.

구분 URL 템플릿
단일 비트레이트 재생 https://[cdnDomain]/[protocol]/[encryptedBucketName]/vodStart/[time]/[path]/[video filename]/[manifest]
Adaptive 비트레이트 재생 https://[cdnDomain]/[protocol]/[encryptedBucketName]/vodStart/[time]/[path]/[prefix],[video filenames],[suffix].smil/[manifest]

단일 비트레이트 재생 경로 URL 예시는 다음과 같습니다.

HLS: https://example.edge.naverncp.com/hls/Bxpv-g0eEp-Gu4pCSAHOPQ__/vodStart/10000/guide/1-depth/vod-5100k.mp4/index.m3u8
DASH: https://example.edge.naverncp.com/dash/Bxpv-g0eEp-Gu4pCSAHOPQ__/vodStart/10000/guide/1-depth/vod-5100k.mp4/manifest.mpd

Adaptive 비트레이트 재생 경로 URL 예시는 다음과 같습니다.

HLS: https://example.edge.naverncp.com/hls/Bxpv-g0eEp-Gu4pCSAHOPQ__/vodStart/10000/guide/abr/vod-,5400,2400,k.mp4.smil/master.m3u8
DASH: https://example.edge.naverncp.com/dash/Bxpv-g0eEp-Gu4pCSAHOPQ__/vodStart/10000/guide/abr/vod-,5400,2400,k.mp4.smil/manifest.mpd

재생 종료 지점 지정

다음 예시는 VOD의 재생 종료 지점(vodEnd)을 10초로 지정해 재생하는 방법을 보여줍니다. 시간 단위는 밀리초입니다(1초 = 1000밀리초). 파일 자르기 옵션은 [protocol]/[encryptedBucketName] 뒤에 위치합니다.

구분 URL 템플릿
단일 비트레이트 재생 https://[cdnDomain]/[protocol]/[encryptedBucketName]/vodEnd/[time]/[path]/[video filename]/[manifest]
Adaptive 비트레이트 재생 https://[cdnDomain]/[protocol]/[encryptedBucketName]/vodEnd/[time]/[path]/[prefix],[video filenames],[suffix].smil/[manifest]

단일 비트레이트 재생 경로 URL 예시는 다음과 같습니다.

HLS: https://example.edge.naverncp.com/hls/Bxpv-g0eEp-Gu4pCSAHOPQ__/vodEnd/10000/guide/1-depth/vod-5100k.mp4/index.m3u8
DASH: https://example.edge.naverncp.com/dash/Bxpv-g0eEp-Gu4pCSAHOPQ__/vodEnd/10000/guide/1-depth/vod-5100k.mp4/manifest.mpd

Adaptive 비트레이트 재생 경로 URL 예시는 다음과 같습니다.

HLS: https://example.edge.naverncp.com/hls/Bxpv-g0eEp-Gu4pCSAHOPQ__/vodEnd/10000/guide/abr/vod-,5400,2400,k.mp4.smil/master.m3u8
DASH: https://example.edge.naverncp.com/dash/Bxpv-g0eEp-Gu4pCSAHOPQ__/vodEnd/10000/guide/abr/vod-,5400,2400,k.mp4.smil/manifest.mpd

재생 시작 및 종료 지점 지정

다음 예시는 VOD의 1분 지점부터 2분 지점까지(vodStart, vodEnd) 재생하는 방법을 보여줍니다. 시간 단위는 밀리초입니다(1초 = 1000밀리초). 파일 자르기 옵션은 [protocol]/[encryptedBucketName] 뒤에 위치합니다.

구분 URL 템플릿
단일 비트레이트 재생 https://[cdnDomain]/[protocol]/[encryptedBucketName]/vodStart/[startTime]/vodEnd/[endTime]/[path]/[video filename]/[manifest]
Adaptive 비트레이트 재생 https://[cdnDomain]/[protocol]/[encryptedBucketName]/vodStart/[startTime]/vodEnd/[endTime]/[path]/[prefix],[video filenames],[suffix].smil/[manifest]

단일 비트레이트 재생 경로 URL 예시는 다음과 같습니다.

HLS: https://example.edge.naverncp.com/hls/Bxpv-g0eEp-Gu4pCSAHOPQ__/vodStart/60000/vodEnd/120000/guide/1-depth/vod-5100k.mp4/index.m3u8
DASH: https://example.edge.naverncp.com/dash/Bxpv-g0eEp-Gu4pCSAHOPQ__/vodStart/60000/vodEnd/120000/guide/1-depth/vod-5100k.mp4/manifest.mpd

Adaptive 비트레이트 재생 경로 URL 예시는 다음과 같습니다.

HLS: https://example.edge.naverncp.com/hls/Bxpv-g0eEp-Gu4pCSAHOPQ__/vodStart/60000/vodEnd/120000/guide/abr/vod-,5400,2400,k.mp4.smil/master.m3u8
DASH: https://example.edge.naverncp.com/dash/Bxpv-g0eEp-Gu4pCSAHOPQ__/vodStart/60000/vodEnd/120000/guide/abr/vod-,5400,2400,k.mp4.smil/manifest.mpd

오디오 설정

배포하는 영상 콘텐츠에 다중 언어 오디오를 적용할 수 있습니다. 지원하는 오디오 형식은 다음과 같습니다.

입력 코덱
AAC, MP3, AC-3, E-AC-3

영상 및 오디오 파일 위치 지정

영상 파일과 오디오 파일의 위치는 ABR URL이 시작되는 쉼표(,) 앞의 [path]를 기준으로 합니다. 영상 파일과 오디오 파일은 [path] 아래에 있어야 합니다.
https://example.edge.naverncp.com/[protocol]/[encryptedBucketName]/[path]/,[video files],lang/[lang code]/[audio filename],.smil/master.m3u8

오디오 언어 설정

언어 구분은 URL 내에 [lang code]로 분류됩니다.
https://example.edge.naverncp.com/[protocol]/[encryptedBucketName]/[path]/,[video files],lang/[lang code]/[audio filename],.smil/master.m3u8

참고

언어 코드는 ISO 639-3 규격의 3자리 코드를 사용해야 합니다. ISO639-3 코드 목록을 참조해 주십시오.

자막 설정

배포하는 영상 콘텐츠에 자막을 적용할 수 있습니다. 지원되는 자막 형식은 다음과 같습니다.

입력 출력
VTT, SRT, DFXP, TTML, CAP VTT

영상 및 자막 파일 위치 지정

영상 파일과 자막 파일의 위치는 ABR URL이 시작되는 쉼표(,) 앞의 [path]를 기준으로 합니다. 영상 파일과 자막 파일은 [path] 아래에 있어야 합니다.

https://example.edge.naverncp.com/[protocol]/[encryptedBucketName]/[path]/,[video files],lang/[lang code]/[subtitle filename],.smil/master.m3u8

자막 언어 설정

언어 구분은 URL 내에 [lang code]로 분류됩니다.
https://example.edge.naverncp.com/[protocol]/[encryptedBucketName]/[path]/,[video files],lang/[lang code]/[subtitle filename],.smil/master.m3u8

참고

언어 코드는 ISO 639-3 규격의 3자리 코드를 사용해야 합니다. ISO639-3 코드 목록을 참조해 주십시오.

다중 언어 자막 및 오디오 사용

다중 언어 자막 및 오디오를 사용하는 URL 예시는 다음과 같습니다.

단일 비트레이트, 단일 자막

URL 템플릿: https://[cdnDomain]/[protocol]/[encryptedBucketName]/[path]/,[video file],lang/[lang code]/[subtitle filename],.smil/[manifest]

  • HLS: https://example.edge.naverncp.com/hls/guide/,vod-5100k.mp4,lang/kor/sample.vtt,.smil/master.m3u8
  • DASH: https://example.edge.naverncp.com/dash/guide/,vod-5100k.mp4,lang/kor/sample.vtt,.smil/manifest.mpd

단일 비트레이트, 단일 자막, 다중 언어 오디오

URL 템플릿: https://[cdnDomain]/[protocol]/[encryptedBucketName]/[path]/,[video file],lang/[lang code]/[audio filename],...lang/[lang code]/[audio filename],lang/[lang code]/[subtitle filename],.smil/[manifest]

  • HLS : https://example.edge.naverncp.com/hls/guide/,vod-5100k.mp4,lang/kor/sample-kor.m4a,lang/eng/sample-eng.m4a,lang/kor/sample.vtt,.smil/master.m3u8
  • DASH : https://example.edge.naverncp.com/dash/guide/,vod-5100k.mp4,lang/kor/sample-kor.m4a,lang/eng/sample-eng.m4a,lang/kor/sample.vtt,.smil/manifest.mpd

단일 비트레이트, 다중 언어 오디오, 다중 언어 자막

URL 템플릿: https://[cdnDomain]/[protocol]/[encryptedBucketName]/[path]/,[video file],lang/[lang code]/[audio filename],...lang/[lang code]/[audio filename],lang/[lang code]/[subtitle filename],...lang/[lang code]/[subtitle filename],.smil/[manifest]

  • HLS : https://example.edge.naverncp.com/hls/guide/,vod-5100k.mp4,lang/kor/sample-kor.m4a,lang/eng/sample-eng.m4a,lang/kor/sample-k.vtt,lang/eng/sample-en.vtt,.smil/master.m3u8
  • DASH : https://example.edge.naverncp.com/dash/guide/,vod-5100k.mp4,lang/kor/sample-kor.m4a,lang/eng/sample-eng.m4a,lang/kor/sample-k.vtt,lang/eng/sample-en.vtt,.smil/manifest.mpd

다중 비트레이트, 다중 언어 자막, 다중 언어 오디오

URL 템플릿: https://[cdnDomain]/[protocol]/[encryptedBucketName]/[path]/,[video files],lang/[lang code]/[audio filename],...lang/[lang code]/[audio filename],lang/[lang code]/[subtitle filename],lang/[lang code]/[subtitle filename],...lang/[lang code]/[subtitle filename],.smil/[manifest]

  • HLS: https://example.edge.naverncp.com/hls/guide/,vod-5100k.mp4,vod-2400k.mp4,lang/kor/sample-kor.m4a,lang/eng/sample-eng.m4a,lang/kor/sample-k.vtt,lang/eng/sample-en.vtt,.smil/master.m3u8
  • DASH: https://example.edge.naverncp.com/dash/guide/,vod-5100k.mp4,vod-2400k.mp4,lang/kor/sample-kor.m4a,lang/eng/sample-eng.m4a,lang/kor/sample-k.vtt,lang/eng/sample-en.vtt,.smil/manifest.mpd

보안 설정

미디어 파일의 보안을 강화하려면 Global Edge의 Signed URL 설정을 사용해 주십시오. Signed URL 설정 방법은 Global Edge Signed URL 사용 가이드를 참조해 주십시오.

사업자등록번호: 129-86-31394 통신판매업신고번호:제2009-경기성남-0510호
대표이사: 김유원 주소: 경기도 성남시 분당구 불정로 6 네이버 그린팩토리 17~26층, 13561 고객지원 대표전화: 1544-5876
© NAVER Cloud Corp. All Rights Reserved.