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. NAVERクラウドプラットフォームコンソールで、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.mp4vod-2400k.mp4vod-1200k.mp4vod-0900k.mp4vod-0600k.mp4vod-0300k.mp4 vod- k.mp4
他のファイル名のパターン guide バケットの abr フォルダ下位の vod-0600k.mp4vod-0300k.mp4svod-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を使用してください。

ファイル名のパターンが異なる場合は、prefixsuffix 値なしで再生するファイル名をコンマ(,)で区切ります。

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分の位置まで(vodStartvodEnd)再生する方法を示します。時間単位はミリ秒です(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 ご利用ガイドをご参照ください。