$Id: 00README,v 1.2 2006/11/13 02:32:51 nishi Exp $

Galatea DM (Galatea Dialog Manager) 2003-08-22-Release

====================
Copyright / License
====================

Galatea Dialog Manager:
(c)2003 Takuya NISHIMOTO (nishi@hil.t.u-tokyo.ac.jp)
Based on "Phoenix" Task Manager
2001-2002 by Takuya NISHIMOTO and Mitsuhiro KIZU 
(Kyoto Institute of Technology)

本システムは Relaxer の生成物を含んでいます。
Relaxer の生成物は Apache ライセンスです。
Relaxer Version 1.0rc3b2 (20030812) by asami@relaxer.org
http://www.relaxer.org/
(phoenix/relaxer/{vxml20,pdoc}/*)

本システムは Mozilla Rhino の実行ファイル(無改変)を含んでいます。
本システムは NPL 1.1 における Larger Works に該当します。
Contains the Mozilla Rhino 1.5 R4.1 unaltered executable file.
The source code for the Rhino part is available under the 
NPL (Netscape Public License) 1.1 from mozilla.org.
http://www.mozilla.org/rhino/
(lib/js.jar)

===============
動作環境
===============

以下の構成で開発と動作確認をしています。

Hardware:

- CPU   : Pentium 4 2.8GHz
- RAM   : 1GB
- Video : NVIDIA GeForce4 Ti4200 128M-VRAM
- Sound : Creative SoundBlaster Live! PCI

Software:

- Redhat Linux 9.0 Publisher's Edition
- NVIDIA-Linux-x86-1.0-4496

性能不足の場合には音声と表示の同期がずれることがあります。
また、ノートPCなど音声入出力に ALSA が必要な場合があります。

=====
音量コントロール (Gnome Volume Control)
=====

 $ gnome-volume-control &

 vol   : 連動on, 消音off,          スライダー適度に上げる
 pcm   : 連動on, 消音off,          スライダー適度に上げる
 mic   :         消音on,  録音on
 igain : 連動on, 消音off, 録音off, スライダー適度に上げる

=====
各サブモジュールの動作確認
=====

各サブモジュールが正しくインストールされ，
設定されていることを確認してください．

** FSM

 $ cd FSM/bin
 $ ./fsm

 マウスオペレーション

 エージェントをマウスで操作することができます．
 左ボタンドラッグ - X、Y軸回転
 中ボタンドラッグ - X、T平行移動
 右ボタンドラッグ - スケール変換

 キーボードオペレーション

 "r"または"R"ボタン：マウスでの移動をリセット
 "f"または"F"ボタン：フルスクリーンモード
 （注）フルスクリーンにした場合元に戻すことはできません
 "Esc"ボタン：モジュールの終了

 $ cd ..

** SRM

 $ cd SRM
 $ perl ./SRM_Main.pl
 set Run = INIT
 set Run = START
 
 以下が表示されるのを待つ．
 tell <INPUT STATUS="LISTEN" TIME="xxxxx"/>
 
 「上着を白にしてください」と喋って動作確認
 
 set Grammar = GramXML/renraku/renraku.xml
 「嵯峨山先生の電話番号を教えて下さい」と喋って動作確認
 
 Control-C で終了
 $ cd ..

** SSM

 $ cd SSM
 $ perl RUN
 合成音声が出力されることを確認
 $ cd ..

** AM for DM

 GUI 版 Galatea Monitor を同梱しています。
 各ボタンを操作して動作を確認できます。

 $ cd ../AM
 $ ./AgentManager.pl -C ../DM/Modules/am4dm.conf

===============
対話の実行
===============

galatea コマンドを実行してから各エンジンを初期化して、
エージェントの顔が表示されるまでに約１５秒、
対話が始まるまでに約３０秒かかります。

$ pwd
/home/demo/galatea/DM

$ ./galatea tests/exit.vxml -> エージェントを表示するだけで何もしない
$ ./galatea tests/kani.vxml
$ ./galatea tests/drivenavi.vxml (周辺情報 -> レストランのみ動作)
$ ./galatea tests/ssmdemo.vxml
$ ./galatea tests/weather.vxml
$ ./galatea tests/menu.vxml
$ ./galatea http://server/path/to/program.cgi

なお、対話終了時にシステムは終了しません。

Dialog Manager Halted. Press Ctrl-C to quit.

と表示されたら Ctrl-C を押してください。

このとき、各サブプロセスが終了しないことがあります。
CPU 負荷メータを監視しながら実行し、
必要に応じて下記を使用してください。

$ ./fin

=====
ドキュメント解釈の実行
=====

-p オプション（引数なし）で，対話実行しないで中間形式を出力．

$ ./galatea -p tests/kani.vxml > _kani.pdoc

VoiceXML のかわりに pdoc を読み込んで対話を実行できます．

$ ./galatea _kani.pdoc

=====
Grammar Template
=====

XML Grammar は ./lib/grammar.xml を雛型として使用しています．
必要に応じて filler などを改変できます．
実行時に SRM/temp/mkdfa.log でエラーがないことを確認してください．

=====
Submodule Configuration
=====

起動時などにサブモジュールに送るコマンドは ./lib/galatea.xml に
記述されています。VoiceXML の書式にあわせていますが、
各 block の native 要素以外は無視されます。
initOutput および initRecog を順に実行しています。

=====
開発者向け情報
=====

Java source からのビルドと実行の手順は以下のとおりです．
コンパイルには Jakarta Ant が必要です。

Java/Ant の path が異なる場合は Makefile を参照

JAVA_HOME=/usr/java/j2sdk1.4.2
ANT_HOME=/usr/local/lib/jakarta-ant-1.5.1

$ cd phoenix

対話の実行

$ make arg1=../tests/xxx.vxml run
$ make arg1=../pdoc/xxx.pdoc run

ドキュメント解釈の実行

$ make arg1=../tests/xxx.vxml dump

[end of file]
