2004年10月10日更新　　

将棋Web中継システム飯島将棋中継盤 Ver1.0 設置マニュアル

はじめに

このマニュアルは、飯島将棋中継盤の設置方法について解説したものです。
このマニュアルをご覧になる前に、「飯島将棋中継盤　システム概要」もご一読ください。
先にどんな機能があるかや操作法を知っておくことでより理解が深まります。

１．飯島将棋中継盤のファイルの設置について

１－１．梱包ファイル一覧

飯島将棋中継盤の圧縮ファイル「live.lzh」を解凍すると、
以下に示すクラスファイルが５個と画像ファイルが５個梱包されています。

　・Iijimaban.class
　・Iijimaban$1.class
　・Iijimaban$2.class
　・Iijimaban$myBTNListener1.class
　・Iijimaban$myCHListener1.class
　・komalimg.gif
　・komabimg.gif
　・komal180img.gif
　・komab180img.gif
　・komadaiimg.gif

１－２．クラスファイルと画像ファイルの設置

クラスファイルと画像ファイルをそれぞれ任意のフォルダに格納し、
さらに、棋譜管理ファイルと棋譜ファイル１と棋譜ファイル２を作成し、
任意のフォルダに格納します。
(棋譜管理ファイルと棋譜ファイル１と棋譜ファイル２は同一フォルダに格納します。)

HTMLなどドキュメントファイルには、次のように指定します。

(ア)：classファイルの格納フォルダ(ドキュメントからの相対パスで指定)
ドキュメントファイルの入っているフォルタに格納している場合、
「codedbase ="……」の指定は省略できます。

(イ)：GIF画像ファイルの格納フォルダ(ドキュメントからの相対パスで指定)
ドキュメントファイルの入っているフォルタに格納している場合、
「<param name="imgdir" value="……」の指定は省略できます。

(ウ)：棋譜管理ファイル、棋譜ファイル１、棋譜ファイル２の格納フォルダ(絶対パスで指定)

(エ)：棋譜管理ファイル名
棋譜管理ファイル、棋譜ファイルについては、後述します。

例：

尚、クラスファイルと画像ファイルを同じフォルダに格納する必要はありません。
但し、飯島将棋盤、飯島将棋研究盤、飯島静止将棋盤用のフォルダとは分けてください。
(同一ファイル名のファイルが存在します。)
また、棋譜管理ファイルと棋譜ファイルの格納フォルダは、絶対パスで指定できますが、
同一サーバー内に限ります。

２．棋譜管理ファイル／棋譜ファイルの作成

２－１．棋譜管理ファイルの構造

棋譜管理ファイルは、カンマ区切りのテキスト形式で以下の構造で作成します。

初期対戦カード,棋譜ファイル１,棋譜ファイル２,対戦カード,対局者１,対局者２
初期対戦カード,棋譜ファイル１,棋譜ファイル２,対戦カード,対局者１,対局者２
　　　　　　　　　　　　　　　　　　　：
初期対戦カード,棋譜ファイル１,棋譜ファイル２,対戦カード,対局者１,対局者２

１行が１対戦カードの構造をしています。
初期対戦カードは、将棋盤が起動した直後の対戦カードを指定するもので、
1 を指定すると、その対局カードが指定されます。
棋譜ファイル１は、既設棋譜用のファイル名を指定します。
棋譜ファイル２は、更新棋譜用のファイル名を指定します。
対戦カードは、選択コートロールに表示される内容を指定します。
第99期○○戦　▲○○○○Ｘ△○○○○のように書式は自由です。
対局者１は、通常先手対局者名を指定します。(駒落ちなら下手対局者名)
対局者２は、通常後手対局者名を指定します。(駒落ちなら上手対局者名)
対局者名は、駒台の側に表示されます。
レイアウト上、対局者名の前に半角スペースの使用をお勧めします。

例：

1,1-1.txt,1-2.txt,▲羽田善治二冠×△森田俊之三冠, 羽田善治二冠, 森田俊之三冠
0,2-1.txt,2-2.txt,▲羽田善治二冠×△谷口浩司棋王, 羽田善治二冠, 谷口浩司棋王
0,3-1.txt,3-2.txt,▲羽田善治二冠×△佐々康光棋聖, 羽田善治二冠, 佐々康光棋聖

２－２．棋譜ファイル１／棋譜ファイル２の概要

飯島将棋中継盤は、１つの対局毎に、棋譜ファイル１と棋譜ファイル２が必要です。
棋譜ファイル１と棋譜ファイル２の概要は、以下の通りです。

