サーバの応答無し
ドロップイベント(「OnURL〜」)、ネットワーク更新イベント、ヘッドラインセンスイベント、メールチェックイベント等で、サーバからデータをダウンロードする際に、一定時間相手サーバからの応答が無い時に発生します。補足
SSPでは、Reference0に、このままサーバからの応答が無い場合にタイムアウトエラーになるまでの時間(単位:秒)が入ります。パラメータ
サンプル
Reference0 タイムアウトエラーまでの時間(単位:秒)
GET SHIORI/3.0
Sender: crow
ID: OnNetworkHeavy
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]サーバーの応答がありません。\e
おすすめメニューのサイトクリック
右クリックメニューで現れる、「おすすめ」「ポータル」メニューの中からサイトを選んでクリックすると発生するイベントです。パラメータ
サンプル
Reference0 選択されたサイトの名称 Reference1 選択されたサイトのURL
GET SHIORI/3.0
Sender: crow
ID: OnRecommendsiteChoice
Reference0: CROW
Reference1: http://crow.aqrs.jp/
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]CROWのサイトをオープンします。\e
トランスレートイベント
このイベントは特殊で、各リクエストのあと実行すべきスクリプトがあった場合必ず発生します。補足
Reference0には直前のスクリプトが入ります。
もし、このスクリプトを変更する必要があった場合に変更して返すと、
そのスクリプトが実際に使われます。
MATERIAではバグで、\xタグを実行するともう一度このイベントが発生します。パラメータ
MATERIAで\xタグを使う場合、トランスレートを複数回実行しても大丈夫なように作る必要があります。
サンプル
Reference0 処理するべきスクリプト。
GET SHIORI/3.0
ID: OnTranslate
Reference0: \0\s[0]トランスレートします。\e
Sender: crow
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]トランスレートしました。\e
この場合、直前の何らかのイベントで”トランスレートします。”と返しています。
このイベントでトランスレートされるため、実際には”トランスレートしました。”と表示されます。
インストール開始
アーカイブがドラッグ&ドロップされインストールが開始した時に発生します。サンプル
GET SHIORI/3.0
Sender: crow
ID: OnInstallBegin
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]インストール開始。\e
インストール完了
インストールがエラーを起こさずに完了した場合に発生するイベントです。補足
SSPでは、OnInstallCompleteEx -> OnInstallComplete の順で発生します。
OnInstallCompleteEx でスクリプトを返した場合、こちらは発生しません。
Reference0にはインストールした物の種別が入りますが、現在のところ以下のとおりです。パラメータ
install.txtに書かれる識別子と同じものが入ります。
shell:シェル
ghost:ゴースト
supplement:ゴースト用追加ファイル
balloon:バルーン
plugin:プラグイン
headline:ヘッドラインセンサ
ghost with balloon:バルーンつきゴースト
shell with balloon:バルーンつきシェル
calendar skin:カレンダースキン [SSPのみ]
calendar plugin:スケジュールセンサ [SSPのみ]
SSP 1.10.17以降、試験的にReferenceで送られる仕様を変更していましたが、互換性の問題が生じたため1.10.21で元に戻りました。より詳しい情報を取りたい場合はOnInstallCompleteExに対応してください。
サンプル
Reference0 インストールした物の種別 Reference1 インストールした物の名前 Reference2 "with balloon" など複数インストールする場合、2つめのインストールした物の名前
GET SHIORI/3.0
Sender: crow
ID: OnInstallComplete
Reference0: ghost with balloon
Reference1: さくら&うにゅう
Reference2: さくらバルーン
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]インストール完了しました。\e
インストール失敗
インストールが何らかの理由で失敗した場合に発生するイベントです。補足
失敗した場合、Reference0に失敗の理由が入ります。
unlha32 unlha32ロード失敗
extraction 解凍失敗(アーカイブが破損)
invalid type install.txtが不正
artificial ユーザが手動中断
unsupported その他サポートしていないアーカイブをインストールしようとした
MATERIAでは、Reference0には何も返りません。パラメータ
SSPのみ中断時にReference0でartificialの通知を返します。
サンプル
Reference0 失敗の理由(unlha32/extraction/invalid type/artificial/unsupported)
GET SHIORI/3.0
Sender: crow
ID: OnInstallFailure
Reference0: invalid type
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]インストール失敗しました。\e
インストール拒否
インストールしようとしたアーカイブが、ドロップされたゴーストと別のゴーストを指名していた場合に発生するイベントです。パラメータ
サンプル
Reference0 指名されているゴーストの名前
GET SHIORI/3.0
Sender: crow
ID: OnInstallRefuse
Reference0: さくら
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]このゴーストにはインストールできません。\e
キーを押した
キーボードのキーが押された時に発生します。補足
特殊キーの識別子一覧です。パラメータ
back tab clear return control pause escape space prior next end home
left up right down delete f1 f2 f3 f4 f5 f6 f7 f8 f9 f10 f11 f12
サンプル
Reference0 押されたキーの識別子 Reference1 キーコード Reference2 キーを押したままの時の繰り返し回数(SSPのみ) Reference3 キーイベントが来たキャラクターウインドウID(SSPのみ)
GET SHIORI/3.0
Sender: crow
ID: OnKeyPress
Reference0: a
Reference1: 65
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]Aが押されました。\e
サーフィス変化
サーフィスが変化したときに呼ばれるイベントです。補足
変化したサーフィス番号が渡されます。
表示されていなければ、-1が入ります。
サイレントイベントなので、応答は無視されます。パラメータ
また、SSPではNOTIFYイベントとして発生します。
SSPではReference2に、\p[2]以降用対応のための拡張情報が入ります。
Reference3,4...と増えていくのではなく、ID,サーフィス番号,幅,高さ という形式でReference2のみ追加される点に注意してください。
この拡張情報は0番(メイン側)、1番(サブ側)が切り替わった場合でも常に通知されますので、Reference2が存在すればその情報を常に利用すると良いでしょう。
サンプル
Reference0 メイン側キャラのサーフィス番号 Reference1 サブ側キャラのサーフィス番号 Reference2 キャラID,サーフィス番号,サーフィス幅,サーフィス高さ [SSP]
GET SHIORI/3.0
Sender: crow
ID: OnSurfaceChange
Reference0: 0
Reference1: 10
SecurityLevel: local
Charset: Shift_JIS
NOTIFY SHIORI/3.0
Sender: SSP
ID: OnSurfaceChange
Reference0: 0
Reference1: 10
Reference2: 2,200,150,300
SecurityLevel: local
Charset: UTF-8
サーフィス復帰指示
サーフィスが変化した後、一定時間で呼び出されるイベントです。補足
このイベントに応答することにより、初期サーフィスに戻すことができますが、
戻すかどうかは各ゴーストに任されています。
また、このイベントはメイン側がサーフィス0でサブ側がサーフィス10の場合は発生しません。
それ以外に変化したときのみ呼ばれます。
CROWでは、変化後50秒経過後に呼ばれます。パラメータ
サンプル
Reference0 メイン側キャラのサーフィス番号 Reference1 サブ側キャラのサーフィス番号
GET SHIORI/3.0
Sender: crow
ID: OnSurfaceRestore
Reference0: 1
Reference1: 10
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]\1\s[10]\e
ファイル・フォルダドロップ開始
ファイルやフォルダがドラッグ&ドロップされた際に発生するイベントです。補足
複数のファイルやフォルダが同時にドロップされた場合は、バイト値 1 でセパレートされます。
Reference1にどのキャラにドラッグされたという情報が入ります。
このイベントをエラーで返さない(「200 OK」とし、Valueを返した)場合、SHIORIモジュール側で判断・処理したものとみなし、以後の処理(現時点で該当するのはマスタイベント)を行ないません。パラメータ
MATERIA,CROWでは現在サブキャラ側にドラッグされてもイベントは発生しません。
サンプル
Reference0 ドロップされたファイル又はドロップされたフォルダ Reference1 メインキャラ側なら0、サブキャラ側なら1
GET SHIORI/3.0
Sender: crow
ID: OnFileDrop2
Reference0: C:\sample.pngC:\test.txt
Reference1: 0
SecurityLevel: local
Charset: Shift_JIS
この例では、メインキャラ側にsample.pngとtest.txtが同時にドラッグ&ドロップされています。
NARファイル作成完了
「OnNarCreating」イベントによるNARファイルの作成が完了すると、このイベントが発生します。パラメータ
Reference2 には、NARファイル化されたデータの種類として、
ghost ゴースト
shell シェル
balloon バルーン
plugin プラグイン
…が入ります。
サンプル
Reference0 install.txtに記述されたnameの値 Reference1 生成したnarのファイル名 Reference2 install.txtに記述された種別
GET SHIORI/3.0
Sender: crow
ID: OnNarCreated
Reference0: サンプルゴースト
Reference1: sample.nar
Reference2: ghost
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]nar作成完了。\e
この例は、フォルダsampleをドラッグ&ドロップしたものです。
その時のinstall.txtの中身は
type,ghost
name,サンプルゴースト
directory,samplefolder
です。
NARファイル作成開始
ゴーストにインストール情報を記述したテキストファイル「install.txt」を含むフォルダをドラッグ&ドロップした時に発生するイベントです。補足
この後、「install.txt」の情報を元に、NARファイルが作成され、「OnNarCreated」イベントが呼ばれます。
生成するnarのファイル名はドラッグしたフォルダの拡張子をnarに変更したものになります。パラメータ
ドラッグしたフォルダの直下にinstall.txtがある必要があります。
サンプル
Reference0 install.txtに記述されたnameの値 Reference1 生成するnarのファイル名 Reference2 install.txtに記述された種別
GET SHIORI/3.0
Sender: crow
ID: OnNarCreating
Reference0: サンプルゴースト
Reference1: sample.nar
Reference2: ghost
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]narを作成します。\e
この例は、フォルダsampleをドラッグ&ドロップしたものです。
その時のinstall.txtの中身は
type,ghost
name,サンプルゴースト
directory,samplefolder
です。
アップデート情報作成完成
「OnUpdatedataCreating」イベントによる「updates2.dau」ファイルへのアップデート情報の作成が完了すると、このイベントが発生します。パラメータ
サンプル
Reference0 今起動しているゴーストのメインキャラ側の名称
GET SHIORI/3.0
Sender: crow
ID: OnUpdatedataCreated
Reference0: さくら
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]updates2.dau作成完了\e
アップデート情報作成開始
ゴーストに「updates2.dau」ファイル(空のテキストファイル)及び、アップデート対象とするファイルを含むフォルダをドラッグ&ドロップした時に、発生するイベントです。補足
この後、「updates2.dau」にアップデートファイルのMD5情報が作成されてから、「OnUpdatedataCreated」イベントが呼ばれます。
MATERIAでは、ファイルがドロップされるとまず「OnFileDrop2」イベントが呼ばれ、そのイベントに対してエラーで返されると、このイベントを呼ぶかを判断しています。パラメータ
(参照:「OnFileDrop2」イベント)
CROWでは、updates2.dauを含んでいれば、OnFileDrop2が発生せずにこのイベントが発生します。
サンプル
Reference0 今起動しているゴーストのメインキャラ側の名称
GET SHIORI/3.0
Sender: crow
ID: OnUpdatedataCreating
Reference0: さくら
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]updates2.dau作成開始\e
URLドロップ開始
ブラウザ等からアーカイブのURLをドラッグ&ドロップされた時に発生します。補足
イベントが発生するのは、URLがローカル(file://〜)でなく、インストール可能なアーカイブ(拡張子がNAR・ZIP・LZH)の時のみです。パラメータ
サンプル
Reference0 ドロップされたURL
GET SHIORI/3.0
Sender: crow
ID: OnURLDropping
Reference0: http://crow.aqrs.jp/sample.nar
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]http://crow.aqrs.jp/sample.narをダウンロードします。\e
ファイルダウンロード開始
ネットワーク更新中に、ファイルのダウンロードを開始する時に発生するイベントです。補足
Reference1と2は0から開始され、5個のファイルがあり、最初のファイルをダウンするときはパラメータ
Reference1は0、Reference2は4となります。
Reference3はCROW / SSP 2.0以降の実装です。
SSPで、ゴーストと同時にバルーンやシェルも更新する機能が有効の場合、ゴースト以外の更新時には、OnUpdateOther.OnDownloadBeginが発生します。
イベント名のみの変更で、他に違いはありません。
サンプル
Reference0 ファイル名 Reference1 今のファイルが全体の何番目か(0始まり) Reference2 更新するファイルの総数-1 Reference3 タイプ (shell,ghost,balloon,headline,plugin,basewareのいずれか)
GET SHIORI/3.0
Sender: crow
ID: OnUpdate.OnDownloadBegin
Reference0: descript.txt
Reference1: 0
Reference2: 1
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]\1\descript.txtのダウンロード開始。\e
MD5の照合開始
ファイルをダウンロードした後、MD5を照合する前に発生するイベントです。補足
この後、MD5が一致すれば、OnUpdate.OnMD5CompareComplete
一致しなければ、OnUpdate.OnMD5CompareFailureが発生します。
Reference3はCROW / SSP 2.0以降の実装です。パラメータ
SSPで、ゴーストと同時にバルーンやシェルも更新する機能が有効の場合、ゴースト以外の更新時には、OnUpdateOther.OnMD5CompareBeginが発生します。
イベント名のみの変更で、他に違いはありません。
サンプル
Reference0 ファイル名 Reference3 タイプ (shell,ghost,balloon,headline,plugin,basewareのいずれか)
GET SHIORI/3.0
Sender: crow
ID: OnUpdate.OnMD5CompareBegin
Reference0: descript.txt
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]MD5照合開始。\e
MD5一致
ダウンロードしたファイルのMD5が一致した時に発生するイベントです。補足
Reference3はCROW / SSP 2.0以降の実装です。パラメータ
SSPで、ゴーストと同時にバルーンやシェルも更新する機能が有効の場合、ゴースト以外の更新時には、OnUpdateOther.OnMD5CompareCompleteが発生します。
イベント名のみの変更で、他に違いはありません。
サンプル
Reference0 ファイル名 Reference1 正しいMD5 Reference2 ダウンロードしたファイルのMD5 Reference3 タイプ (shell,ghost,balloon,headline,plugin,basewareのいずれか)
GET SHIORI/3.0
Sender: crow
ID: OnUpdate.OnMD5CompareComplete
Reference0: descript.txt
Reference1: 5cc07522bb987c722bbfc30ff9e832ac
Reference2: 5cc07522bb987c722bbfc30ff9e832ac
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]MD5一致。\e
MD5不一致
ダウンロードしたファイルのMD5が一致しなかった時に発生するイベントです。補足
Reference3はCROW / SSP 2.0以降の実装です。パラメータ
SSPで、ゴーストと同時にバルーンやシェルも更新する機能が有効の場合、ゴースト以外の更新時には、OnUpdateOther.OnMD5CompareFailureが発生します。
イベント名のみの変更で、他に違いはありません。
サンプル
Reference0 ファイル名 Reference1 正しいMD5 Reference2 ダウンロードしたファイルのMD5 Reference3 タイプ (shell,ghost,balloon,headline,plugin,basewareのいずれか)
GET SHIORI/3.0
Sender: crow
ID: OnUpdate.OnMD5CompareFailure
Reference0: readme.txt
Reference1: d83db404627e0a740d698d41f340a961
Reference2: 2d6f4e7a19a3e243daa6a623adef8390
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]MD5が一致しませんでした。\e
ネットワーク更新開始
ネットワーク更新が指示された直後に発生するイベントです。補足
この後、更新情報の取得を行います。
Reference3はCROW / SSP 2.0以降の実装です。パラメータ
Reference0,1はSSP 2.0以降の実装です。
SSPで、ゴーストと同時にバルーンやシェルも更新する機能が有効の場合、ゴースト以外の更新時には、OnUpdateOtherBeginが発生します。
イベント名のみの変更で、他に違いはありません。
サンプル
Reference0 名前(descriptのnameエントリ) Reference1 更新対象のディレクトリへのパス Reference3 タイプ (shell,ghost,balloon,headline,plugin,basewareのいずれか)
GET SHIORI/3.0
Sender: crow
ID: OnUpdateBegin
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]ネットワーク更新開始。\e
ネットワーク更新完了
ネットワーク更新で、すべてのファイルをダウンしインストールが完了された後に呼び出されるイベントです。補足
何らかの理由で失敗した場合は、このイベントは呼ばれず、OnUpdateFailureが呼ばれます。
更新するファイルがなかった場合は、Reference0にnoneが返ります。
Materia仕様書にはnoneのみ規定されているので、もし更新の有無で喋り内容を変えたい場合は、Reference0がnoneかnoneでないかを判別するように処理することをおすすめします。パラメータ
Reference3はCROW / SSP 2.0以降の実装です。
SSPで、ゴーストと同時にバルーンやシェルも更新する機能が有効の場合、ゴースト以外の更新時には、OnUpdateOtherCompleteが発生します。
イベント名のみの変更で、他に違いはありません。
サンプル
Reference0 状態(changed/none) Reference1 カンマで区切られた更新ファイル名のリスト Reference3 タイプ (shell,ghost,balloon,headline,plugin,basewareのいずれか)
更新ファイルがなかった場合
GET SHIORI/3.0
Sender: crow
ID: OnUpdateComplete
Reference0: none
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]更新ファイルなし。\e
更新を行った場合
GET SHIORI/3.0
Sender: crow
ID: OnUpdateComplete
Reference0: changed
Reference1: ghost/master/descript.txt,shell/master/surfaces.txt
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]ネットワーク更新完了。
ネットワーク更新失敗
何らかの理由でネットワーク更新が失敗した場合に発生するイベントです。補足
このイベントが発生した場合、Reference0にそのエラーの内容が入ります。
現在起こるエラーは
404 そのステータスコードで失敗。404以外の数値もあり。
timeout 転送タイムアウト
md5 miss MD5不一致
too slow 転送タイムアウト(MATERIA)
artificial バルーンダブルクリックでの手動中断
fileio ディスク容量不足等ファイルの書き込みに失敗(SSP)
readonly ゴーストディレクトリが書き込み禁止のため更新できない(SSP)
です。
MATERIAでは、このイベントが2回発生することがあるようです。パラメータ
その場合、2度目のReference0には200という値が入ることがあります。
Reference1はSSP 2.01.86以降の実装です。
Reference3はCROW / SSP 2.0以降の実装です。
SSPで、ゴーストと同時にバルーンやシェルも更新する機能が有効の場合、ゴースト以外の更新時には、OnUpdateOtherFailureが発生します。
イベント名のみの変更で、他に違いはありません。
サンプル
Reference0 エラー内容(timeout/md5 miss/404等) Reference1 エラーになったファイル名 ファイルが関係ない場合は空 Reference3 タイプ (shell,ghost,balloon,headline,plugin,basewareのいずれか)
GET SHIORI/3.0
Sender: crow
ID: OnUpdateFailure
Reference0: md5 miss
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]md5が一致せず、更新失敗しました。\e
ネットワーク更新準備完了
ネットワーク更新を開始し、実際に更新するファイルがあった場合に発生するイベントです。補足
更新するファイルがなかった場合はこのイベントは発生せず、OnUpdateCompleteが発生します。
Reference1はSSPのみの実装です。パラメータ
Reference3はCROW / SSP 2.0以降の実装です。
SSPで、ゴーストと同時にバルーンやシェルも更新する機能が有効の場合、ゴースト以外の更新時には、OnUpdateOtherReadyが発生します。
イベント名のみの変更で、他に違いはありません。
サンプル
Reference0 更新を行うファイルの数-1 Reference1 カンマで区切られた更新予定ファイルのリスト Reference3 タイプ (shell,ghost,balloon,headline,plugin,basewareのいずれか)
GET SHIORI/3.0
Sender: crow
ID: OnUpdateReady
Reference0: 1
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]更新ファイルが2つあります。\e
ヘッドラインセンス結果の読み上げ
ヘッドラインセンスにより情報が収拾・分析され、その結果が更新されていた場合、このイベントが発生します。補足
Reference2 にセットされるデータ(OnFind フェーズ)は、
「First」: 1ページ目(次ページが存在する)
「First and Last」:1ページ目(次ページは無く、この1ページのみの場合)
「Last」: 最終ページ
「Next」: 上記3項目に該当しないページ
となる。
また、このイベントが発生した後、空の識別子を選択(例「 \q[次のページへ,] 」)を指示すると、改ページが指定したものとみなされ、次ページのヘッドラインデータをもった「OnHeadlinesense.OnFind」イベントが発生する。
ヘッドラインデータは、さくらスクリプト形式であるが、MATERIA Phase583においては、パラメータ
データ中に「\-」(終了指示タグ)などが含まれてる事がある(データの抽出での問題)ため、そのままValueとして返すと、問題が発生する場合がある。
そのため、特に制御を意図するタグとして解釈・誤動作しないように整形する処理を施す必要がある。
サンプル
Reference0 対象サイト名 Reference1 対象URL Reference2 OnFind フェーズ Reference3 ヘッドラインデータ本体(さくらスクリプト断片)
GET SHIORI/3.0
Sender: crow
ID: OnHeadlinesense.OnFind
Reference0: CROW
Reference1: http://crow.aqrs.jp/
Reference2: First
Reference3: V0.4.0公開。\nリンクページ更新。\n
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]\b[2]CROW ヘッドライン。\nV0.4.0公開。\nリンクページ更新。\n\n\q[続きを読む,]\n\q[サイトを開く,http://crow.aqrs.jp/]\n\q[やめる,読み上げ中止]\e
ヘッドラインセンス開始
ヘッドラインセンスが指示された直後に発生するイベントです。補足
この後、サイト情報の取得・分析を行います。
MATERIAの場合、このイベントは、ゴーストの起動時にも呼ばれ、その時点で「200 OK」としてValue(内容は問わない)を返さないと、このゴーストにおいてヘッドラインセンス機能は使用不能と判断し、メニューから選択できなくなり、また、自動チェックも行われません。パラメータ
サンプル
Reference0 対象サイト名 Reference1 対象URL
GET SHIORI/3.0
Sender: crow
ID: OnHeadlinesenseBegin
Reference0: CROW
Reference1: http://crow.aqrs.jp/
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]「CROW」のヘッドラインを取得中します。\e
ヘッドラインセンス成功(更新無し)
ヘッドラインセンスは正常終了したが、更新が無かった場合に発生する。パラメータ
そのため、Reference0 は、必ず「no update」(更新無し)がセットされる。
サンプル
Reference0 成功事由 ( 「no update」固定)
GET SHIORI/3.0
Sender: crow
ID: OnHeadlinesenseComplete
Reference0: no update
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]更新なし。\e
ヘッドラインセンス失敗
何らかの理由でヘッドラインセンスが失敗した場合に発生するイベントです。パラメータ
このイベントが発生した場合、Reference0にそのエラーの内容が入ります。
現在起こるエラーは
can't download : ファイルが取れなかった
can't analyze : 有効なヘッドライン情報を解析・取得できなかった
の2つです。
サンプル
Reference0 失敗事由 (説明参照)
GET SHIORI/3.0
Sender: crow
ID: OnHeadlinesenseFailure
Reference0: can't download
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]ヘッドラインをダウンロードできませんでした。\e
GET SHIORI/3.0
Sender: crow
ID: OnHeadlinesenseFailure
Reference0: can't analyze
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]解析できませんでした。\e
マウスクリック
マウスがクリックされた時に発生するイベントです。補足
SHIORI/3.0仕様より Reference5 が加わり、右クリックを行なった場合もこのイベントが発生します。パラメータ
なお、右クリックでイベントが発生した時に、エラーで返さない(「200 OK」とし、Valueを返した)場合、メニュー表示(及びその動作に起因するイベント)が発生しません。
サンプル
Reference0 マウスカーソルの x 座標(ローカル座標) Reference1 マウスカーソルの y 座標(ローカル座標) Reference2 常に0 Reference3 スコープ番号 Reference4 当たり判定識別子 Reference5 クリックされたボタン(0またはなし:左 / 1:右 / 2:中(Windowsやマウス依存))
判定のない場所を右クリックした例
GET SHIORI/3.0
Sender: crow
ID: OnMouseClick
Reference0: 79
Reference1: 305
Reference2: 0
Reference3: 0
Reference5: 1
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 204 No Content
頭の部分を左クリックした例
GET SHIORI/3.0
Sender: crow
ID: OnMouseClick
Reference0: 116
Reference1: 71
Reference2: 0
Reference3: 0
Reference4: Head
Reference5: 0
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 204 No Content
マウス左ボタンダブルクリック
マウスの左ボタンをダブルクリックした時に発生するイベントです。補足
Reference5が来ない場合も考慮して処理してください。パラメータ
サンプル
Reference0 マウスカーソルの x 座標(ローカル座標) Reference1 マウスカーソルの y 座標(ローカル座標) Reference2 常に0 Reference3 スコープ番号 Reference4 当たり判定識別子 Reference5 クリックされたボタン(0またはなし:左 / 1:右 / 2:中(Windowsやマウス依存))
GET SHIORI/3.0
Sender: crow
ID: OnMouseDoubleClick
Reference0: 91
Reference1: 58
Reference2: 0
Reference3: 0
Reference4: Head
Reference5: 0
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]頭をダブルクリックされました。\e
マウス移動
サーフィス上で、マウスが移動した時に発生するイベントです。パラメータ
サンプル
Reference0 マウスカーソルの x 座標(ローカル座標) Reference1 マウスカーソルの y 座標(ローカル座標) Reference2 常に0 Reference3 スコープ番号 Reference4 当たり判定識別子
GET SHIORI/3.0
Sender: crow
ID: OnMouseMove
Reference0: 107
Reference1: 61
Reference2: 0
Reference3: 0
Reference4: Head
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 204 No Content
マウスホイール回転
マウスのホイールが回転した時に発生するイベントです。補足
あくまでも参考程度ですが、現在のところ、回転量は1ノッチ(1回かちんと動く量)あたり+-120を示します。ノッチがないマウス等では変わってきます。パラメータ
サンプル
Reference0 マウスカーソルの x 座標(ローカル座標) Reference1 マウスカーソルの y 座標(ローカル座標) Reference2 マウスホイールの回転量および回転方向 (上が+、下が−) Reference3 スコープ番号 Reference4 当たり判定識別子
GET SHIORI/3.0
Sender: crow
ID: OnMouseWheel
Reference0: 76
Reference1: 199
Reference2: 120
Reference3: 0
Reference4: Face
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 204 No Content
メールチェック開始
メールチェックイベントが指示された直後に発生するイベントです。補足
この後、メールサーバから情報の取得を行います。
MATERIAの場合、このイベントは、ゴーストの起動時にも呼ばれ、その時点で「200 OK」としてValue(内容は問わない)を返さないと、このゴーストにおいてメールチェック機能は使用不能と判断し、メニューから選択できなくなり、また、自動でのメールチェックも行われません。パラメータ
(但し、MATERIA 583 においては、このチェックリクエストは発生していません)
サンプル
Reference2 チェックするサーバ名(SSP,CROWでは、アカウント名)
GET SHIORI/3.0
Sender: crow
ID: OnBIFFBegin
Reference2: mail1
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]メールチェック開始。\e
メールチェック成功
メールチェックが成功した時に、呼び出されるイベントです。補足
Reference4 は、個々のメールのヘッダ部分が、改行をバイト値 1、メールの区切りをバイト値2で区切った形式で送られてきます。
Reference5 は、個々のメールのサイズが、「(メールの通数目) (サイズ)」をバイト値1で区切った形式で送られてきます。
Reference6 は、個々のメールのuidl(個々のメールを識別するID)が、バイト値1で区切った形式で送られてきます。
[SSP拡張]
Reference7に、個々のメールの概要が、バイト値1で区切った形式で送られてきます。
今のところ送信者とタイトルをつなげたものですが、今後変更される、またユーザーの設定で変更できるようにする可能性があります。
MATERIA Phase583では、Reference3・5・6は送られてきません。パラメータ
SSPでは、Reference4のヘッダ情報は、「Message-ID:」「From:」「Subject:」「Date:」「X-Priority:」「X-MSMail-Priority:」「X-Mailer:」「X-MimeOLE:」のみが送られてきます。
また、Reference3ですが、メールをuidl等から判別し、増加した数のみを通知します。
また、本体側の設定により、Reference4〜7は送られてこない場合があります。
サンプル
Reference0 スプールされているメールの通数 Reference1 スプールされているメールのバイト数 Reference2 チェックするサーバ名(SSP,CROWでは、アカウント名) Reference3 前回チェック時より増加したメールの通数(SSPのみ) Reference4 個々のメールのヘッダー部分 Reference5 個々のメールのサイズ Reference6 個々のメールのuidl Reference7 [SSP]個々のメールの概要
GET SHIORI/3.0
Sender: crow
ID: OnBIFFComplete
Reference0: 1
Reference1: 1004
Reference2: mail1
Reference3: 1
Reference4: Return-Path:Received: from xxx.xxxx.ne.jp ([xxx.xxx.xxx.xxx]) by xxx.xxx.ne.jp (post.office MTA v1.9.3 ID# 0100110-37427) with ESMTP id AAA1696 for ; Sat, 5 Apr 2003 22:03:51 +0900Received: from xxx.xxx.ne.jp (xxx.xxx.ne.jp [xxx.xxx.xxx.xxx]) by xxxx.xxxx.ne.jp (8.11.4/8.11.4) with ESMTP id h35D1BE14824 for ; Sat, 5 Apr 2003 22:01:11 +0900 (JST) (envelope-from xxxx@xxxx.jp)Received: from [xxx.xxx.xxx.xxx] (xxxx.xxxx.ne.jp [xxx.xxx.xxx.xxx]) by xxxx.xxxx.ne.jp (8.9.3/8.9.3) with ESMTP id WAA20388 for ; Sat, 5 Apr 2003 22:03:42 +0900Date: Sat, 05 Apr 2003 22:03:51 +0900From: xxxx@xxxx.jpTo: xxxx@xxxx.jpSubject: testmailMessage-Id: <20030405220343.5FE8.xxxx@xxxx.jp>MIME-Version: 1.0Content-Type: text/plain; charset="US-ASCII"Content-Transfer-Encoding: 7bitX-Mailer: Becky! ver. 2.05.10
Reference5: 1 1004
Reference6: 1 20030405130351851.AAA1696@xxxx.xxxx.ne.jp
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]メール1通届いています。\e
メールチェック失敗
何らかの理由でメールチェックが失敗した場合に発生するイベントです。パラメータ
このイベントが発生した場合、Reference0にそのエラーの内容が入ります。
現在起こるエラーは
timeout:メールサーバから一定時間応答がない
kick :メールサーバで認証に失敗した
defect :本体でのメール設定の情報が不足している
です。
サンプル
Reference0 エラー内容(timeout/kick/defect) Reference2 チェックするサーバ名(SSP,CROWでは、アカウント名)
GET SHIORI/3.0
Sender: crow
ID: OnBIFFFailure
Reference0: defect
Reference2: mail1
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]メールチェックに失敗しました。\e
分変化
現在時刻の分の単位が変更された時に呼ばれるイベントです。パラメータ
サンプル
Reference0 連続起動時間(単位:時間) Reference1 見切れフラグ(1-見切れ中、0-通常) Reference2 重なりフラグ(1-重なり中、0-通常) Reference3 cantalkフラグ(1-実際に再生される、0-再生されない)
GET SHIORI/3.0
Sender: crow
ID: OnMinuteChange
Reference0: 3
Reference1: 0
Reference2: 0
Reference3: 1
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 204 No Content
秒変化
現在時刻の秒の単位が変更された時に呼ばれるイベントです。パラメータ
サンプル
Reference0 連続起動時間(単位:時間) Reference1 見切れフラグ(1-見切れ中、0-通常) Reference2 重なりフラグ(1-重なり中、0-通常) Reference3 cantalkフラグ(1-実際に再生される、0-再生されない) Reference4 マウス・キーボード等が何も操作されなかった秒数(SSPのみ)
GET SHIORI/3.0
Sender: crow
ID: OnSecondChange
Reference0: 2
Reference1: 0
Reference2: 0
Reference3: 1
Reference4: 12
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 204 No Content
時計合わせ開始
時計合わせイベントが指示された直後に発生するイベントです。補足
この後、SNTPサーバから情報の取得を行います。
MATERIAの場合、このイベントは、ゴーストの起動時にも呼ばれ、その時点で「200 OK」としてValue(内容は問わない)を返さないと、このゴーストにおいて時計合わせ機能は使用不能と判断し、メニューから選択できなくなります。パラメータ
(但し、MATERIA 583 においては、このチェックリクエストは発生していません)
サンプル
Reference0 接続先のSNTPサーバ
GET SHIORI/3.0
Sender: crow
ID: OnSNTPBegin
Reference0: time-nw.nist.gov
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]時計あわせ開始。\e
時計合わせ情報取得
SNTPサーバより情報の取得に成功した時に、呼び出されるイベントです。補足
Reference1,2 には、それぞれSNTPサーバとローカルマシンの時刻が、次の順番に、半角カンマで区切られて代入されます。
(年),(月),(日),(時),(分),(秒),
SSPでは、代入される時刻に、ミリ秒単位の項目が追加されて、パラメータ
(年),(月),(日),(時),(分),(秒),(ミリ秒)
…と送られてきます。
サンプル
Reference0 接続先のSNTPサーバ名 Reference1 カンマでセパレートされた正確な(SNTP サーバ側の)時刻 Reference2 カンマでセパレートされた現在の(自分のマシン側の)時刻 Reference3 SNTPサーバと自分のマシンとの時刻のずれ(秒,常に正)
GET SHIORI/3.0
Sender: crow
ID: OnSNTPCompare
Reference0: time-nw.nist.gov
Reference1: 2003,3,11,20,40,19,
Reference2: 2003,3,11,20,40,19,
Reference3: 0
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]ぴったり合っています。\e
消滅指示後のキャンセル
「OnVanishSelected」イベントにより本体へ送られたさくらスクリプトを再生中に、バルーンをダブルクリックすると、消滅指示をキャンセルした(引きとめられた)ものとみなし、このイベントが発生します。補足
「OnVanishSelecting」イベント中に、本体をダブルクリックした際にも発生し、そのときはこのイベントと同時に消滅確認ダイアログが表示されます。パラメータ
ここで「はい」を選ぶと「OnVanishSelected」イベントが発生し、その最中に本体をダブルクリックすると「OnMouseDoubleClick」が発生し消滅は取り消されます。
Reference0,1の送信はSSP 1.11系からです。
サンプル
Reference0 中断されたスクリプト(存在すれば) Reference1 どちら側のバルーンから中断操作が行われたか (\0 = 0 \1 = 1 \p[2] = 2 ...)
GET SHIORI/3.0
Sender: crow
ID: OnVanishButtonHold
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]消滅指示が、ダブルクリックにより中断されました。\e
消滅指示取り消し
「OnVanishSelecting」イベントで表示された指示確認のダイアログボックスで「指示を取り消す」旨の選択が行なわれた時に発生します。サンプル
GET SHIORI/3.0
Sender: crow
ID: OnVanishCancel
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]消滅指示が取り消されました。\e
ゴースト切り替え(前ゴースト消滅時)
前のゴーストが、消滅指示イベント(または「 \![vanishbymyself] 」タグ実行)によって消滅した後に、自分に切り替えられ、切り替え処理が完了後、「OnGhostChanged」の代わりに一番最初に呼ばれるイベントです。補足
このイベントに返答しない(204またはエラーを返した)場合、「OnGhostChanged」が発生します。 また、MATERIA Phase583 では、Reference0 は空データが送られてきます。 Reference1,2,7はSSP(1.10以降)でのみ利用できます。パラメータ
Reference0 消されたゴーストの\0名(sakuraname) Reference1 消されたゴーストのOnVanishSelectedイベントで喋ったスクリプト [SSP] Reference2 消されたゴーストのフル名称(name) [SSP] Reference7 シェルの名前 [SSP]
消滅指示実行
「OnVanishSelecting」イベントで表示された指示確認のダイアログボックスで「消滅」する旨の選択が行なわれた時に発生します。補足
このイベントで本体に返したスクリプトを実行し終えた瞬間に、消滅処理が行なわれ、既にインストールされているゴーストに切り替わります。
MATERIAにおいては「デフォルトであるさくらは消滅出来ない(指示しても拒否する)」つまり「必ず切り替わる相手(さくら)がいる」ため、必ず消滅処理は行なわれます。(仮に「first」フォルダをあらかじめ削除し、1体しかインストールされていない状況でも、データは削除されてしまう)サンプル
GET SHIORI/3.0
Sender: crow
ID: OnVanishSelected
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]消滅指示を実行します。
消滅が指示された
ポップアップメニュー等から「消滅指示」が指示された直後に発生するイベントです。補足
この後「消滅を実行しますか?」と確認のダイアログ・ボックスが出ます。
さくらスクリプト/2.0 の「 \![vanishbymyself] 」タグ実行時には、このイベントは発生せず、その瞬間に消滅処理が実行されます。サンプル
GET SHIORI/3.0
Sender: crow
ID: OnVanishSelecting
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]消滅指示を実行しますか?\e
実行環境のバージョン通知
今現在ゴーストを実行中の環境のバージョンを通知します。補足
例:
Reference0: 0.4.11
Reference1: CROW
Reference0: 1.10.17[B]
Reference1: SSP
Reference2: 1.10.17.3001
SHIORI読み込み後に、その他の情報通知イベントと共に常時通知されます。パラメータ
Reference0 バージョン情報 Reference1 本体識別文字列 (SSP・CROWなど) Reference2 数値のみ4ブロックのバージョン情報 (SSPのみ)
インストールされているゴーストの名前を通知
現在インストールされている、全ゴーストの名前を通知します。補足
この「全ゴースト」には自分自身も含みます。
Reference0, 1, 2, ...にゴーストの名前が一体ずつ入ります。パラメータ
Referenceの最大数は不定です。
通知されるのはsakura側キャラクターの名前ではなく、
ゴーストそのものの名前であることに注意してください。
サンプル
Reference0 (補足参照)
NOTIFY SHIORI/3.0
Charset: Shift_JIS
ID: installedghostname
Reference0: さくら
Reference1: つぐな・ツインルーク
Reference2: デベロッパーゴースト
Reference3: Alice in desktopland.
Reference4: まゆら&黒うにゅう
Reference5: Emily/Phase4
Reference6: リリス&ヌー
SecurityLevel: local
Sender: crow
SHIORI/3.0 204 No Content
Charset: Shift_JIS
Sender: リリス
ゴースト自身の情報通知
ゴーストが起動した際に、そのゴースト自身の情報がまとめて通知されます。補足
このイベントはNotifyイベントです。 スクリプトを返しても再生されません。 Reference5、Reference6はSSP 1.10.04以降での追加です。パラメータ
Reference0 ゴースト名 Reference1 Sakura名 Reference2 Kero名 Reference3 起動時のシェル名 Reference4 起動時のシェルのパス (例: shell/master/) 絶対パスか相対パスかは処理系依存 Reference5 起動時のバルーン名 Reference6 起動時のバルーンのパス (例: balloon/master/) 絶対パスか相対パスかは処理系依存
同時起動しているゴーストの名前を通知
他に同時起動しているゴーストそれぞれについて、補足
sakura側キャラクタの名前と、現在のサーフェス番号を通知します。
(同時起動しているゴーストがいなくても通知自体は行われます)
Reference0以降には以下のフォーマットで情報が入ります。パラメータ
なお、[1]はバイト値1です。
sakura側の名前[1]sakura側のサーフェス番号[1]kero側のサーフェス番号
CROWには、自分自身を「他に同時起動しているゴースト」に含めて
通知してくるバグがあります。(ver0.5.2で確認)
サンプル
Reference0 (補足参照)
NOTIFY SHIORI/3.0
Charset: Shift_JIS
ID: otherghostname
Reference0: マッキー010
Reference1: つぐな010
SecurityLevel: local
Sender: SSP
SHIORI/3.0 204 No Content
Charset: Shift_JIS
Sender: リリス
(CROW ver0.5.2の場合)
NOTIFY SHIORI/3.0
Charset: Shift_JIS
ID: otherghostname
Reference0: マッキー010
Reference1: つぐな010
Reference2: リリス010
SecurityLevel: local
Sender: crow
SHIORI/3.0 204 No Content
Charset: Shift_JIS
Sender: リリス
現在のゴースト名を通知
現在のゴースト、つまり自分自身の名前を通知します。パラメータ
サンプル
Reference0 sakura側キャラクターの名前
NOTIFY SHIORI/3.0
Charset: Shift_JIS
ID: ownerghostname
Reference0: リリス
SecurityLevel: local
Sender: crow
SHIORI/3.0 204 No Content
Charset: Shift_JIS
Sender: リリス
通常起動
本体起動時に発生するイベントです。補足
インストール後初めての起動の場合は、このイベントは呼ばれず、OnFirstBootが発生します。パラメータ
Reference6,7はMATERIA,SSPのみのサポートとなります。
また、異常終了時は常に通知されるとは限りません。
Reference7は\0側名、descript.txtのsakuranameエントリが入ります。
※SSPの1.09.17以前では実装ミスによりnameエントリが入っています。
サンプル
Reference0 起動時のシェルの名称 Reference6 前回の起動時に異常終了した際に"halt"が入る Reference7 前回の起動時に異常終了した際に、その時起動していたゴーストの\0名(sakuraname)が入る
GET SHIORI/3.0
Sender: crow
ID: OnBoot
Reference0: 50%シェル
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]起動\e
終了指示
本体終了が指示された時に発生するイベントです。補足
通常は、本体終了タグ(\-)を含んだ応答を返す必要があります。
本体終了タグが含まれていないと、終了しません。
Reference0はSSP 2.01.69からの実装です。パラメータ
サンプル
Reference0 終了理由 (user = ユーザー操作 shutdown = Windowsシャットダウン)
GET SHIORI/3.0
Sender: crow
ID: OnClose
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]終了\-\e
初回起動
ゴーストインストール後の一番最初の起動において、補足
OnBootや、OnGhostChangedイベントの替わりにに呼び出されるイベントです。
そのゴーストが、今までに消滅指示を受けたことがあれば、パラメータ
その通産回数がReference0に入ります。
その本体で、最初の起動ならばReference0は0が入ります。
サンプル
Reference0 そのゴーストが Vanish された通算回数 Reference7 起動時のシェルの名称
GET SHIORI/3.0
Sender: crow
ID: OnFirsBoot
Reference0: 0
Reference7: master
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]初回起動\e
最小化
アイコン化を選んだときに発生するイベントです。サンプル
サイレントイベントのため、応答があっても無視されます。
GET SHIORI/3.0
Sender: crow
ID: OnWindowStateMinimize
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 204 No Content
Charset: Shift_JIS
最小化復帰
アイコン化解除が指示された時に発生するイベントです。補足
実際にアイコン化解除処理が行われたあとに、この応答が処理されます。
このイベントが応答を返さないと、何も表示されない状態になります。サンプル
必ず、サーフィスを表示するタグを応答に含めてください。
なお、CROWでは問題ありません。
GET SHIORI/3.0
Sender: crow
ID: OnWindowStateRestore
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]\1\s[10]\e
ゴースト切り替え完了
ゴースト切り替え完了後に、最初に呼ばれるイベントです。補足
切り替えた先のゴーストがインストール後初の呼び出しだった場合、パラメータ
このイベントは発生せず、OnFirstBootが発生します。
Reference2はSSP,CROWの時のみ通知されます。
Reference7はSSPのみ通知されます。
サンプル
Reference0 直前のゴーストの\0側の名前 Reference1 直前のゴーストの最後のスクリプト Reference2 直前のゴーストのフルネーム(nameエントリ) [SSP/CROW] Reference7 シェルの名前 [SSP]
GET SHIORI/3.0
Sender: crow
ID: OnGhostChanged
Reference0: さくら
Reference1: \0\s[0]次のゴーストに変わります。\e
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]切り替わりました。\e
ゴースト切り替え指示
別のゴーストへの切り替えが指示された時に発生するイベントです。補足
自分自身へ切り替えたときにも発生します。
メニューから切り替えた際にはReference1にはmanualが入ります。パラメータ
本体に自動切換えの設定を行い、自動で切り替わった場合Reference1にはautomaticが入ります。
SSP,CROWの場合のみReference2が通知されます。
サンプル
Reference0 次のゴーストの\0側の名前 Reference1 切り替えメソッド(manual/automatic) Reference2 次のゴーストのフルネーム(nameエントリ) [SSP/CROW] Reference3 次のゴーストがインストールされているファイルパス [SSP]
手動切り替え時
GET SHIORI/3.0
Sender: crow
ID: OnGhostChanging
Reference0: さくら
Reference1: manual
Reference2: .さくら
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]次のゴーストに変わります。\e
自動切換え時
GET SHIORI/3.0
Sender: crow
ID: OnGhostChanging
Reference0: さくら
Reference1: automatic
Reference2: .さくら
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 204 No Content
シェル切り替え完了
別のシェルへの切り替えが指示された時に発生するイベントです。補足
今までと同じシェルへ切り替えたときにも発生します。
Reference1に入る内容は、Reference0と同一です。パラメータ
Reference2の情報は、CROWとSSPのみです。Materiaでは通知されません。
サンプル
Reference0 選択されたシェルの名称 Reference1 選択されたシェルの名称 Reference2 選択されたシェルのパス (例:shell/master/)
GET SHIORI/3.0
Sender: crow
ID: OnShellChanged
Reference0: 50%シェル
Reference1: 50%シェル
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]シェル変更を行います。\e
シェル切り替え指示
別のシェルへの切り替えが指示された時に発生するイベントです。補足
シェルインストールにより切り替わった場合は、このイベントは発生しません。 Reference2の情報は、CROWとSSPのみです。Materiaでは通知されません。パラメータ
サンプル
Reference0 選択されたシェルの名称 Reference2 選択されたシェルのパス (例:shell/master/)
GET SHIORI/3.0 Sender: crow ID: OnShellChanging Reference0: 50%シェル SecurityLevel: local Charset: Shift_JIS SHIORI/3.0 200 OK Value: \0\s[0]シェル切り替えを行います。\e
アンカークリック
アンカーをクリックしたときに発生するイベントです。補足
アンカーがクリックされても、このイベントに応答を返さなければバルーンは閉じず、パラメータ
そのままの状態を維持します。
サンプル
Reference0 選択されたアンカーが持つ識別子
GET SHIORI/3.0
Sender: crow
ID: OnAnchorSelect
Reference0: anchor1
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\\s[0]アンカー1が選ばれました。\e
選択肢フォーカス変化
アンカー以外の選択肢の上にカーソルが乗った瞬間および外れた瞬間に発生するイベントです。補足
外れた際はReference0とReference1には空文字列が入ります。
サイレントイベントのため、応答があっても無視されます。
選択肢を決定する直前にも発生します。パラメータ
その場合、応答はReference0のみで空文字列が入ります。
サンプル
Reference0 選択肢のタイトル Reference1 ジャンプラベル Reference2 以下拡張情報
(選択肢にフォーカスが移った場合)
GET SHIORI/3.0
Sender: embryo
ID: OnChoiceEnter
Reference0: 選択肢1
Reference1: sel1
Reference2: expanddata
Reference3:
Reference4:
Reference5:
Reference6:
Reference7:
Reference8:
Reference9:
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 204 No Content
(選択肢からフォーカスが離れた場合)
GET SHIORI/3.0
Sender: crow
ID: OnChoiceEnter
Reference0:
Reference1:
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 204 No Content
(決定する直前のイベント)
GET SHIORI/3.0
Sender: crow
ID: OnChoiceEnter
Reference0:
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 204 No Content
選択肢クリック
選択肢をクリックした時に発生するイベントです。パラメータ
サンプル
Reference0 選択された選択肢が持つ識別子
GET SHIORI/3.0
Sender: crow
ID: OnChoiceSelect
Reference0: select1
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]選択肢がクリックされました。\e
選択肢タイムアウト
選択肢がタイムアウトしたときに発生するイベントです。補足
Reference0には、この選択肢を出したスクリプトが入ります。
[MATERIA] タイムアウト時間はは約15秒です。パラメータ
[SSP] タイムアウト時間はユーザ側で設定できます。
サンプル
Reference0 この選択肢を出したスクリプト
GET SHIORI/3.0
Sender: crow
ID: OnChoiceTimeout
Reference0: \0\s[0]\q[選択肢1,sel1,expand]\q[選択肢2,sel2]\e
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]選択肢がタイムアウトしました。\e
コミュニケート
外部から話し掛けられた瞬間に発生するイベントです。パラメータ
ユーザから話し掛けられた場合、Reference0はuserという文字列が入り、
ゴーストから話し掛けられた場合は、そのゴーストの名前が入ります。
サンプル
Reference0 送り元の名前(user/ゴースト名) Reference1 スクリプト Reference2 以下拡張情報
GET SHIORI/3.0
Sender: crow
ID: OnCommunicate
Reference0: さくら
Reference1: \0\s[0]こんにちは。\e
Reference2: 0,10
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]こんにちは、さくらさん。\e
TeachBoxオープン
TeachBoxがオープンした際に発生するイベントです。サンプル
GET SHIORI/3.0
Sender: crow
ID: OnTeachStart
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 204 No Content
Charset: Shift_JIS
InputBoxクローズ
InputBoxが閉じた際に発生するイベントです。補足
ユーザーが値を入力してリターンを押した場合と、タイムアウトした場合があります。
タイムアウトした場合は、入力値の代わりにtimeoutという文字列が返ります。
InputBoxを閉じた際には必ずこのイベントが発生するとは限りません。パラメータ
InputBoxを開くタグの第3引数の頭にOnがついていない場合のみこのイベントが発生します。
第3引数の頭にOnがついていると、このイベントは発生せず、第3引数で指定したイベントが発生します。その際にはReference0で入力した文字列もしくはtimeoutが渡されます。
サンプル
Reference0 \![open,inputbox]で指定した識別子 Reference1 入力した文字列か、timeout
入力が決定した場合
GET SHIORI/3.0
Sender: crow
ID: OnUserInput
Reference0: ユーザー
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]ユーザー入力を受け付けました。\e
入力がタイムアウトした場合
GET SHIORI/3.0
Sender: crow
ID: OnUserInput
Reference0: timeout
SecurityLevel: local
Charset: Shift_JIS
SHIORI/3.0 200 OK
Value: \0\s[0]ユーザー入力がタイムアウトしました。\e