ADOBE®   MEDIA SERVER 5.0.3

デベロッパーズガイド

	翻訳：株式会社サムライズ

注意

Adobe Media Server® バージョン 5についての本ドキュメントは第三者によって翻訳されたものであり、Adobe Systems Incorporated（アドビ システムズ社）は本翻訳物の正確性や完全性を査閲していません。

オフラインでのパッケージ化

HDSのオフラインでのパッケージ化

ファイルパッケージャーは、オンデマンドメディアファイルをHTTPでストリーミングできる形式へとパッケージ化するコマンドラインツールです。ファイルパッケージャーはAdobeAccessで保護するためのファイル暗号化を行うこともできます。

注：オンデマンドコンテンツを、クライアントが要求してきた時にHTTPでのストリーミング向けにリアルタイムでパッケージ化するには、Adobe Media Serverデベロッパーズガイドの「オンデマンドメディアのストリーミング（HTTP）」を参照してください。

オンデマンドメディアのパッケージ化

ファイルパッケージャーの場所

ファイルパッケージャーは以下の場所にあります：

•        rootinstall/tools/f4fpackagerフォルダ

ファイルパッケージャーは実行にいくつかのライブラリが必要です。これらのライブラリはf4fpackagerフォルダにあります。ファイルパッケージャーを移動させるには、f4fpackagerフォルダとその中身を全て移動させてください。

入力ファイル形式と出力ファイル形式

HTTPでオンデマンドメディアをストリーミングするには、そのファイルをファイルパッケージャーで処理します。ファイルパッケージャーは内容をパースし、それをセグメントとフラグメントに変換し、セグメントとフラグメントをF4F形式へと書き込みます。ファイルパッケージャーにAdobeAccessで保護するための暗号化を行わせることもできます。

ファイルパッケージャーは以下のファイル形式に対応しています：

•        F4V/MP4互換のファイル

•        FLV

重要：このファイル形式は、Speexオーディオを除き、その形式がサポートするあらゆるコーデックを格納することができます。Speexオーディオはパッケージ化することは可能で、ファイルパッケージャーはエラーも出しませんが、オーディオは再生できません。ファイルパッケージャーはビデオのみや音声のみのストリームをパッケージ化することもできます。

ファイルパッケージャーは以下のファイル群を出力します：

セグメントとフラグメント

1つのF4Fファイルにはメディアファイルのセグメントが1つ入っています。各セグメントには複数のフラグメントが入ることができます。各セグメントと各フラグメントの継続時間を設定するには、--segment-duration と --fragment-durationのオプションを使ってください。設定は秒を単位として行います。0より大きいセグメントの継続時間を指定すると、複数のファイルが作成されます。ちょうどいいサイズのフラグメントとは、インターネットで送信するために十分なほど小さく、Apache HTTPサーバーを複数回呼びださなくてもいいほど長いものです。

ファイルパッケージャーを実行する

ファイルをパッケージ化するには、ファイルパッケージャーに入力ファイルの名前を渡します。

名前を指定するには2つの方法があります：

•        コマンドラインで--input-fileオプションを入力する。

•        入力ファイルを指定する設定ファイルを作成し、コマンドラインで--conf-fileオプションを入力する。

コンテンツをWindows上でパッケージ化する

1       コマンドプロンプトを開きます。

2       ディレクトリをf4fpackager.exeがあるディレクトリに変更します。

3       ツールの名前とオプションを入力します：

f4fpackager --input-file=sample.f4v --output-path=c:\sampleoutput

以下のファイルが出力されます：sampleSeg1.f4f、sample.f4x、及びsample.f4m。

コンテンツをLinux上でパッケージ化する

1       ターミナルウィンドウを開きます。

2       クリーンインストールされたLinux上では、変数LD_LIBRARY_PATHをファイルパッケージャーのライブラリが入っているディレクトリにセットします。

3       シェルプロンプトで、ツールの名前とオプションを入力します：

f4fpackager --input-file=sample.f4v --output-path=/sampleoutput

以下のファイルが出力されます：sampleSeg1.f4f、sample.f4x、及びsample.f4m。

マルチビットレートのコンテンツをパッケージ化する

マルチビットレートのコンテンツをストリーミングするには、1つのメディアを複数のビットレートでエンコードして、複数のメディアファイルを作成します。そしてファイルパッケージャーを使って各メディアファイルを一つ一つ処理します。これらのメディアファイルは、各ファイルの情報を記載した1つのマニフェストファイルを共有します。OSMFプレイヤーはこの情報を使って再生を行います。

マルチビットレートファイルのパッケージ化について

ファイルパッケージャーを実行する度に、ファイルパッケージャーは入力ファイルのファイル名が記載されたマニフェストファイルを作成します。--manifest-fileオプションを渡すと、その情報をファイルパッケージャーは作成するマニフェストファイルに追加します。例えば、以下のオプションで実行したとします：