棋譜ファイル１
開始局面の駒の配置(平手の初形は省略可)
開始局面の持駒(平手の初形は省略可)
第１手目の手番(平手の初形は省略可)
既設棋譜

棋譜ファイル２
更新棋譜
最終コメント(省略時：○○手まで)
起動局面(省略時：最終手)
強制リロード(特別な時以外不要)

平手の初形の場合、「駒の配置、持駒、手番」を省略でき、ほとんどの場合、棋譜ファイル１には、既設棋譜だけが必要になります。また、「最終コメント、起動局面、強制リロード」も省略できる場合が多く、終局した対局で終了コメントを記述する他は、ほとんどの場合、棋譜ファイル２には、更新棋譜だけが必要になります。
尚、棋譜は、飯島将棋研究盤(Ver2.1以降)でグラフィカルに入力できます。
棋譜を入力後、「子２」ボタンをクリックするとJavaコンソールに棋譜が自動作成されます。
これを、コピー(ctrlキー＋Ｃ)＆ペーストすることで、棋譜入力の手間を軽減できます。

２－３．棋譜ファイル１の詳細

平手の対局を初手から中継する場合、棋譜ファイル１には棋譜のみ必要になります。

1:指し手,読み上げ
2:指し手,読み上げ
:
?:指し手,読み上げ

棋譜は、飯島将棋研究盤でグラフィカルに入力し「子２」ボタンで自動作成できます。
自動作成せず、手動で作成する場合や詳細を確認される場合、以下をお読みください。
棋譜は、第何手目かを表す「1:」～「1525:」の後ろに指し手を表す文字列を記述し、
さらに、「,」を付加しその後ろに読み上げを記述します。
(最長手数の制限は、1525手です。)
盤上の駒を用いた指し手は、移動元と移動先の位置を表す４文字の数字で指定します。
例外で、駒が成る場合のみ５文字目に「*」を付加します。

例：第1手目、先手の７七の歩が７六に移動

1:7776,▲７六歩

例：第21手目、先手の８八の角が２二に移動し成る

21:8822*,▲８八角成

持駒を使う指し手は、第１文字目が「0」、第２文字目が駒を表す数字(下表参照)、
第３、４文字目が、盤上の位置を表す数字(棋譜表記と同じで「７六」は「76」)で指定します。

	歩	香	桂	銀	金	角	飛
持駒を使う場合の駒の種類を表す数字	0	1	2	3	4	5	6

例：第52手目、後手が持駒「飛」を８九に打つ

52:0689,△８九飛

駒落ちの対局などを中継する場合、棋譜ファイル１には駒の配置や手番なども必要になります。

i1:開始局面の駒の配置
i2:開始局面の駒の配置
:
i9:開始局面の駒の配置
i0:開始局面の持駒
opt:第１手目の手番
1:指し手,読み上げ
2:指し手,読み上げ
:
?:指し手,読み上げ

開始局面の駒の配置は、「i1:」～「i9:」の後ろに駒を表す９文字の文字列を記述し指定します。
「i1:」は盤上の１段目を表し「i9:」は盤上の９段目を表します。
「i1:」～「i9:」の後ろに記述する文字列は、先頭から順に盤上の９筋～１筋を表します。
各駒を表す記号は、次の表の通りです。駒のない位置は、「.」(ドット)で表します。
また、１段すべてに駒がないない場合、その段は省略できます。
「i1:」～「i9:」を省略すると平手の開始局面とみなされます。

歩

香

桂

銀

金

角

飛

玉

と

成香

成桂

成銀

馬

龍

後手の駒

先手の駒

例：平手の初形(例として揚げましたが、平手の初形の場合は、省略できます。)

i1:iygkokgyi
i2:.h.....x.
i3:fffffffff
i7:FFFFFFFFF
i8:.X.....H.
i9:IYGKOKGYI

開始局面の持駒は、「i0:」の後ろに駒を表す文字(上記表参照)を記述し指定します。

例：先手の持駒が「飛角金歩二」後手の持駒が「金銀銀桂香歩三」

i0:HXKFFkggyifff

第１手目の手番は、第１手目を手前の対局者が指す場合、省略します。
駒落ちのように、第１手目を向う(上手)の対局者が指す場合、「opt:g」と指定します。

２－４．棋譜ファイル２の詳細

棋譜ファイル２は、テキスト形式で以下の構造で作成します。

?:指し手,読み上げ
?:指し手,読み上げ
:
?:指し手,読み上げ
end:最終コメント
go:起動局面
er:強制リロード

更新棋譜の書式は、既設棋譜と同じです。

最終コメントは、「end:」の後ろにコメントを記述し指定します。
省略すると、「○○手まで」と表示されます。(○○には手数が入ります)
最終コメントは、棋譜の選択コントロールにそのまま表示されます。
選択コントロールから表示が溢れないよう「まで先手勝ち」などと短文で指定します。

例：千日手

end:まで千日手

起動直後の局面に「任意の手数まで指し手を進めた局面」を指定できます。
起動局面は、「go:」の後ろに進める局面の手数を記述し指定します。
省略すると、最終手が指定されたとみなされます。
中継を行う場合、ほとんどの場合最終手を指定するため、あまりこの指定は用いません。

例：第15手目

go:15

強制リロード(読み込み)は、棋譜の誤入力があり、既設棋譜を修正したときなど、
既設棋譜を強制的にリロードさせる指定です。
強制リロードは、「er:」の後ろに数値を記述し指定します。
指定する数値は、強制リロードの指定をする毎に１から順に上げて行きます。
実際に棋譜をリロードするタイミングは、この値を読み、数値が上がったときのみです。
次の更新時、強制リロードの指定がされていても数値が同じならリロードはされませんので、
無駄なリロードを繰り返すことはありません。
強制リロードの指定を一旦行うと、棋譜ファイル２よりこの指定を削除することはできません。

例：棋譜の誤入力が１回あり、１回目の強制リロードをかける場合

er:1

３．注意事項

３－１．動作試験

飯島将棋中継盤は、ローカルでの動作試験は行えません。
全ての試験は、インターネット上で行ってください。
ローカルで動作試験する際、棋譜ファイルの格納ディレクトリ(フォルダ)の指定は、
次のような書式になります。

<param name="kifudir" value="file:c:/abc/xyz/kifu/">(Windowsなどの場合)

３－２．更新手数

棋譜ファイル２に入れる棋譜は、何手まとめて入力されても問題ありません。
ただ、あまり多くまとめてしまうと、サーバーへの負荷の軽減が減少してしまいます。

３－３．中継の最中、または、中継終了後の棋譜ファイル２

中継の最中、または、中継終了後の棋譜ファイル２には、最低１手以上棋譜を残してください。
棋譜ファイル１にすべての棋譜を移してしまうと、動作が保証されません。

３－４．ＦＴＰの順序

ファイルのＦＴＰは、棋譜ファイル１、棋譜ファイル２の順に行ってください。
例えば、
　棋譜ファイル１に第１手目～第１５手目の棋譜があり、
　棋譜ファイル２に第１６手目～第１８手目の棋譜がある状態で、
　先に棋譜ファイル１に第１６手目～第１８手目の棋譜を追加し更新(ＦＴＰ)し、
　次に棋譜ファイル２に第１９、２０手目だけの棋譜を入れ更新(ＦＴＰ)すれば、
棋譜ファイル２の最終手と棋譜ファイル１の最終手の手数が同手数となる時間帯が生じ、
その瞬間にクライアント側で自動更新されていることが有り得ますが、何ら問題ありません。
このような場合、第１９、２０手目の更新は、何事もなかったかのように次回以降に行われます。

　　棋譜ファイル１、棋譜ファイル２の順で更新したときの流れ図

棋譜ファイル１
第１手目
第２手目
：
第１５手目

更新＝＞

棋譜ファイル１
第１手目
第２手目
：
第１５手目
第１６手目
第１７手目
第１８手目

維持＝＞

棋譜ファイル１
第１手目
第２手目
：
第１５手目
第１６手目
第１７手目
第１８手目

棋譜ファイル２
第１６手目
第１７手目
第１８手目

維持＝＞

棋譜ファイル２
第１６手目
第１７手目
第１８手目

更新＝＞

棋譜ファイル２
第１９手目
第２０手目

一方、棋譜ファイル２を先に更新(ＦＴＰ)すると、
直後に、棋譜の一部が存在しない時間帯(下図参照)が生じてしまい、
この一瞬のタイミングで自動更新が行われると、正常な動作が期待できません。

　　棋譜ファイル２、棋譜ファイル１の順で更新したときの流れ図

棋譜ファイル１
第１手目
第２手目
：
第１５手目

維持＝＞

棋譜ファイル１
第１手目
第２手目
：
第１５手目
(なし)
(なし)
(なし)

更新＝＞

棋譜ファイル１
第１手目
第２手目
：
第１５手目
第１６手目
第１７手目
第１８手目

棋譜ファイル２
第１６手目
第１７手目
第１８手目

更新＝＞

棋譜ファイル２
第１９手目
第２０手目

維持＝＞

棋譜ファイル２
第１９手目
第２０手目

３－５．棋譜の誤入力に対する処置

中継の最中、棋譜の誤入力をしてしまった場合、次の処置を施してください。
棋譜ファイル１に最終手を除いた棋譜を入れ更新(ＦＴＰ)します。
次に、棋譜ファイル２に棋譜(最終手)を入れ、さらに強制リロードを入れ更新(ＦＴＰ)します。
強制リロードは、初回ならば、棋譜ファイル２に、次の行を加えてください。
２回目以降ならば、「er:」の後ろの数値を１つ上げてください。

er:1

３－６．中継がない棋譜の掲載

中継がなく、掲載時にはすでに終局している対局の棋譜を掲載する場合、
棋譜は、棋譜ファイル１に全て入れても問題ありません。

４．設置例

４－１．設置例１

飯島将棋中継盤　設置例１(Javaが起動します。)

設置例１は、「平手の対局」の例(２局)で、中継開始直前の例です。
平手の場合、駒の配置を省略しているため、対局開始前の棋譜ファイル１の中身は空です。
また、棋譜ファイル２の中身も空です。

ドキュメントに記述するアプレットタグ

棋譜管理ファイル「rei1.txt」

1, a-1.txt, a-2.txt,▲羽田善治二冠×△森田俊之三冠, 羽田善治二冠, 森田俊之三冠
0, b-1.txt, b-2.txt,▲佐々康光棋聖×△谷口浩司棋王, 佐々康光棋聖, 谷口浩司棋王

▲羽田善治二冠×△森田俊之三冠　棋譜ファイル１「a-1.txt」

空(ファイルだけ存在)

▲羽田善治二冠×△森田俊之三冠　棋譜ファイル２「a-2.txt」

空(ファイルだけ存在)

▲佐々康光棋聖×△谷口浩司棋王　棋譜ファイル１「b-1.txt」

空(ファイルだけ存在)

▲佐々康光棋聖×△谷口浩司棋王　棋譜ファイル２「b-2.txt」

空(ファイルだけ存在)

４－２．設置例２

飯島将棋中継盤　設置例２(Javaが起動します。)

設置例２は、設置例１に引き続き、中継が開始され中継の最中の例です。
１局は、１手だけ指され、もう１局は、２手まで進んでいる例です。
２局目の方は、第１回目の更新で、棋譜を２手分更新した例です。

ドキュメントに記述するアプレットタグ

棋譜管理ファイル「rei2.txt」

▲羽田善治二冠×△森田俊之三冠　棋譜ファイル１「a-1.txt」

空(ファイルだけ存在)

▲羽田善治二冠×△森田俊之三冠　棋譜ファイル２「a-2.txt」

1:7776,▲７六歩

▲佐々康光棋聖×△谷口浩司棋王　棋譜ファイル１「b-1.txt」

空(ファイルだけ存在)

▲佐々康光棋聖×△谷口浩司棋王　棋譜ファイル２「b-2.txt」

1:2726,▲２六歩
2:3334,△３四歩

４－３．設置例３

飯島将棋中継盤　設置例３(Javaが起動します。)

設置例３は、設置例２に引き続き、中継の最中の例です。
１局は、７手まで指され、もう１局は、８手まで指されている例です。

ドキュメントに記述するアプレットタグ

棋譜管理ファイル「rei3.txt」

▲羽田善治二冠×△森田俊之三冠　棋譜ファイル１「a-1.txt」

1:7776,▲７六歩
2:8384,△８四歩
3:7968,▲６八銀
4:3334,△３四歩
5:6766,▲６六歩
6:7162,△６二銀

▲羽田善治二冠×△森田俊之三冠　棋譜ファイル２「a-2.txt」

7:5756,▲５六歩

▲佐々康光棋聖×△谷口浩司棋王　棋譜ファイル１「b-1.txt」

1:2726,▲２六歩
2:3334,△３四歩
3:7776,▲７六歩
4:4344,△４四歩
5:2625,▲２五歩
6:2233,△３三角
7:3948,▲４八銀

▲佐々康光棋聖×△谷口浩司棋王　棋譜ファイル２「b-2.txt」

8:8242,△４二飛

４－４．設置例４

飯島将棋中継盤　設置例４(Javaが起動します。)

設置例４は、「平手の中継の終了した対局」と「駒落ちの対局」の例です。

ドキュメントに記述するアプレットタグ例

棋譜管理ファイル「rei4.txt」

1, a-1.txt, a-2.txt,▲初心者Ａ７級×△初心者Ｂ８級, 初心者Ａ７級, 初心者Ｂ８級
0, b-1.txt, b-2.txt,▲飯島　勉アマ×△羽田善治二冠, 飯島　勉アマ, 羽田善治二冠

▲初心者Ａ７級×△初心者Ｂ８級　棋譜ファイル１「a-1.txt」

1:7776,▲７六歩
2:8384,△８四歩
3:5756,▲５六歩
4:5354,△５四歩
5:2858,▲５八飛
6:7162,△６二銀
7:5655,▲５五歩
8:5455,△同　歩
9:8855,▲同　角
10:8485,△８五歩

▲初心者Ａ７級×△初心者Ｂ８級　棋譜ファイル２「a-2.txt」

11:5533*,▲３三角成
end:まで初心者Ａの勝ち

▲飯島　勉アマ×△羽田善治二冠　棋譜ファイル１「b-1.txt」

i1:iygkokgyi
i2:.h.......
i3:fffffffff
i7:FFFFFFFFF
i8:.X.....H.
i9:IYGKOKGYI
opt:g
1:8384,△８四歩
2:7776,▲７六歩
3:8485,△８五歩
4:8877,▲７七角
5:7162,△６二銀
6:7988,▲８八銀

▲飯島　勉アマ×△羽田善治二冠　棋譜ファイル２「b-2.txt」

7:5354,△５四歩

４－５．設置例５

飯島将棋中継盤　設置例５(Javaが起動します。)

設置例５は、「詰将棋の出題」と「詰将棋の解答」の例です。

ドキュメントに記述するアプレットタグ例

棋譜管理ファイル「rei5.txt」

1, a-1.txt, a-2.txt,詰将棋　第１問　出題　　　　　, 攻　方, 玉　方
0, b-1.txt, b-2.txt,詰将棋　第１問　解答　　　　　, 攻　方, 玉　方

詰将棋第１問出題　棋譜ファイル１「a-1.txt」

i1:.....kgyi
i2:......o..
i3:....T..ff
i4:......f..
i5:.......F.
i0:HXKGhxkkggyyyiiifffffffffffff

詰将棋第１問出題　棋譜ファイル２「a-2.txt」

空(ファイルだけ存在)

詰将棋第１問解答　棋譜ファイル１「b-1.txt」

i1:.....kgyi
i2:......o..
i3:....T..ff
i4:......f..
i5:.......F.
i0:HXKGhxkkggyyyiiifffffffffffff
1:0612,▲１二飛
2:1112,△同　香
3:0333,▲３三銀
4:3233,△同　玉
5:0511,▲１一角
6:3122,△２二銀
7:0443,▲４三金

詰将棋第１問解答　棋譜ファイル２「b-2.txt」

go:0
end:まで７手詰

４－６．設置例６

飯島将棋中継盤　設置例６(Javaが起動します。)

設置例６は、「指定局面戦」の中継の例です。

ドキュメントに記述するアプレットタグ例

棋譜管理ファイル「rei6.txt」

1, a-1.txt, a-2.txt,▲羽田善治二冠×△森田俊之三冠, 羽田善治二冠, 森田俊之三冠

▲羽田善治二冠×△森田俊之三冠　棋譜ファイル１「a-1.txt」

i1:iygk.kgRi
i2:...oh....
i3:ffff.f..f
i4:......f..
i5:..X.Y....
i6:..F.F....
i7:FF.F.FF.F
i8:.u..K....
i9:IY.KO.GYI
i0:FFgf
22:8887,△８七馬
23:0082,▲８二歩
24:7374,△７四歩
25:8281*,▲８一歩成
26:7475,△７五歩
27:8171,▲７一と
28:6171,△同　金
29:2111,▲１一龍
30:0057,△５七歩

▲羽田善治二冠×△森田俊之三冠　棋譜ファイル２「a-2.txt」

31:5857,▲同　金

将棋Web中継システム 飯島将棋中継盤 Ver1.0 設置マニュアル

はじめに

１．飯島将棋中継盤のファイルの設置について

１－１．梱包ファイル一覧

１－２．クラスファイルと画像ファイルの設置

２．棋譜管理ファイル／棋譜ファイルの作成

２－１．棋譜管理ファイルの構造

２－２．棋譜ファイル１／棋譜ファイル２の概要

２－３．棋譜ファイル１の詳細

２－４．棋譜ファイル２の詳細

３．注意事項

３－１．動作試験

３－２．更新手数

３－３．中継の最中、または、中継終了後の棋譜ファイル２

３－４．ＦＴＰの順序

３－５．棋譜の誤入力に対する処置

３－６．中継がない棋譜の掲載

４．設置例

４－１．設置例１

４－２．設置例２

４－３．設置例３

４－４．設置例４

４－５．設置例５

４－６．設置例６

あとがき

将棋Web中継システム飯島将棋中継盤 Ver1.0 設置マニュアル