Transloadit でストリーミング用動画をエンコードするガイド

Transloadit の私たちと同じく、ストリーミングサービスが好きな方は多いでしょう 🎥
では、自分でサービスを立ち上げようと考えたことはありますか?そんな大胆なアイデアを支えるのが、/video/adaptive Robotです!このRobotを使うと、mp4 または webm の動画を
HLS(HTTP Live Streaming)または MPEG-DASH にエンコードできます。
この記事では、ブラウザーの互換性に応じて HLS または MPEG-DASH の動画をストリーミングする、基本的な概念実証用のアダプティブプレーヤーを React で作成します。JavaScript デモの一例 (English)と同様の仕組みを、順を追って解説します。

HLS と MPEG-DASH とは?
まず、HLS と MPEG-Dash がどのようなものかを確認しましょう。どちらも動画データを小さなチャンクに分割し、HTTP 経由でデバイスにダウンロードするストリーミングプロトコルです。どちらのプロトコルも、ネットワークの状態に応じてエンコード済みの動画を切り替えるアダプティブ再生に対応しています。HLS は Apple デバイスでネイティブ再生に対応しています。一方、MPEG-DASH はオープン標準であり、通常は JavaScript プレーヤーを通じて再生します。再生と暗号化配信の可否は、プレイリスト形式だけでなく、ブラウザー、プレーヤー、コーデック、DRM の実装によって決まります。
このチュートリアルでは、両方の形式にエンコードし、アダプティブ動画プレーヤーで使用します。
Assembly によるファイルの保存
まずは以下のAssemblyで、Robotの使い方の全体像を見てみましょう。
{
"steps": {
":original": {
"robot": "/upload/handle"
},
"hls-encode": {
"use": ":original",
"robot": "/video/encode",
"ffmpeg_stack": "v7",
"preset": "hls-720p"
},
"dash-encode": {
"use": ":original",
"robot": "/video/encode",
"ffmpeg_stack": "v7",
"preset": "dash-720p-video"
},
"thumbnailed": {
"use": "hls-encode",
"robot": "/video/thumbs",
"result": true,
"ffmpeg_stack": "v7"
},
"hls-adaptive": {
"use": {
"steps": ["hls-encode"],
"bundle_steps": true
},
"robot": "/video/adaptive",
"ffmpeg_stack": "v7",
"playlist_name": "my_playlist.m3u8",
"segment_duration": 6,
"closed_captions": false,
"technique": "hls"
},
"dash-adaptive": {
"use": {
"steps": ["dash-encode"],
"bundle_steps": true
},
"robot": "/video/adaptive",
"ffmpeg_stack": "v7",
"playlist_name": "my_playlist.mpd",
"segment_duration": 6,
"technique": "dash"
},
"export-plain": {
"use": "thumbnailed",
"robot": "/google/store",
"credentials": "stream-test",
"acl": "public-read",
"path": "stream-videos/${file.name}"
},
"export-hls": {
"use": "hls-adaptive",
"robot": "/google/store",
"credentials": "stream-test",
"acl": "public-read",
"path": "stream-videos/hls-video/${file.name}"
},
"export-dash": {
"use": "dash-adaptive",
"robot": "/google/store",
"credentials": "stream-test",
"acl": "public-read",
"path": "stream-videos/dash-video/${file.name}"
}
}
}
このAssembly Instructionsは長く見えますが、心配はいりません。順に見ていきましょう。
最初のStepで使う /upload/handle Robotの役割は明快です。エンドユーザーから動画を受け取ります。
次に、/video/encode Robotが、アップロードされた動画を hls-encode と dash-encode の
Stepで、それぞれ HLS と MPEG-DASH にエンコードします。これらは、/video/adaptive Robotに必要な
Stepです。
続いて、動画プレーヤーで使うために、動画からサムネイルを簡単に抽出できると便利です。ちょうどその処理を、/video/thumbs Robotが
thumbnailed のStepで行います ✨
いよいよ主役の /video/adaptive
Robotです。このAssemblyでは、処理を
hls-adaptive と dash-adaptive という別々の
Stepに分けています。このRobotに渡すパラメーターを見てみましょう。それぞれの処理は対応するエンコード済み動画を受け取り、.m3u8 と
.mpd のプレイリストを生成します。MPEG-DASH と HLS のプロトコルファイルは、プレイリスト(.m3u8 または .mpd)と、連続するセグメントで構成されます。プレイリストファイルは、動画のストリーミングに必要な対応セグメントを参照し、順番に再生します。
segment_duration を使うと、ストリーミング動画の各セグメントの最大再生時間を定義できます。ユーザーのデータ通信量やダウンロード能力を考慮するうえで、重要な設定です。また、これらのプロトコルでは、セグメントをプレイリストと常に同じディレクトリに置く必要があります。そうしないと、プレイリストからセグメントを見つけられません。幸い、全体の最後のStepで、/google/store Robotが
MPEG-DASH と HLS のファイルのパスを、stream-videos/dash-video/${file.name} のような指定のパスに設定します。これにより、すべてのファイルが適切にまとまるはずです。ただし、バケットには必ず storage.objects.create の権限を設定してください。サムネイルも同じRobotで保存します。
上記の最小構成の DASH 分岐では、映像のみをエンコードします。音声付きの DASH ストリームを作成するには、MPEG-DASH デモ (English)のように音声レンディションを追加し、映像とまとめます。
React による概念実証
Griffith は、手軽に使い始められる React 用の動画プレーヤーです。プレーヤーのプロパティを含む props と、動画の URL および形式で構成されるオブジェクト sources を受け取ります。
var sources = {
hd: {
bitrate: 905,
size: 10105235,
duration: 0,
width: 1280,
height: 720,
play_url: 'https://storage.googleapis.com/yourbucket/stream-videos/hls-video/my_playlist.m3u8',
},
}
この過去の概念実証では、次のコードでネイティブのメディア対応状況を確認しています。Media Source Extensions を通じて JavaScript ライブラリが提供する再生機能への対応は検出しません。そのようなライブラリを組み込む際は、プレーヤーの機能判定を使用してください。
function checkCompatibility() {
var compatibility = document.createElement('video')
if (compatibility.canPlayType('application/x-mpegURL')) {
return build_sources('m3u8', 'my_playlist')
}
if (compatibility.canPlayType('application/dash+xml')) {
return build_sources('mpd', 'my_playlist')
}
console.log('No native streaming support found')
}
私が作成した基本的な実装はこちらで確認できます。/video/adaptive Robotを使うと、ストリーミングメディアの生成を大幅に効率化できます。インターネットでの動画視聴が増えるなか、シンプルで洗練されたソリューションを求める方にとって、このRobotは便利なツールになり得ると確信しています。
さらに詳しく知りたい方には、デモのあらゆるデバイスに対応する動画の作成 (English)もおすすめです。再生デバイスの対応状況に応じて、今回の仕組みとほかの形式を組み合わせる方法を紹介しています。React を使わないプレーヤーである Plyr向けのサンプルコードも掲載しています。