そずべねぐ/OnRequestPropertyとOnRequestValues

OnRequestPropertyとOnRequestValues、そして、ごーすとじてんたちが要求するもの†

アリス「ねえ、ボブ。」
ボブ「どうしたんだい、アリス。」
アリス「ごーすとじてんやきゅーぴっどに対応してわたしのゴーストと他のゴーストを戦わせたいんだけど、どうすればいいのか良くわからないのよ」
ボブ「HAHAHA! そのへんにいっぱいテンプレートが配布されているじゃまいか」
アリス「でも、テンプレートそのまま使うのも釈然としないのよ」
ボブ「しょうがないなぁ。確かに資料が散逸してて良くわからないからね。特別にボクが資料をまとめたから参考にするといいよ」
アリス「わぁ。さすがはボブね」

目次†

各種イベントについて†

OnRequestProperty†

• 「ぬるぽいんたーはい」や「ごーすとじてん」、「きゅーぴっど」が他ゴーストに対して情報を要求する際に投げてくるイベント。
• 要求された側のゴーストは要求に対する応答をOnGetPropertyイベントを投げ返す必要がある。
• OnGetPropertyイベントを投げ返さなければ非対応ということになる。

パラメータ†

他ゴーストからのOnRequestPropertyイベントに対応するゴースト作者はOnRequestPropertyイベントに対するトークの中で、OnGetPropertyイベントを\![raiseother]を用いて送り返す必要がある。

OnGetProperty†

• OnRequestPropertyイベントに対する応答として要求元に対して応答を投げ返すためのイベント。
• OnRequestPropertyイベントに対するトークの中で\![raiseother]を用いてOnGetPropertyイベントを投げ返すという形で用いる。

パラメータ†

他ゴーストからのOnRequestPropertyイベントに対応するゴースト作者は上記のようなReference値を持ったOnGetPropertyイベントを、OnRequestPropertyイベントに対するトークの中で\![raiseother]を用いて投げ返してやる必要がある。
上記の例に対応したOnGetPropertyイベントを投げるさくらスクリプト(SSP拡張)は以下の通り。

\![raiseother,斗月,OnGetProperty,天羽ちはる,0,種族,天使]

OnRequestPropertyとOnGetPropertyのサンプル†

ここでは、斗月(ぬるぽいんたーはい)で天羽ちはる(天羽ちはる)の種族を確認した場合の流れをあげます。

①斗月(ぬるぽいんたーはい)→本体(SSP)

SHIORI/3.0 200 OK

Value: \0\s[0]\1\s[10]\1\_w[12]\0心の目で種族を調べます。\_w[72]わからなくても勘弁。\_w[60]\n\![raiseother,天羽ちはる,OnRequestProperty,斗月,0,種族]\_w[12]\e

Charset: Shift_JIS

※イベントの本体(SSP)への応答。応答メッセージの中の\![raiseother]により、天羽ちはるに対してOnRequestPropertyイベントが投げられる。

②本体(SSP)→天羽ちはる(天羽ちはる)

GET SHIORI/3.0

Sender: 斗月

Charset: UTF-8

SecurityLevel: local

ID: OnRequestProperty

Reference0: 斗月

Reference1: 0

Reference2: 種族

※斗月から\![raiseother]されたOnRequestPropertyイベントが天羽ちはるに届いた。

③天羽ちはる(天羽ちはる)→本体(SSP)

SHIORI/3.0 200 OK

Sender: AYA

Charset: UTF-8

Value: \![raiseother,斗月,OnGetProperty,天羽ちはる,0,種族,天使]\e

※②で送られたOnRequestPropertyイベントの応答メッセージ。\![raiseother]により、斗月に対してOnGetPropertyイベントが投げられる。
OnGetPropertyイベントのReference3には天羽ちはるの種族である『天使』が乗っている。

④本体(SSP)→斗月(ぬるぽいんたーはい)

GET SHIORI/3.0

Sender: 天羽ちはる

Charset: Shift_JIS

SecurityLevel: local

Status: talking

ID: OnGetProperty

Reference0: 天羽ちはる

Reference1: 0

Reference2: 種族

Reference3: 天使

※天羽ちはるから\![raiseother]されたOnGetPropertyイベントが斗月に届いた。
この後、斗月（ぬるぽいんたーはい）内部で取得した値が処理される。

OnRequestValues†

• 「ぬるぽいんたーはい」や「ごーすとじてん」、「きゅーぴっど」が他ゴーストに対して情報を要求する際に投げてくるイベント。
• OnRequestPropertyが一度に一つしか値を取得することができないという問題に対して提唱されたイベントで、一度に複数の値を取得することができる。
• 要求された側のゴーストは要求に対する応答をOnGetValuesイベントを投げ返す必要がある。
• OnGetValuesイベントを投げ返さなければ非対応ということになる。

パラメータ†

OnRequestValuesはReference1以降に１個以上の要求するキーを設定していく。 他ゴーストからのOnRequestValuesイベントに対応するゴースト作者はOnRequestValuesイベントに対するトークの中で、OnGetValuesイベントを\![raiseother]を用いて送り返す必要がある。

OnGetValues†

• OnRequestValuesイベントに対する応答として要求元に対して応答を投げ返すためのイベント。
• OnRequestValuesイベントに対するトークの中で\![raiseother]を用いてOnGetValuesイベントを投げ返すという形で用いる。

パラメータ†

