Red5でHello World(1) - サーバ編

※他のRed5関連のエントリはこちら

FlexアプリからRTMPでRed5側のメソッドを呼び出し、実行結果をFlexに返す、という超簡単なプログラムを作ってみよう。
まずはRed5（サーバ）側から。

とっかかり、何もわからんが、やるべきことは

1. "Hellow, World."という文字列を返すメソッドを含んだクラスを作る。
2. 作成したクラスをRed5へ配置し、動くようにする。

に違いない。ということでやってみる。


Eclipseでのプロジェクトの作成、Red5サーバーの設定
せっかくEclipseのRed5Pluginをインストールしているので、これを使って参考サイトを見ながらプロジェクト作成からやってみよう。

• Eclipseのメニューから、「ファイル」→「新規」→「動的Webプロジェクト(Dynamic Web Project)」で新規プロジェクトを作成。プロジェクト名は適当でＯＫ。
• 一番最初にプロジェクトを作成するときは、ターゲット・ラインタイムが<None>になっているはずなので、「新規ランタイム」ボタンをポチる。
• 新規サーバ・ランタイム環境の画面が表示されるので、フィルターに"Red5"と入力してみる。 Red5Plugin がちゃんとインストされていれば"Red5 Server Runtime"が選択できるはず。
• JREに1.6 、Runtime Directoryにred5.jarが格納されているフォルダ（Red5にインストールフォルダ）を指定して、"完了"ボタンをポチる。
• あとは適当に完了ボタン押下。

これでプロジェクトができた。
あと、「サーバ」タブでサーバ定義しておこう。

• 右クリック→「新規」→「サーバー」
• サーバータイプに"Red5 Server Runtime"を選択。「サーバーのホスト名」はlocalhostかIPアドレスかな。サーバ名は適当。たぶん自動で作成されるのでそのまま使った。サーバー・ランタイム環境も "Red5 Server Runtime"。これで「次へ」
• （ここ重要）"Auto Deploy Directory"にRed5インストールフォルダ配下の"webapps"を指定。"Start Script"と"Stop Script"は、これまたインストールフォルダにある"red5-debug.bat"、"red5-shutdown.bat"を指定。サーバ・ポート、デバッグ・ポートはデフォルトの5080、87787のまま（ちなみにこの２つのバッチファイルはそのままだとうまく動かなかったので書き換えてしまった）。これで「次へ」。
• 追加および除去の画面が表示される。さっき作ったプロジェクトが使用可能欄に表示されているはずなので、これを選択して「追加」ボタンをポチる。これで「完了」

これで、Eclipse上からRed5の開始、停止、作成アプリのデプロイまでできるようになるようだ。Tomcatプラグインと同じような感じ。

[参考サイト]
Creating Red5 Projects with Red5 Plugin


Applicationクラスとメソッドの作成
ネットでいろいろ調べてみると、どうやら
org.red5.server.adapter.ApplicationAdapter
を継承したクラスを作成して、そこに適当にメソッドを実装すればいいらしいことが判明。
さっき作ったプロジェクトの"Java Resources"→"src"に適当にパッケージ作って、そこにJavaクラスを作成する。
クラス、メソッドは下記参考サイトのものをそのまんま書きました。
作成したクラス名は"Application"としたけど、もしかしたらなんでもＯＫかな。

[参考サイト]
[Red5入門コース第3回]サンプルアプリケーションの作成



作成したアプリケーションのRed5へのデプロイ
Red5ってなんかTomcatっぽいし（2012/2/26追記　Jettyがベースのようですね）、インストールフォルダに"webapps"ってフォルダあるから、たぶんこのこの中に自作アプリ用のフォルダ、WEB-INFとかフォルダ作って、WEB-INFの中にディプロイメントディスクリプタ（構成情報ファイル）とか書いとけば動くんじゃない？と、なんとなく思うわけだ。
またまた得意のネットで調べてみると、どうやら次の３つのファイルが必要になるみたい。

• red5-web.properties
• red5-web.xml
• web.xml

web.xmlはまあ普通として、他の２つはRed5独自っぽいよね。
0から手書きは面倒なので、下記参考サイトをガン見して３つのファイルを作る。

1. Red5にインストールしたデモSOSapmleのフォルダ（webapps/SOSample/WEB-INF）にあるred5-web.properties、red5-web.xmlの２つのファイルをコピって、Eclipseのプロジェクトの"WebContent"→"WEB-INF"にペーストして元を作る。 web.xmlはもともとプロジェクト作成時に自動生成されているものを利用する。
2. 各３つのファイルをEclipse上で開いて自分のアプリ用に修正、追記する。
    red5-web.properties・・・コンテキスト・パスを修正（必要があればバーチャルホストも）
    red5-web.xml・・・beanタグのid="web.handler"のclassを、自作のApplicationクラスのフルパスに修正
    web.xml・・・context-paramタグ、webAppRootKeyを追記

ここまでやってやっとデプロイできそう。

デプロイはRed5Pluginを使って実施。
さっき作った"サーバー"を上を、　右クリック→「公開」
これで、webappsフォルダに自分のアプリケーション用のフォルダが作成され、必要なファイルが適切なフォルダに配置されるのだ。

ここで、Red5を起動させて変なエラーがでないか確認してみよう。
"サーバー"を上を右クリック→「開始」とするとコンソールタブに切り替わり、Red5の起動ログが出力されていく。この中に、
[INFO] [Launcher:/(自作アプリの名前)]・・・
みたいなログが表示されていれば無事にデプロイされている、はず。
ちなみに、停止するには、"サーバー"を上を右クリック→「停止」。

[参考サイト]
red5を使ってライブストリーミングアプリケーションをつくる


Red5サーバ側はここまで。
次回はFlex側じゃー！