--input-file=sample1.f4v

ツールは以下のファイルを作成します：sample1Seg1.f4f、sample1.f4x、及びsample1.f4m。

そして以下のコマンドを実行するとします：

--input-file=sample2.f4v --manifest-file=sample1.f4m

ツールはsample2Seg1.f4f、sample2.f4x、sample2.f4mというファイルを作成します。マニフェストファイルsample2.f4mにはsample2.f4vとsample1.f4vについての情報が含まれています。

マルチビットレートのコンテンツのマニフェストファイルを作成するには、--manifest-fileオプションを渡して、前に処理されたファイルのマニフェストファイルを指定します。最初のファイルを処理する際には--manifest-fileオプションを渡してはいけません。

マルチビットレートのファイルをパッケージ化する

注：この例ではWindowsを使用しています。Linuxのコマンドは、「コンテンツをLinux上でパッケージ化する」を参照してください。

1   いくつかのビットレートでメディアファイルをエンコードします。例えば150 kbps、700 kbps、1500 kbpsです。
この例ではsample1_150kbps.f4v、sample1_700kbps.f4v、sample1_1500kbps.f4vの 3つのファイルを使います。Adobe Media Serverにはこれらのファイルがrootinstall\applications\vod\mediaにインストールされています。

2   ファイルをファイルパッケージャーと同じフォルダにコピーします。
Adobe Media Serverでは、ファイルパッケージャーはrootinstall\tools\f4fpackagerフォルダにあります。

3   コマンドプロンプトを開きます。

4   ディレクトリをf4fpackager.exeがあるディレクトリに変更します。

5   以下のコマンドを入力します：
f4fpackager --input-file=sample1_150kbps.f4v --bitrate=150
以下のファイルが出力されます：sample1_150kbpsSeg1.f4f、sample1_150kbps.f4x、及びsample1_150kbps.f4m。

6   以下のコマンドを入力して2番目のファイルを処理します：

f4fpackager --input-file=sample1_700kbps.f4v --manifest-file=sample1_150kbps.f4m --bitrate=700

以下のファイルが出力されます：sample1_700kbpsSeg1.f4f、sample1_700kbps.f4x、及びsample1_700kbps.f4m。

マニフェストファイルsample1_700kbps.f4mには、今回の入力ファイルからの情報とマニフェストファイルsample1_150kbps.f4mからの情報が入っています。

7   以下のコマンドを入力して3番目のファイルを処理します：

f4fpackager --input-file=sample1_1500kbps.f4v --manifest-file=sample1_700kbps.f4m --bitrate=1500

以下のファイルが出力されます：sample1_1500kbpsSeg1.f4f、sample1_1500kbps.f4x、sample1_1500kbps.f4m。

マニフェストファイルsample1_1500kbps.f4mには、今回の入力ファイルからの情報とマニフェストファイルsample1_700kbps.f4mからの情報が入っています。sample1_700kbps.f4mファイルには、sample1_150kbps.f4vファイルとsample1_700kbps.f4vファイルについての情報が入っています。

8   ファイルを再生するには、sample1_1500kbps.f4mファイルのURLをOSMFプレイヤーに渡します。このマニフェストファイルは最後に作成されたものなので、3つのファイル全てについての情報が入っています。

コンテンツをパッケージ化・暗号化する

パッケージ化とAdobe Accessで保護するための暗号化の両方を行うには、ファイルパッケージャーを使用します。

Adobe Accessには、Adobe® Access™ Server for Protected Streamingと呼ばれるAdobe Access SDKに基くライセンスサーバーの実装が入っています。Adobe Access Server for Protected StreamingはHTTP Dynamic Streamingで使うために設計されています。Adobe Accessについての更なる情報は、Adobe Accessのドキュメントを参照してください。

共通キーを作成する

ファイルパッケージャーでコンテンツを暗号化するには共通キーファイルを作成する必要があります。共通キーファイルの中身は128バイトのランダムに生成されたデータです。ファイルパッケージャーはコンテンツIDと共にこのキーを使って、コンテンツ暗号化キーを作成します。

注：この基本キーは128バイトですが、最初の128ビット（16バイト）のみがキーの作成に使われます。

オープンソースツールであるOpenSSLやAdobeのスクランブルユーティリティを使って、ランダムデータを作成して共通キーファイルを出力することができます。OpenSSLはwww.openssl.orgからダウンロードしてください。

ランダムデータを作成し共通キーファイルを出力：

openssl rand -out commonKey.bin 128

--common-keyコマンドラインオプションとして、または設定ファイルの<common-key>要素に記述して、commonKey.binを渡します。

設定ファイルを使ってコンテンツをパッケージ化・暗号化する

ファイルの暗号化には多数のコマンドラインオプションが必要です。オプションをコマンドラインで設定するより、設定ファイルを使った方が簡単です。

1       テキストエディタでf4fpackager_config.xmlを開きます。

デフォルトでは、このツールはファイルパッケージャーと同じディレクトリでf4fpackager_config.xmlを探します。しかし、どこに移動させてもどんな名前を付けても構いません。

2       以下の必須オプションの値を入力します（ここにはサンプルの値も入っています）：

<offline>

<input-file>someFile.f4v</input-file>

<content-id>contentId</content-id>

<common-key>commonKey.bin</common-key>

<license-server-url>http://server1.com:9999</license-server-url>

<license-server-cert>licenseServer.der</license-server-cert>

<transport-cert>transportCert.der</transport-cert>

<packager-credential>packagerCredential.pfx</packager-credential>

<credential-pwd>mYpwd</credential-pwd>

<policy-file>policyFile.pol</policy-file>

</offline>

さらに要素を追加してデフォルト値を変更することもできます。

3       設定ファイルを保存します。

4       コマンドプロンプトを開きます。

5       f4fpackager.exeがあるディレクトリに変更します。

6       以下のコマンドを入力します：

f4fpackager --conf-file=f4fpackager_config.xml

コマンドラインを使ってコンテンツをパッケージ化・暗号化する

1       コマンドプロンプトを開きます

2       ファイルパッケージャーがあるディレクトリに変更します。

3       以下のコマンドを入力します：

f4fpackager --input-file=someFile.f4v --license-server-url=http://server1.com:9999 --transport-cert=transportCert.der --license-server-cert=licenseServer.der --packager-credential=packagerCredential.pfx --credential-pwd=mYpwd --policy-file=policyFile.pol --common-key=commonKey.bin --content-id=contentId

ファイルパッケージャーのリファレンス

ファイルをフラグメント化するためのコマンドラインオプション

ファイルパッケージャーの全てのオプションはコマンドラインで設定することができます。コマンドラインで設定されたオプションは、設定ファイルのどのオプションもオーバーライドします。唯一の必須オプションは--input-fileです。

フラグメントの継続時間をフレーム数や時間で設定する

ファイルパッケージャーにはフラグメントのサイズを決めるオプションがあります。フレームベースのオプションである--keyframe-interval-per-fragmentと、時間ベースのオプションである--fragment-durationがあります。各オプションにはフラグメント作成の方法を改善する追加オプションがあります。

ソースメディアのビデオが固定フレームレートでエンコードされている場合はフレームベースのオプションを使用します。フレームベースのオプションではフラグメントのサイズをビデオのキーフレームの間隔にきっちり一致させることができます。オーディオやビデオ以外のデータが入ったメディアには、時間ベースのオプションを使用します。

フレームベースのオプション：--keyframe-interval-per-fragment、--frames-per-keyframe-interval、 --frame-rate、--frame-precision。時間ベースのオプション：--fragment-duration、--duration-precision。フレームベースのオプションは時間ベースのオプションをオーバーライドします。--keyframe-interval-per-fragmentオプションを使用しなかった場合は、ファイルパッケージャーは--fragment-durationオプションを使用します。--keyframe-interval-per-fragmentや--fragment-durationに値を指定しなかった場合、ファイルパッケージャーはデフォルトのフラグメント継続時間を使用します。それは4秒です。

ファイル暗号化のコマンドラインオプション

Adobe Accessと併用するためにファイルを暗号化するには、ファイルパッケージャーを使用します。以下のオプションの中にはデジタル証明書が必要なものもあります。デジタル証明書を取得するには、Adobe Access Certificate Enrollment Siteを参照してください。

ファイルパッケージャーの設定ファイル

ファイルパッケージャーはXML設定ファイルを使ってコマンドラインオプションの値を読み込みます。デフォルトの設定ファイルf4fpackager_config.xmlは、ファイルパッケージャーと同じディレクトリにあります。大抵、コマンドラインでオプションを入力するよりも、再利用可能なテキストファイルでオプションを指定する方が簡単です。

コマンドラインでオプションを指定すると、設定ファイルで指定されたオプションがオーバーライドされます。この機能により、コンテンツのセットに使う設定ファイルを作成しながらも、ファイルごとに設定を少し変更するということが可能です。

注：このツールを実行するのに、設定ファイルは使わなくても構いません。

設定ファイルの名前と場所を渡すには、コマンドラインで--conf-fileオプションを入力します。--conf-fileオプションを入力しなければ、ツールと同じフォルダにf4fpackager_config.xmlというファイルがあるかどうかチェックします。

設定ファイルには、入力ファイルを含めパッケージ化と暗号化の全てのオプションを入力できます。以下に設定ファイルのフォーマットを示します：

<offline>

<input-file>/media/input-file.f4v</input-file>

<output-path>/media/http</output-path>

<fragment-duration></fragment-duration>

... You can set as many options as you want ...

</offline>

パスを入力するオプションでは、絶対パスか、ツールがあるディレクトリに対する相対パスを指定できます。

エラー

ファイルパッケージャーは以下のエラーを出力します：

HLSのオフラインでのパッケージ化

Adobe Media Serverのインストールには、オンデマンドのメディアを、HTTPでストリーミング可能なフラグメント化されたビデオコンテンツにパッケージ化するためのコマンドラインツールが入っています。このオフラインパッケージャーはAdobe Accessで保護するための暗号化を行うこともできます。

hlspackagerは、F4Vソースを読み込み、フラグメント化されたHLS VODコンテンツを作成するコマンドラインツールです。コマンドラインか設定ファイルでパッケージャーに様々なオプションを渡すことができます。しかし、コマンドラインでオプションが渡されると、設定ファイルで指定されたそのオプションをオーバーライドします。

注：パッケージャーはF4Vと MP4 ファイルのみを認識できます。.

パッケージャーツールは、パッケージ化の処理中に何種類かの出力ファイルを作成します：

•        m3u8ファイル（シングルストリーム再生リスト）

•        m3u8に記載されているTSセグメント

hlspackagerのシンタックスを以下のコマンドに示します：

hlspackager --input-file=<input> --output-path=<output> --base-url=<baseurl> --audio-only=<bool> --config-dump --help --media-target-duration=<fragmentLength> --conf-file=<confFile>

注：HLSオフラインパッケージャーは、ストリームやファイルによって生成されるコンテンツの名前にプレフィックスを付加しません。よって、作成されるコンテンツと同じ名前のファイルが出力ディレクトリにあれば、全て上書きしてしまいます。マルチビットレートでバッチジョブを使う場合は、output-pathオプションを使用して作成されるコンテンツのために違うディレクトリのパスを指定する必要があります。

サポートされている様々なオプションを以下の表で説明します：

コマンドでオプションを渡す代わりに、オプションが記述された設定ファイルをパッケージャーに渡すこともできます。設定ファイルとは、パッケージ化処理の設定を指定するために使用することができるXMLファイルです。

パッケージャーは、設定ファイルがユーザーから渡されたかどうかをチェックします。渡されていなければ、パッケージャーと同じディレクトリにhlspackager_config.xmlがないかチェックします。設定ファイルは必須というわけではありません。設定ファイルのフォーマットは以下の通りです：

<offline>

<input-file>/media/input-file.f4v</input-file>

<output-path>/media/http</output-path>

 <media-target-duration></media-target-duration>

... other options...

</offline>

ホスティングとキー作成

フラグメント化されたコンテンツは、サーバーのwebrootディレクトリに直接ホストすることができます。例えば、フラグメント化されたコンテンツをwebroot/myOfflineContent/ディレクトリ内に置いている場合、次のURLでそのコンテンツを再生することができます。

- http://server-name/myOfflineContent/prog_index.m3u8.

Vanillaコンテンツ向けのキー作成

Vanilla方式でコンテンツを暗号化する場合は、base-64形式のキーを入力ファイルとして使用します。base-64形式のキーを作成するには、以下に示すOpenSSLコマンドを実行します：

openssl rand -out keyfile.bin -base64 16

作成されたkeyfile.binファイルはbase-64のキーが入っており、コンテンツのフラグメント化に使用することができます。ホスティングするキーを作成するには、以下のコマンドを実行します：

openssl base64 -d -in keyfile.bin -out plain-keyfile.bin

plain-keyfile.binファイルはホスティングして鍵配送に使用することができます。

Adobe Accessコンテンツ向けのキー作成

base-64形式のキーを作成するには、以下に示すOpenSSLコマンドを実行します：

openssl rand -out keyfile.bin -base64 16

エラーコード

以下の表でパッケージャーが出すエラーコードを説明します：

ライセンス発行の設定と制限（HDSとHLS）

license-path要素を追加することで、ライセンスパスを追加できます。この要素にはAdobe Media Serverのライセンスディレクトリのパスを指定する必要があります。この値が明確に指定されていない場合、HDSもHLSもオフラインパッケージャーはtoolsディレクトリにあるということを考慮して、'../../'がライセンスパスとして仮定されます。設定ファイルのlicense-path要素で指定するパスは、絶対パスかオフラインパッケージャーのあるディレクトリに対する相対パスが指定できます。例えば：

<license-path>C:\Program Files\Adobe\Adobe Media Server 5\</license-path>

注：このライセンスの設定と制限は、f4fpackagerとhlspackagerの両方に適用されます。

最終更新日 2013/9/30