他ゴーストからのOnRequestValuesイベントに対応するゴースト作者は上記のようなReference値を持ったOnGetValuesイベントを、OnRequestValuesイベントに対するトークの中で\![raiseother]を用いて投げ返してやる必要がある。
上記の例に対応したOnGetValuesイベントを投げるさくらスクリプト(SSP拡張)は以下の通り。

\![raiseother,ごーすとじてん,OnGetValues,天羽ちはる,0キャラクター名=天羽ちはる,0世代=子供,…]

OnRequestValuesとOnGetValuesのサンプル†

ここでは、ごーすとじてん(ごーすとじてん)で天羽ちはる(天羽ちはる)のプロフィール確認を実施した場合の流れをあげます。

①ごーすとじてん（ごーすとじてん）→本体(SSP)

SHIORI/3.0 200 OK

Sender: AYA

Charset: Shift_JIS

Value: \![raiseother,天羽ちはる,OnRequestValues,ごーすとじてん,dummy,0キャラクター名,0世代,0性別,0種族,0種族タイプ,0行動タイプ,0プロフィール,1キャラクター名,1世代,1性別,1種族,1種族タイプ,1行動タイプ,1プロフィール]\e

※イベントの本体(SSP)への応答。応答メッセージの中の\![raiseother]により、天羽ちはるに対してOnRequestValuesイベントが投げられる。

②本体(SSP)→天羽ちはる(天羽ちはる)

GET SHIORI/3.0

Sender: ごーすとじてん

Charset: Shift_JIS

SecurityLevel: local

ID: OnRequestValues

Reference0: ごーすとじてん

Reference1: dummy

Reference2: 0キャラクター名

Reference3: 0世代

Reference4: 0性別

Reference5: 0種族

Reference6: 0種族タイプ

Reference7: 0行動タイプ

Reference8: 0プロフィール

Reference9: 1キャラクター名

Reference10: 1世代

Reference11: 1性別

Reference12: 1種族

Reference13: 1種族タイプ

Reference14: 1行動タイプ

Reference15: 1プロフィール

※ごーすとじてんから\![raiseother]されたOnRequestValuesイベントが天羽ちはるに届いた。

③天羽ちはる（天羽ちはる）→本体(SSP)

SHIORI/3.0 200 OK

Charset: Shift_JIS

Sender: 天羽ちはる

Value: \![raiseother,ごーすとじてん,OnGetValues,天羽ちはる,0キャラクター名=天羽ちはる,0世代=子供,0性別=女性,0種族=天使,0種族タイプ=人型,0行動タイプ=精神攻撃,0プロフィール=かみゅう神に仕える天使,1キャラクター名=町埜アンナ,1世代=子供,1性別=女性,1種族=人間,1種族タイプ=人型,1行動タイプ=精神攻撃,1プロフィール=ふつーの女の子]\e

※OnRequestValuesイベントの応答メッセージ。\![raiseother]により、ごーすとじてんに対してOnGetValuesイベントが投げられる。
OnGetValuesイベントのReference1以降にごーすとじてんから要求されたキーと値の組が設定されている。

③本体(SSP)→ごーすとじてん（ごーすとじてん）

GET SHIORI/3.0

Sender: 天羽ちはる

Charset: Shift_JIS

SecurityLevel: local

Status: talking

ID: OnGetValues

Reference0: 天羽ちはる

Reference1: 0キャラクター名=天羽ちはる

Reference2: 0世代=子供

Reference3: 0性別=女性

Reference4: 0種族=天使

Reference5: 0種族タイプ=人型

Reference6: 0行動タイプ=精神攻撃

Reference7: 0プロフィール=かみゅう神に仕える天使

Reference8: 1キャラクター名=町埜アンナ

Reference9: 1世代=子供

Reference10: 1性別=女性

Reference11: 1種族=人間

Reference12: 1種族タイプ=人型

Reference13: 1行動タイプ=精神攻撃

Reference14: 1プロフィール=ふつーの女の子

※天羽ちはるから\![raiseother]されたOnGetValuesイベントがごーすとじてんに届いた。

ごーすとじてんたちが要求するもの†

ぬるぽいんたーはいが要求するもの†

「ぬるぽいんたーはい」がOnRequestPropertyやOnRequestValuesで要求してくる値のリスト

ごーすとじてんが要求するもの†

「ごーすとじてん」がOnRequestPropertyやOnRequestValuesで要求してくる値のリスト

きゅーぴっどが要求するもの†

「きゅーぴっど」がOnRequestPropertyやOnRequestValuesで要求してくる値のリスト

-1NOBと-1NOCの詳細はにこらとてすらの拍手レス 2008/07/22分を参照のこと。

華和梨での実装例†

• 天羽ちはるでの実装例（内部処理部分）
• 天羽ちはるでの実装例（値設定部分）

上記２ファイルで一組。
なお、華和梨での実装において、"-1NOB"の"-"はエントリ名として使えないことに注意して実装すること。

関連リンク†

• LR/大根2
• Don/OnRequestValues／OnGetValues対応法
• Don/OnJitenBattle対応法

コメント†

• カード画像パスとは言うけれど、使用可能な画像サイズはどのぐらいの大きさなのだろう？ -- そずべねぐ 2008-07-29 (火) 05:11:36
• まだ決めてません、ごめんなさい＞＜ -- Don 2008-07-29 (火) 06:35:34

お名前: