翻訳：株式会社サムライズ
ADOBE® MEDIA SERVER 5.0.3
デベロッパーズガイド
|
|
翻訳：株式会社サムライズ |
|---|
注意
Adobe Media Server® バージョン 5についての本ドキュメントは第三者によって翻訳されたものであり、Adobe Systems Incorporated（アドビ システムズ社）は本翻訳物の正確性や完全性を査閲していません。
オンデマンドメディアのストリーミング（RTMP）
チュートリアル：オンデマンドメディアのストリーミング（RTMP）
前提条件
このチュートリアルを実行するには、次のソフトウェアをインストールしてください。
オンデマンドメディアのストリーミングは、無償のデベロッパー版を含め Adobe Media Serverのどのエディションでも実行できます。サーバーのインストールの詳細については、「サーバーのインストール」を参照してください。
このチュートリアルでは、Flash Player 10 が必要なビデオ Player を使用します。ブラウザーにインストールされている Flash Player のバージョンを確認するには、
http://www.adobe.com/jp/software/flash/about/ を参照してください。
Adobe Media Server へのオンデマンドファイルのコピー
Adobe Media Server で VOD（ビデオオンデマンド）サービスを使用して記録済みメディアをクライアントにストリーミングします。記録済みメディアファイルをサーバーにコピーするだけで、クライアントでストリーミングすることができます。
VOD サービスは、次の 2 つのフォルダーから Media Player へファイルをストリーミングします。
rootinstall/applications/vod/media
rootinstall/webroot/vod
これらのフォルダーのサブフォルダーを作成して、メディファイルを保存することもできます。このチュートリアルでは、サブフォルダーを作成し、ストリーミングするファイルをそのサブフォルダーにコピーします。
1 次のフォルダーを参照します。
rootinstall/applications/vod/media
注意：rootinstall を Adobe Media Server インストールフォルダーに置き換えます。例えば、Windows のデフォルトのインストールフォルダーは C:\Program Files\Adobe\Adobe Media Server 5 です。
2 次のように、「media」フォルダー内に「tests」フォルダーを作成します。
rootinstall/applications/vod/media/tests
3 F4V/MP4 または FLV ファイルを /tests フォルダーにコピーします。
このチュートリアルでは、次のファイルを使用します。
rootinstall/applications/vod/media/tests/polymorphics.f4v
ビデオファイルがない場合は、www.archive.org/details/movies にある「Moving Images Archive」からダウンロードできます。サーバーに含まれているサンプルファイルを使用することもできます。学習目的で、サンプルファイルを rootinstall/applications/vod/media から rootinstall/applications/vod/media/tests にコピーします。
サポートされているファイル形式とコーデックの詳細については、「サポートされているファイル形式」を参照してください。
Adobe Media Server サンプル Player を使用したオンデマンドファイルの再生
1 サンプルビデオ Player をブラウザーで開くには、rootinstall/samples/videoPlayer/videoplayer.html ファイルをダブルクリックします。
2 ビデオのアドレスを「STREAM URL」テキストボックスに入力し、「VOD」をチェックして、「PLAY STREAM」をクリックします。このチュートリアルでは、次のファイルを再生します。
rtmp://localhost/vod/mp4:tests/polymorphics.f4v
Adobe Media Server ホスティングプロバイダーを使用している場合は、localhost を指定されたドメイン名または IP アドレスに置き換えます。
重要：メディアファイルを vod/media フォルダーにコピーしている場合でも、ファイルを再生するときにパスで/media を指定する必要はありません。サーバーはデフォルトで vod/media フォルダー内のメディアファイルを探すように設定されています。パスで /media を指定すると、サーバーは /vod/media/media フォルダー内を探します。
F4V/MP4 ファイルへのパスは接頭辞 mp4: で始めます。F4V、MP4、MOV などのファイルでも、そのファイルのファイル名拡張子を使用します。
Flash Media Playback を使用したオンデマンドストリームの再生
1 Web ブラウザーで Flash Media Playback Setup ページ（www.osmf.org/configurator/fmp/）をロードします。
2 「Video Source」に次のように入力します。
rtmp://localhost/vod/mp4:tests/polymorphics.f4v
localhost は、サーバーのドメイン名または IP アドレスに置き換えることができます。
3 埋め込みコードを更新するには、「Preview」をクリックします。
4 「Play」ボタンをクリックし、コードをテストします。
5 ユーザー自身の HTML ページで Player を使用するには、埋め込みコードをコピーし、ページの本文に貼り付けます。Flash Media Playback は、アドビ システムズ社でホストされるコンパイルされた SWF ファイルです。詳細については、 「Flash Media Playback でのメディアの再生」を参照してください。
関連項目
RTMP経由でオンデマンドメディアファイルを再生するための URL
チュートリアルを一度完了したら、サーバーからファイルを要求する URL の作成方法についてさらに詳しく学習します。様々なファイルとパスを使用して、チュートリアルをもう一度実行します。
Adobe Media Server からファイルを要求するシンタックスは次のとおりです。
protocol://server-domain-or-IP/ams-app-name/[ams-app-instance-name/][codec-prefix:]file-path[filename- extension]
|
エレメント |
必須 |
説明 |
|
protocol |
あり |
メディア配信のプロトコル。Adobe Media Server でサポートするプロトコルの詳細については、技術概要にある RTMP、RTMFP およびHTTP を参照してください。 |
|
server-domain-or-IP |
あり |
Adobe Media Server をホストしているコンピューターのドメイン名または IP アドレス。クライアントが Adobe Media Server と同じコンピューター上にある場合は、テスト目的で localhost を使用できます。 |
|
ams-app-name |
あり |
クライアントが接続する Adobe Media Server アプリケーション。 Adobe Media Server アプリケーションが保存されるデフォルトのフォルダーは、rootinstall/applications です。このチュートリアルでは、アプリケーション rootinstall/applications/vod を使用します。 |
|
ams-app-instance- name |
なし |
アプリケーションでは、インスタンスの数に制限はありません。例えば、クライアントを rtmp://localhost/vod/instance1、rtmp://localhost/vod/instance2 などに接続できます。 |
|
codec-prefix |
F4V/MP4 ファイルおよび MP3ファイルでは必須です。 |
F4V/MP4 および MP3 ファイル形式では、要求 URL でコーデックの接頭辞が必要です。F4V/MP4 ファイルの場合は、接頭辞 mp4: を使用します。MP3 ファイルの場合は、接頭辞 mp3: を使用します。FLVファイルには、コーデックの接頭辞は必要ありません。 |
|
file-path |
あり |
メディアファイルの保存先として設定されたフォルダーからメディアファイルへのパス。VOD アプリケーションの場合は、次のフォルダーにメディアファイルが保存されるように設定されています。 rootinstall/applications/vod/media rootinstall/webroot/vod このチュートリアルでは、要求 URL はrtmp://localhost/vod/mp4:tests/polymorphics.f4v です。file-path は、tests/polymorphics です。 ファイル polymorphics.f4v が、/vod/media/tests フォルダーではなく /vod/media フォルダーにある場合、完全な要求 URL は rtmp://localhost/vod/mp4:polymorphics.f4v になります。file-path は polymorphics です。 メディアファイルを rootinstall/conf/ams.ini ファイルに保存するようにフォルダーを設定します。 |
|
filename-extension |
F4V/MP4 ファイルおよび MP3ファイルでは必須です。 |
再生するファイルのファイルのファイル名拡張子を使用します。例えば、ファイルが F4V ファイルの場合は、.f4v を使用します。ファイルが MOV ファイルの場合は、.mov を使用します。 |
RTMP経由でのオンデマンドメディアファイルのストリーミングには、次のアドレスを使用します。
|
ファイル形式 |
アドレス |
|
F4V |
rtmp://server-domain-or-IP/vod/mp4:filename rtmp://server-domain-or-IP/vod/mp4:filename.f4v rtmp://server-domain-or-IP/vod/mp4:subfolder/fileName.f4v |
|
FLV |
rtmp://server-domain-or-IP/vod/filename rtmp://server-domain-or-IP/vod/filename.flv |
Adobe Media Server と共にインストールされた Apache Web サーバーから HTTP 経由でファイルをプログレッシブダウンロードするには、標準の HTTP アドレスを使用します。次のファイルは rootinstall/webroot/vod フォルダーにあります。
http://server-domain-or-IP/vod/filename.xxx
注意：ローカルホストをHTTP 経由で使用するには、ポート番号 8134 を追加します。例えば、http://localhost:8134/vod/video.f4v となります。サーバーは、ポート 8134 を HTTP に内部で使用します。
rootinstall/conf/ams.ini ファイル内の 2 つのパラメーターによって、VOD アプリケーションがメディアファイルを探すフォルダーの場所を識別します。
VOD_COMMON_DIR = C:\Program Files\Adobe\Adobe Media Server 5\webroot\vod
VOD_DIR = C:\Program Files\Adobe\Adobe Media Server 5\applications\vod\media
クライアントが VODアプリケーションに接続してファイルを再生すると、サーバーはこれらの 2つのフォルダーでファイルを探します。
VOD_DIRパラメーターで指定されたフォルダー内のファイルは、RTMP経由でのみストリーミングできます。
VOD_COMMON_DIRパラメーターで指定されたフォルダー内のファイルは、RTMP経由でストリーミングし、HTTP経由でプログレッシブダウンロードできます。RTMP経由でのサーバーへの NetConnectionが成功しているかどうかを確認するコードをクライアントで記述します。クライアントが正常に接続していない場合は、HTTP経由でファイルを要求するコードを記述します。サーバーは HTTPに自動的にフォールバックしません。
重要：メディアを vod/media フォルダーにコピーしている場合でも、ファイルを再生するときにパスで /media を指定しないでください。サーバーはデフォルトで vod/media フォルダー内のメディアを探すように設定されています。パスで /media を指定すると、サーバーは /vod/media/media フォルダー内を探します。
メディアファイルの保存場所の変更
1 rootInstall/conf/ams.ini ファイルをテキストエディターで開きます。
2 VOD_DIRパラメーターと VOD_COMMON_DIRパラメーターを編集します。
3 Adobe Media Server を再起動します。
新しいメディアの保存場所の追加
1 rootInstall/conf/ams.ini ファイルをテキストエディターで開きます。
2 新しいパラメーターを追加し、目的の場所に指定します。例えば、次のようにします。
VOD_DIR_2 = C:\hrvideos
3 rootinstall/applications/vod/Application.xml ファイルをテキストエディターで開きます。
ams.ini ファイルのパラメーターは、Application.xml 設定ファイルで使用されます。
<Application>
<StreamManager>
<VirtualDirectory>
<Streams>/;${VOD_COMMON_DIR}</Streams>
<Streams>/;${VOD_DIR}</Streams>
</VirtualDirectory>
</StreamManager>
4 <Streams> タグを新しいパラメーターと共に追加します。例えば、次のようにします。
<Streams>/hr;${VOD_DIR_2}</Streams>
このフォルダーに保存されたストリームを再生するには、次のアドレスを使用します。
rtmp://localhost/vod/hr/mp4:somefilename.f4v
<Streams>タグは、メディアパスが /hrで始まる場合に VOD_DIR_2パラメーターで指定された場所でメディアを探すようにサーバーに伝えます。
5 Adobe Media Server を再起動します。
サーバーは VODサービスのインスタンスを無制限の数サポートしています。
1 rootinstall/applications/vod フォルダーをアプリケーションフォルダー内で複製し、vod2 などの新しい名前を付けます。この場合、新しい VOD サービスは rootinstall/applications/vod2 に格納されます。
VODサービスのインスタンスの数は、必要に応じていくつでも作成することができます。
2 これでクライアントは、rtmp://adobemediaserver/vod2 の URL から、VOD サービスに接続できるようになります。
3 （rootinstall/conf に格納されている）ams.ini ファイルを開き、次の操作を行います。
• パラメーターを追加し、新しいサービスのコンテンツパスを設定します。例えば、VOD2_DIR = C:\Program Files\Adobe\Adobe Media Server 5\applications\vod2\media のようにします。
• Apache をインストールしていて、HTTP 経由でメディアファイルを利用したい場合は、新しい VOD2_COMMON_DIR パラメーター VOD2_COMMON_DIR = C:\Program Files\Adobe\Adobe Media Server 5\webroot\vod2 を追加します。
4 rootinstall/applications/vod2 フォルダーの Application.xml ファイルを開き、次の操作を行います。
• 仮想ディレクトリを次のように編集します。<Streams>/;${VOD2_DIR}</Streams>
• 仮想ディレクトリを次のように編集します。<Streams>/;${VOD2_COMMON_DIR}</Streams>
5 記録済みメディアファイルを次の場所に置きます。
• RTMP 経由でのみストリーミングされるファイルを C:\Program Files\Adobe\Adobe Media Server 5\applications\vod\media フォルダーに置きます。
• RTMP または HTTP 経由でストリーミングされるファイルを C:\Program Files\Adobe\Adobe Media Server 5\webroot\vod2 に置きます。
注意：URL には、media フォルダーを指定する必要はありません。media フォルダーは、ams.ini ファイル内に設定したパスに指定されています。
注意：Adobe Media Server Standard ではライブサービスのサーバーサイドコードを変更することはできません。
❖ rootinstall/applications/vod/main.far ファイルを削除し、rootinstall/samples/applications/vod/main.asc ファイルに置き換えます。
❖ VOD サービスフォルダーをrootinstall/applications フォルダーから移動します。
最終更新日 2013/9/30