JCONTROL(1)

NAME
jcontrol - simple program to control Julius module via API

SYNOPSIS
jcontrol hostname [portnum]

DESCRIPTION
jcontrol は，他のホストで動作中の julius を，APIを介してコントロールする簡単なコンソールプログラムです． Julius へのコマンド送信，およびJuliusからのメッセージ受信を行うことが できます．

起動後，jcontrol は，指定ホスト上において「モジュールモード」で動作中の Julius に対し，接続を試みます．接続確立後，jcontrol はユー ザーからのコマンド入力待ち状態となります．

jcontrol はユーザーが入力したコマンドを解釈し，対応するAPIコマンドを Julius へ送信します．また，Julius から認識結果や入力トリガ情報などのメッ セージが送信されてきたときは，その内容を標準出力へ書き出します．

APIの詳細については関連文書をご覧下さい．

OPTIONS
接続先のホスト名（Julius がモジュールモードで動作中） (optional) ポート番号 (default=10500)

COMMANDS (COMMON)
起動後，jcontrol に対して以下のコマンド文字列を標準入力から入力できます． 認識を中断する．認識途中の場合，そこで入力を中断して第2パスまで認識が 終わってから中断する． 認識を中断する．認識途中の場合，入力を破棄して即時中断する． 認識を再開． 文法切り替え時に音声入力であった場合の入力中音声の扱いを指定． "TERMINATE", "PAUSE", "WAIT"のうちいずれかを指定． バージョン文字列を返す システムの状態(active/sleep)を返す．

GRAMMAR COMMANDS
文法・単語認識用のコマンドです： 認識文法を "prefix.dfa" と "prefix.dict" に切り替える． カレントプロセス内の文法は全て消去され，指定された文法に置き換わる． 認識文法として "prefix.dfa" と "prefix.dict" を追加する． 指定されたIDの認識文法を削除する． 指定文法はカレントプロセスから削除される．ID は Julian から送られる GRAMINFO 内に記述されている． 指定されたIDの認識文法を，一時的にOFFにする．OFFにされた文法は認識処理 から一時的に除外される．このOFFにされた文法は Julius 内に保持され， "activategram" コマンドで再び ON にできる． 一時的に OFF になっていた文法を再び ON にする． 更新された文法を即時適応する．

COMMANDS (PROCESS)
現在エンジンにある認識プロセスの一覧を示す． コマンドを実行する対象のカレントプロセスを指定されたものに切替える． コマンドを実行する対象のカレントプロセスを順に切替える． エンジンに認識プロセスを追加する．jconffile は１つの LM 設定を含む もので，サーバ側から見える必要が有る．追加された LM および認識プロセス は jconffile の名前がプロセス名となる． 指定された名前の認識プロセスをエンジンから削除する． 以前に一時無効化されたプロセスを再度有効化する． 指定されたプロセスを一時無効化する． dictfile中の単語を，カレントプロセスの gram_id の文法に追加する． （文法・単語認識のみ）

EXAMPLE
Julius からのメッセージは "> " を行の先頭につけて そのまま標準出力に出力されます． 出力内容の詳細については，関連文書を参照してください．

(1) Julius をモジュールモードでホスト host で起動する．
    % julius -C xxx.jconf ... -input mic -module

(2) (他の端末で) jcontrol を起動し，通信を開始する．
    % jcontrol host
    connecting to host:10500...done
    > <GRAMINFO>
    > # 0: [active] 99words, 42categories, 135nodes (new)
    > </GRAMINFO>
    > <GRAMINFO>
    > # 0: [active] 99words, 42categories, 135 nodes
    > Grobal: 99words, 42categories, 135nodes
    > </GRAMINFO>
    > <INPUT STATUS="LISTEN" TIME="1031583083"/>
 -> pause
 -> resume
    > <INPUT STATUS="LISTEN" TIME="1031583386"/>
 -> addgram test
    ....

SEE ALSO
julius(1)

BUGS
バグ報告・問い合わせ・コメントなどは julius-info at lists.sourceforge.jp までお願いします．

VERSION
This version is provided as part of Julius-3.5.1.

COPYRIGHT
Copyright (c) 2002-2007 京都大学 河原研究室
Copyright (c) 2002-2005 奈良先端科学技術大学院大学 鹿野研究室
Copyright (c) 2005-2007 名古屋工業大学 Julius開発チーム

AUTHORS
李 晃伸 (名古屋工業大学) が実装しました．

LICENSE
Julius の使用許諾に準じます．