ShioriEventReference?

CROWSSPmateriaShioriEventIDSummary
SSP拡張イベント
icon_s.pngOnAITalk\aなどによる会話が求められた際に発生。
icon_s.pngOnBalloonBreakSSTP以外でブレイクされた際に発生。
icon_s.pngOnBalloonChangeバルーン切替
icon_s.pngOnBalloonCloseバルーンがタイムアウトせずに閉じられた
icon_s.pngOnBalloonTimeout選択肢以外でバルーンがタイムアウトした際に発生。
icon_s.pngOnBatteryCriticalバッテリ残量が非常に少なくなった際に発生。
icon_s.pngOnBatteryLowバッテリ残量が少なくなった際に発生。
icon_s.pngOnBatteryNotifyバッテリ状態の通知
icon_s.pngOnCacheRestoreゴーストキャッシュから出た際に発生。
icon_s.pngOnCacheSuspendゴーストキャッシュに入った際に発生。
icon_s.pngOnDestroyゴースト終了
icon_s.pngOnDressupChanged着せ替え変更通知
icon_s.pngOnEmbryoExistSSP起動時、先にmateria.exeが起動されていた際に発生。
icon_s.pngOnExecuteHTTPComplete\![execute,http-get / post]でasyncオプションを指定して成功した際に発生。
icon_s.pngOnExecuteHTTPFailure\![execute,http-get / post]でasyncオプションを指定して失敗した際に発生。
icon_s.pngOnInitializeゴースト起動
icon_s.pngOnNekodorifExistSSP起動時、先に猫どりふが起動されていた際に発生。
icon_s.pngOnNetworkStatusChangeネットワーク接続状態の変化通知
icon_s.pngOnNotifyOtherFailure\![notifyother]での失敗通知
icon_s.pngOnNotifyPluginFailure\![notifyplugin]での失敗通知
icon_s.pngOnOtherGhostTalk他ゴーストのトーク通知
icon_s.pngOnRaiseOtherFailure\![raiseother]での失敗通知
icon_s.pngOnRaisePluginFailure\![raiseplugin]での失敗通知
icon_s.pngOnScreenSaverEndスクリーンセーバーが終了した際に発生。
icon_s.pngOnScreenSaverStartスクリーンセーバーが起動した際に発生。
icon_s.pngOnSoundStopサウンドが終了した際に発生。
icon_s.pngOnSysResumeスタンバイ状態からの回復
icon_s.pngOnSysSuspendスタンバイ状態へ
icon_s.pngOnTeachTeachBox?からの入力があった際に発生。
icon_s.pngOnTrayBalloonClick通知領域バルーンがクリックされた
icon_s.pngOnTrayBalloonTimeout通知領域バルーンタイムアウト/閉じ
icon_s.pngOnURLQueryURL D&D時の通知
SSTPイベント
icon_s.pngicon_m.pngOnMusicPlay音楽演奏反応
その他のイベント
icon_c.pngicon_s.pngicon_m.pngOnNetworkHeavyサーバの応答無し
icon_c.pngicon_s.pngicon_m.pngOnRecommendsiteChoiceおすすめメニューのサイトクリック
icon_m.pngOnSSTPBlacklistingSSTPの特定IPからの受信禁止処理
icon_s.pngicon_m.pngOnSSTPBreakSSTP受信中断
icon_c.pngicon_s.pngicon_m.pngOnTranslateトランスレートイベント
インストールイベント
icon_c.pngicon_s.pngicon_m.pngOnInstallBeginインストール開始
icon_c.pngicon_s.pngicon_m.pngOnInstallCompleteインストール完了
icon_s.pngOnInstallCompleteExインストール完了(拡張)
icon_c.pngicon_s.pngicon_m.pngOnInstallFailureインストール失敗
icon_c.pngicon_s.pngicon_m.pngOnInstallRefuseインストール拒否
キーボードイベント
icon_c.pngicon_s.pngicon_m.pngOnKeyPressキーを押した
サーフィスイベント
icon_c.pngicon_s.pngOnSurfaceChangeサーフィス変化
icon_c.pngicon_s.pngicon_m.pngOnSurfaceRestoreサーフィス復帰指示
ドロップイベント
icon_s.pngOnFileDropファイル・フォルダドロップ開始
icon_c.pngicon_s.pngicon_m.pngOnFileDrop2ファイル・フォルダドロップ開始
icon_s.pngOnFileDropExファイルドロップ開始
icon_s.pngOnFileDroppingファイルドロップ直前
icon_c.pngicon_s.pngicon_m.pngOnNarCreatedNARファイル作成完了
icon_c.pngicon_s.pngicon_m.pngOnNarCreatingNARファイル作成開始
icon_s.pngOnTextDropテキストデータのドロップ
icon_c.pngicon_s.pngicon_m.pngOnUpdatedataCreatedアップデート情報作成完成
icon_c.pngicon_s.pngicon_m.pngOnUpdatedataCreatingアップデート情報作成開始
icon_s.pngicon_m.pngOnURLDropFailureURLドロップ失敗
icon_s.pngicon_m.pngOnURLDroppedURLドロップ完了
icon_c.pngicon_s.pngicon_m.pngOnURLDroppingURLドロップ開始
icon_s.pngOnWallpaperChange壁紙設定
ネットワーク更新イベント
icon_c.pngicon_s.pngicon_m.pngOnUpdate.OnDownloadBeginファイルダウンロード開始
icon_c.pngicon_s.pngicon_m.pngOnUpdate.OnMD5CompareBeginMD5の照合開始
icon_c.pngicon_s.pngicon_m.pngOnUpdate.OnMD5CompareCompleteMD5一致
icon_c.pngicon_s.pngicon_m.pngOnUpdate.OnMD5CompareFailureMD5不一致
icon_c.pngicon_s.pngicon_m.pngOnUpdateBeginネットワーク更新開始
icon_s.pngOnUpdateCheckCompleteネットワーク更新チェック完了
icon_s.pngOnUpdateCheckFailureネットワーク更新チェック失敗
icon_c.pngicon_s.pngicon_m.pngOnUpdateCompleteネットワーク更新完了
icon_c.pngicon_s.pngicon_m.pngOnUpdateFailureネットワーク更新失敗
icon_c.pngicon_s.pngicon_m.pngOnUpdateReadyネットワーク更新準備完了
ヘッドラインセンスイベント
icon_c.pngicon_s.pngicon_m.pngOnHeadlinesense.OnFindヘッドラインセンス結果の読み上げ
icon_c.pngicon_s.pngicon_m.pngOnHeadlinesenseBeginヘッドラインセンス開始
icon_c.pngicon_s.pngicon_m.pngOnHeadlinesenseCompleteヘッドラインセンス成功(更新無し)
icon_c.pngicon_s.pngicon_m.pngOnHeadlinesenseFailureヘッドラインセンス失敗
icon_s.pngOnRSSCompleteRSS受信成功
マウスイベント
icon_c.pngicon_s.pngicon_m.pngOnMouseClickマウスクリック
icon_c.pngicon_s.pngicon_m.pngOnMouseDoubleClickマウス左ボタンダブルクリック
icon_s.pngOnMouseDragEndマウスドラッグ終了
icon_s.pngOnMouseDragStartマウスドラッグ開始
icon_s.pngOnMouseEnterマウスが当たり判定内に入った
icon_s.pngOnMouseEnterAllマウスがウインドウ内に入った
icon_s.pngOnMouseHoverマウスが「しばらく上で止まっている」
icon_s.pngOnMouseLeaveマウスが当たり判定外に出た
icon_s.pngOnMouseLeaveAllマウスがウインドウから出た
icon_c.pngicon_s.pngicon_m.pngOnMouseMoveマウス移動
icon_c.pngicon_s.pngicon_m.pngOnMouseWheelマウスホイール回転
メールチェックイベント
icon_m.pngOnBIFF2Complete新着メール通知
icon_c.pngicon_s.pngicon_m.pngOnBIFFBeginメールチェック開始
icon_c.pngicon_s.pngicon_m.pngOnBIFFCompleteメールチェック成功
icon_c.pngicon_s.pngicon_m.pngOnBIFFFailureメールチェック失敗
外部アプリ-きのこイベント
icon_s.pngicon_m.pngOnKinokoObjectChangedきのこスキンを切り替えた際に発生。
icon_s.pngicon_m.pngOnKinokoObjectChangingきのこスキンを切り替えようとしている際に発生。
icon_s.pngicon_m.pngOnKinokoObjectCreateきのこスキンが頭に生えた際に発生。
icon_s.pngicon_m.pngOnKinokoObjectDestroyきのこスキンが頭から消えた際に発生。Reference0
icon_s.pngicon_m.pngOnKinokoObjectInstalledきのこスキンをドロップでインストールした際に発生。
icon_s.pngicon_m.pngOnSysResourceCriticalシステムリソースが20%を切った際に発生。
icon_s.pngicon_m.pngOnSysResourceLowシステムリソースが40%を切った際に発生。
外部アプリ-猫どりふイベント
icon_s.pngicon_m.pngOnNekodorifObjectDodgeヒットしなかった落下物が可視領域内から消滅した際に発生。
icon_s.pngicon_m.pngOnNekodorifObjectDrop落下物を再投下する際に発生。
icon_s.pngicon_m.pngOnNekodorifObjectEmerge落下物が可視領域内に出現した際に発生。
icon_s.pngicon_m.pngOnNekodorifObjectHit落下物がヒットした際に発生。
icon_s.pngicon_m.pngOnNekodorifObjectVanishヒットした落下物が可視領域内から消滅した際に発生。
外部アプリイベント
icon_s.pngicon_m.pngOnApplicationBoot外部アプリケーションが起動した際に発生。
icon_s.pngicon_m.pngOnApplicationClose外部アプリケーションが終了した際に発生。
icon_s.pngicon_m.pngOnApplicationExist外部アプリケーションの存在を通知された際に発生。
icon_s.pngicon_m.pngOnApplicationFileOpen外部アプリケーションがドキュメントファイルを開いた際に発生。
icon_s.pngicon_m.pngOnApplicationOperationFinish外部アプリケーションか何らかの処理が完了した際に発生。
icon_s.pngicon_m.pngOnApplicationVersion外部アプリケーションのバージョン情報を通知された際に発生。
icon_s.pngicon_m.pngOnWebsiteUpdateNotifyウェブサイトの更新・新着情報を通知された際に発生。
時間イベント
icon_c.pngicon_s.pngicon_m.pngOnMinuteChange分変化
icon_c.pngicon_s.pngicon_m.pngOnSecondChange秒変化
時計合わせイベント
icon_c.pngicon_s.pngicon_m.pngOnSNTPBegin時計合わせ開始
icon_c.pngicon_s.pngicon_m.pngOnSNTPCompare時計合わせ情報取得
icon_s.pngOnSNTPCorrect時計合わせ完了
icon_s.pngicon_m.pngOnSNTPFailure時計合わせ情報取得失敗
消滅イベント
icon_s.pngOnOtherGhostVanished他のゴーストが消えた
icon_c.pngicon_s.pngicon_m.pngOnVanishButtonHold消滅指示後のキャンセル
icon_c.pngicon_s.pngicon_m.pngOnVanishCancel消滅指示取り消し
icon_c.pngicon_s.pngicon_m.pngOnVanishedゴースト切り替え(前ゴースト消滅時)
icon_c.pngicon_s.pngicon_m.pngOnVanishSelected消滅指示実行
icon_c.pngicon_s.pngicon_m.pngOnVanishSelecting消滅が指示された
情報通知イベント
icon_c.pngicon_s.pngbasewareversion実行環境のバージョン通知
icon_c.pngicon_s.pngicon_m.pnginstalledghostnameインストールされているゴーストの名前を通知
icon_s.pngOnNotifyDressupInfo着せ替え情報の通知
icon_s.pngOnNotifyOSInfoOS情報の通知
icon_c.pngicon_s.pngOnNotifySelfInfoゴースト自身の情報通知
icon_s.pngOnNotifyUserInfoユーザ情報通知
icon_c.pngicon_s.pngicon_m.pngotherghostname同時起動しているゴーストの名前を通知
icon_c.pngicon_s.pngicon_m.pngownerghostname現在のゴースト名を通知
icon_s.pngrateofusegraph使ってるぞグラフの内容表示
状態変更イベント
icon_c.pngicon_s.pngicon_m.pngOnBoot通常起動
icon_c.pngicon_s.pngicon_m.pngOnClose終了指示
icon_s.pngOnCloseAll全ゴースト終了指示
icon_s.pngOnDisplayChangeデスクトップ変化
icon_c.pngicon_s.pngicon_m.pngOnFirstBoot初回起動
icon_s.pngOnShellScalingシェル拡大/縮小率変更
icon_c.pngicon_s.pngicon_m.pngOnWindowStateMinimize最小化
icon_c.pngicon_s.pngicon_m.pngOnWindowStateRestore最小化復帰
切り替えイベント
icon_s.pngOnGhostCallCompleteゴースト呼び出し完了(呼び出し元)
icon_s.pngOnGhostCalledゴースト呼び出し完了
icon_s.pngOnGhostCallingゴースト呼び出し中
icon_c.pngicon_s.pngicon_m.pngOnGhostChangedゴースト切り替え完了
icon_c.pngicon_s.pngicon_m.pngOnGhostChangingゴースト切り替え指示
icon_s.pngOnOtherGhostBooted他のゴーストが起動
icon_s.pngOnOtherGhostChanged他のゴーストが切り替え完了
icon_s.pngOnOtherGhostClosed同時起動中のほかのゴーストが終了した
icon_c.pngicon_s.pngicon_m.pngOnShellChangedシェル切り替え完了
icon_c.pngicon_s.pngicon_m.pngOnShellChangingシェル切り替え指示
選択肢イベント
icon_c.pngicon_s.pngicon_m.pngOnAnchorSelectアンカークリック
icon_s.pngOnAnchorSelectExアンカークリック(拡張情報付き)
icon_c.pngicon_s.pngicon_m.pngOnChoiceEnter選択肢フォーカス変化
icon_s.pngOnChoiceHover選択肢上でマウスが「しばらく上で止まっている」
icon_c.pngicon_s.pngicon_m.pngOnChoiceSelect選択肢クリック
icon_s.pngOnChoiceSelectEx選択肢クリック(拡張情報付き)
icon_c.pngicon_s.pngicon_m.pngOnChoiceTimeout選択肢タイムアウト
入力ボックスイベント
icon_c.pngicon_s.pngicon_m.pngOnCommunicateコミュニケート
icon_s.pngOnCommunicateInputCancelCommunicateBox?入力中止
icon_c.pngicon_s.pngicon_m.pngOnTeachStartTeachBox?オープン
icon_s.pngOnTeachInputCancelTeachBox?入力中止
icon_c.pngicon_s.pngicon_m.pngOnUserInputInputBox?クローズ
icon_s.pngOnUserInputCancelInputBox?入力中止

SSP拡張イベント

OnAITalk

  • \aなどによる会話が求められた際に発生。
    icon_s.png
    • 解説
      \aなどによる会話が求められた際に発生。

OnBalloonBreak?

  • SSTP以外でブレイクされた際に発生。
    icon_s.png
    • 解説
      SSTP以外でスクリプトをブレークされた際に発生します。
    • 補足
      Reference1の送信はSSP 1.11系からです。
    • パラメータ
      Reference0ブレークされたスクリプト
      Reference1どちら側のバルーンからブレーク操作が行われたか (\0 = 0 \1 = 1 \p[2] = 2 ...)

OnBalloonChange?

  • バルーン切替
    icon_s.png
    • 解説
      バルーンが切替られたときに発生するイベントです。バルーンの切替は瞬時に処理されるので、
      Changing/Changedの2段構えではなく、OnBalloonChangeという名前となっています。
    • 補足
      1.10.04からの実装です。 ※その前から試験実装されていましたが、Reference1のパスは通知していません。
    • パラメータ
      Reference0バルーンの名前
      Reference1バルーンのパス (相対パスか絶対パスかは処理系依存 SSPは絶対パス)

OnBalloonClose?

  • バルーンがタイムアウトせずに閉じられた
    icon_s.png
    • 解説
      タイムアウトせず、ユーザがクリックすることでバルーンを閉じた場合に発生します。
    • パラメータ
      Reference0再生中だったスクリプト

OnBalloonTimeout?

  • 選択肢以外でバルーンがタイムアウトした際に発生。
    icon_s.png
    • 解説
      選択肢以外でバルーンがタイムアウトした際に発生。
    • パラメータ
      Reference0スクリプト。

OnBatteryCritical?

  • バッテリ残量が非常に少なくなった際に発生。
    icon_s.png
    • 解説
      バッテリ残量が非常に少なくなってきた際に発生します。
      通知されるタイミングはWindowsの電源管理の設定に依存します。
    • 補足
      電源状態が変化した際以外に、ゴースト起動時にNOTIFY(喋らない)で必要に応じて別途通知されます。
      ゴーストの内部状態を初期化する時などに使うと良いでしょう。
    • パラメータ
      Reference0バッテリ残量の割合(%) 検出できなかった場合は-1
      Reference1バッテリ切れまでの残り時間(秒) 検出できなかった場合は-1
      Reference2電源状態 offline=バッテリ online=AC電源 backup=UPSなどのバックアップ電源

OnBatteryLow?

  • バッテリ残量が少なくなった際に発生。
    icon_s.png
    • 解説
      バッテリ残量が少なくなってきた際に発生します。
      通知されるタイミングはWindowsの電源管理の設定に依存します。
    • 補足
      電源状態が変化した際以外に、ゴースト起動時にNOTIFY(喋らない)で必要に応じて別途通知されます。
      ゴーストの内部状態を初期化する時などに使うと良いでしょう。
    • パラメータ
      Reference0バッテリ残量の割合(%) 検出できなかった場合は-1
      Reference1バッテリ切れまでの残り時間(秒) 検出できなかった場合は-1
      Reference2電源状態 offline=バッテリ online=AC電源 backup=UPSなどのバックアップ電源

OnBatteryNotify?

  • バッテリ状態の通知
    icon_s.png
    • 解説
      バッテリの残量やAC電源/バッテリの切り替えなど、電源の状態が変わった際に通知されるイベントです。
      これを利用することにより、バッテリが満充電になった際にメッセージを表示するなどの機能が可能となります。
    • 補足
      バッテリがない機械では一切通知されません。 Windows NT4ではサポートされていません。 
      電源状態が変化した際以外に、ゴースト起動時にNOTIFY(喋らない)で別途通知されます。
      ゴーストの内部状態を初期化する時などに使うと良いでしょう。
    • パラメータ
      Reference0バッテリ残量の割合(%) 検出できなかった場合は-1
      Reference1バッテリ切れまでの残り時間(秒) 検出できなかった場合は-1
      Reference2電源状態 offline=バッテリ online=AC電源 backup=UPSなどのバックアップ電源

OnCacheRestore?

  • ゴーストキャッシュから出た際に発生。
    icon_s.png
    • 解説
      ゴーストキャッシュから出た際に発生。
    • 補足
      SSPは設定を変えない限り、常にゴースト終了後も再度立ち上げる際に備えてゴーストを読み込んだままにしています。
      終了時に必ず何かの処理を行う必要がある場合、このイベントにも対応する必要があります。

OnCacheSuspend?

  • ゴーストキャッシュに入った際に発生。
    icon_s.png
    • 解説
      ゴーストキャッシュに入った際に発生。

OnDestroy?

  • ゴースト終了
    icon_s.png
    • 解説
      SHIORIが開放される直前に通知されます。このイベント内でゴースト内部の処理の後始末を行うとよいでしょう。
    • 補足
      このイベントはNotifyイベントです。スクリプトを返しても再生されません。

OnDressupChanged?

  • 着せ替え変更通知
    icon_s.png
    • 解説
      着せ替え設定が変更されたことを通知します。
    • 補足
      このイベントは切り替え時に複数Notifyされる可能性があります。
      先に着せ替えグループなどの関係で自動的にON/OFFされる通知が入った後に、
      最後にユーザが操作したものが通知されます。
    • パラメータ
      Reference0キャラクターウィンドウID (0=Sakura 1=Kero 2...)
      Reference1着せ替え要素定義の名前
      Reference20=OFF 1=ON

OnEmbryoExist?

  • SSP起動時、先にmateria.exeが起動されていた際に発生。
    icon_s.png
    • 解説
      SSP起動時、先にmateria.exeが起動されていた際に発生。

OnExecuteHTTPComplete

  • \![execute,http-get / post]でasyncオプションを指定して成功した際に発生。
    icon_s.png
    • 解説
      \![execute,http-get / post]でasyncオプションを指定して成功した際に発生。
    • 補足
      execute-httpを参照 http://emily.shillest.net/specwiki/index.php?SSP%2F%E4%BB%95%E6%A7%98%E6%9B%B8%2Fexecute-http
    • パラメータ
      Reference0post/get
      Reference1ASYNC IDで指定した文字列がそのまま入る
      Reference2URLそのまま
      Reference3取得したファイルのフルパス
      Reference4取得結果コード ( timeout,fileio,200,204,403,404... )
      Reference5Set-Cookieでクッキーを受け取ったらその文字列(次回すぐ使えるよう加工済)

OnExecuteHTTPFailure

  • \![execute,http-get / post]でasyncオプションを指定して失敗した際に発生。
    icon_s.png
    • 解説
      \![execute,http-get / post]でasyncオプションを指定して失敗した際に発生。
    • 補足
      execute-httpを参照 http://emily.shillest.net/specwiki/index.php?SSP%2F%E4%BB%95%E6%A7%98%E6%9B%B8%2Fexecute-http
    • パラメータ
      Reference0post/get
      Reference1ASYNC IDで指定した文字列がそのまま入る
      Reference2URLそのまま
      Reference3取得したファイルのフルパス
      Reference4取得結果コード ( timeout,fileio,200,204,403,404... )
      Reference5Set-Cookieでクッキーを受け取ったらその文字列(次回すぐ使えるよう加工済)

OnInitialize?

  • ゴースト起動
    icon_s.png
    • 解説
      SHIORIが読み込まれた直後に通知されます。
      このイベント内でゴースト内部の処理の初期化を行うとよいでしょう。
    • 補足
      このイベントはNotifyイベントです。スクリプトを返しても再生されません。

OnNekodorifExist?

  • SSP起動時、先に猫どりふが起動されていた際に発生。
    icon_s.png
    • 解説
      SSP起動時、先に猫どりふが起動されていた際に発生。

OnNetworkStatusChange?

  • ネットワーク接続状態の変化通知
    icon_s.png
    • 解説
      接続/切断など、ネットワーク接続状態が変わった際に発生します。
    • 補足
      ゴースト起動直後の1発目の通知はNOTIFYで、その後はGETとなる点に注意してください。
    • パラメータ
      Reference0online または offline
      Reference1現在居るマシンに割り当てられているIPアドレスのバイト値1区切りリスト

OnNotifyOtherFailure?

  • \![notifyother]での失敗通知
    icon_s.png
    • 解説
      \![notifyother]での失敗通知
    • 補足
      __SYSTEM_ALL_GHOST__など同時複数一斉通知を利用した場合は、
      Reference0と1が、通知対象のうちエラーを起こしたゴースト分、バイト値1区切りのリストとなります。
      このとき、Reference1はdescript.txtのsakura.nameとなります。
      SSP/2.01.29以降
    • パラメータ
      Reference0notfound (見つからなかった) / timecritical (\t) / passivemode / inductionmode / minimized (最小化中) / 204などPLUGINの実行結果
      Reference1名前/sakura.name - タグで指定したものと全く同じ
      Reference2実行しようとしたイベントID
      Reference3以降実行しようとしたイベントのReference0以降

OnNotifyPluginFailure?

  • \![notifyplugin]での失敗通知
    icon_s.png
    • 解説
      \![notifyplugin]での失敗通知
    • 補足
      SSP/2.01.29以降
    • パラメータ
      Reference0notfound (見つからなかった) / disabled (無効設定中) / 204などPLUGINの実行結果
      Reference1名前/ID - タグで指定したものと全く同じ
      Reference2実行しようとしたイベントID
      Reference3以降実行しようとしたイベントのReference0以降

OnOtherGhostTalk?

  • 他ゴーストのトーク通知
    icon_s.png
    • 解説
      \![set,otherghosttalk,true]で有効にすると、
      ほかのゴーストが喋った時にこのイベントが通知されるようになります。
    • 補足
      SecurityLevelヘッダは、元のトークの状態が引き継がれます。
      Remote SSTP等で喋ったトークを引っ掛けた場合はこのイベントのSecurityLevelもremoteになります。
    • パラメータ
      Reference0ゴースト名
      Reference1ゴーストのSakura名
      Reference2トーク状態。break(中断した),communicate(コミュ),remote(非ローカルSSTP由来)
      Reference3イベントID。OnBoot?などトークの原因となったイベント。SSTPなど非イベント由来はからっぽ
      Reference4しゃべったスクリプト
      Reference5イベントのReference群をバイト値1区切りで
    • サンプル
      GET SHIORI/3.0
      ID: OnOtherGhostTalk
      Reference0: Emily/Phase4
      Reference1: Emily
      Reference2: break,communicate
      Reference3: OnCommunicate
      Reference4: \h\s[4]なにいってるのかわからないよ…
      Reference5: ほげほげ
      SecurityLevel: local

OnRaiseOtherFailure?

  • \![raiseother]での失敗通知
    icon_s.png
    • 解説
      \![raiseother]での失敗通知
    • 補足
      __SYSTEM_ALL_GHOST__など同時複数一斉通知を利用した場合は、
      Reference0と1が、通知対象のうちエラーを起こしたゴースト分、バイト値1区切りのリストとなります。
      このとき、Reference1はdescript.txtのsakura.nameとなります。
      SSP/2.01.29以降
    • パラメータ
      Reference0notfound (見つからなかった) / timecritical (\t) / passivemode / inductionmode / minimized (最小化中) / 204などPLUGINの実行結果
      Reference1名前/sakura.name - タグで指定したものと全く同じ
      Reference2実行しようとしたイベントID
      Reference3以降実行しようとしたイベントのReference0以降

OnRaisePluginFailure?

  • \![raiseplugin]での失敗通知
    icon_s.png
    • 解説
      \![raiseplugin]での失敗通知
    • 補足
      SSP/2.01.29以降
    • パラメータ
      Reference0notfound (見つからなかった) / disabled (無効設定中) / 204などPLUGINの実行結果
      Reference1名前/ID - タグで指定したものと全く同じ
      Reference2実行しようとしたイベントID
      Reference3以降実行しようとしたイベントのReference0以降

OnScreenSaverEnd?

  • スクリーンセーバーが終了した際に発生。
    icon_s.png
    • 解説
      スクリーンセーバーが終了した際に発生。

OnScreenSaverStart?

  • スクリーンセーバーが起動した際に発生。
    icon_s.png
    • 解説
      スクリーンセーバーが起動した際に発生。

OnSoundStop?

  • サウンドが終了した際に発生。
    icon_s.png
    • 解説
      サウンドが終了した際に発生。
    • パラメータ
      Reference0再生ファイル名。

OnSysResume?

  • スタンバイ状態からの回復
    icon_s.png
    • 解説
      スタンバイ状態から戻った時に通知されます。

OnSysSuspend?

  • スタンバイ状態へ
    icon_s.png
    • 解説
      スタンバイ(スリープ)状態へとシステムが移行する時に通知されます。
    • 補足
      このイベントにスクリプトを返しても実行されません。(NOTIFYイベント)

OnTeach?

  • TeachBox?からの入力があった際に発生。
    icon_s.png
    • 解説
      TeachBoxからの入力があった際に発生。
    • パラメータ
      Reference0入力された言葉。
      Reference1Reference0に対して入力された言葉。

OnTrayBalloonClick?

  • 通知領域バルーンがクリックされた
    icon_s.png
    • 解説
      \![set,trayballoon]
      で表示した通知領域バルーンがクリックして消された際に発生します。
    • パラメータ
      Reference0タイトル文字列 (--title指定)
      Reference1表示テキスト (--text指定、改行は無視)

OnTrayBalloonTimeout?

  • 通知領域バルーンタイムアウト/閉じ
    icon_s.png
    • 解説
      \![set,trayballoon]
      で表示した通知領域バルーンが、タイムアウトで自然に消えた、あるいは×ボタンで消された際に発生します。
    • パラメータ
      Reference0タイトル文字列 (--title指定)
      Reference1表示テキスト (--text指定、改行は無視)

OnURLQuery

  • URL D&D時の通知
    icon_s.png
    • 解説
      URLがキャラクターウィンドウにドラッグ&ドロップされた際に通知されます。
      これに対してスクリプトを返す(200)と、OnURLDropping -> Droppedという
      通常のダウンロード処理がキャンセルされます。
      ゴースト側でURLを独自に処理したい場合のみスクリプトを返してください。
    • パラメータ
      Reference0URL
      Reference1キャラクターウィンドウID (Sakura=0 Kero=1 2...)
      Reference2ダウンロードするファイルのMIME

SSTPイベント

OnMusicPlay?

  • 音楽演奏反応
    icon_s.pngicon_m.png
    • 解説
      SSTPプロトコル NOTIFY/1.1 仕様に従って、「Event:OnMusicPlay」が本体に送信された時に、
      発生するイベントです。
    • 補足
      現在、この仕様によってSSTP送信するアプリケーションは、Winamp2用プラグインである
      「YunaSexyFont Plug-in 2000」(Version 7.9b21)のみです。
      また、このプラグインでは、Reference0に、演奏開始した曲のタイトル
      (Winamp上での表記、デフォルトでは「(アーティスト名) - (曲名)」)が代入されてリクエストされます。
    • パラメータ
      Reference0曲のデータ(タイトル)

その他のイベント

OnNetworkHeavy?

  • サーバの応答無し
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      ドロップイベント(「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

OnRecommendsiteChoice?

  • おすすめメニューのサイトクリック
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      右クリックメニューで現れる、「おすすめ」「ポータル」メニューの中からサイトを選んで
      クリックすると発生するイベントです。
    • パラメータ
      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

OnSSTPBlacklisting

  • SSTPの特定IPからの受信禁止処理
    icon_m.png
    • 解説
      ネットワークからのSSTPプロトコルSENDリクエストに対し、「ブラックリスティング」を指示した時に、
      このイベントが発生します。
      このイベントが発生すると、最後にSENDリクエストを送信したIPアドレスがブラックリストファイルに記録され、
      以後、そのIPアドレスからのSENDリクエストが無視(読み上げられなくなる)されます。
    • パラメータ
      Reference0最後に送信されたSSTP送信元の IP アドレス

OnSSTPBreak

  • SSTP受信中断
    icon_s.pngicon_m.png
    • 解説
      SSTPプロトコルのSENDによって受信したメッセージを読み上げている時に、バルーンをダブルクリックして、
      読み上げの中止を指示した時に発生するイベントです。
    • 補足
      Reference1の送信はSSP 1.11系からです。
    • パラメータ
      Reference0受信を中断されたスクリプト
      Reference1どちら側のバルーンからブレーク操作が行われたか (\0 = 0 \1 = 1 \p[2] = 2 ...)

OnTranslate?

  • トランスレートイベント
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      このイベントは特殊で、各リクエストのあと実行すべきスクリプトがあった場合必ず発生します。
      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
      この場合、直前の何らかのイベントで”トランスレートします。”と返しています。
      このイベントでトランスレートされるため、実際には”トランスレートしました。”と表示されます。

インストールイベント

OnInstallBegin?

  • インストール開始
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      アーカイブがドラッグ&ドロップされインストールが開始した時に発生します。
    • サンプル
      GET SHIORI/3.0
      Sender: crow
      ID: OnInstallBegin
      SecurityLevel: local
      Charset: Shift_JIS
      SHIORI/3.0 200 OK
      Value: \0\s[0]インストール開始。\e

OnInstallComplete?

  • インストール完了
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      インストールがエラーを起こさずに完了した場合に発生するイベントです。
      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

OnInstallCompleteEx?

  • インストール完了(拡張)
    icon_s.png
    • 解説
      インストールがエラーを起こさずに完了した場合に発生するイベントです。
      互換を確保するため、このイベントを無視してスクリプトを返さない(200 OK以外)場合、
      続けてOnInstallCompleteが発生します。
    • 補足
      Reference0にはインストールした物の種別が入りますが、現在のところ以下のとおりです。
      install.txtに書かれる識別子と同じものが入るとは限りません。特にwith balloonなどの場合は、
      サンプルにあるようにghost[1]balloonなどというふうにバイト値1区切りで渡されます。
      shell:シェル
      ghost:ゴースト
      supplement:ゴースト用追加ファイル
      balloon:バルーン
      plugin:プラグイン
      headline:ヘッドラインセンサ
      calendar skin:カレンダースキン [SSPのみ]
      calendar plugin:スケジュールセンサ [SSPのみ]
    • パラメータ
      Reference0インストールした物の種別(複数ある場合はバイト値1区切り)
      Reference1インストールした物の名前(複数ある場合はバイト値1区切り)
      Reference2インストールした場所(複数ある場合はバイト値1区切り)
    • サンプル
      GET SHIORI/3.0
      Sender: SSP
      ID: OnInstallCompleteEx
      Reference0: ghost[1]balloon[1]headline
      Reference1: Emily/Phase4[1]エミリ専用バルーン[1]SSP BUGTRAQヘッドライン
      Reference2: C:\SSP\ghost\emily4\[1]C:\SSP\balloon\emily4\[1]C:\SSP\headline\bugtraq\
      SecurityLevel: local
      Charset: Shift_JIS
      SHIORI/3.0 200 OK
      Value: \0\s[0]インストール完了しました。\e

OnInstallFailure?

  • インストール失敗
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      インストールが何らかの理由で失敗した場合に発生するイベントです。
      失敗した場合、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

OnInstallRefuse?

  • インストール拒否
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      インストールしようとしたアーカイブが、
      ドロップされたゴーストと別のゴーストを指名していた場合に発生するイベントです。
    • パラメータ
      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

キーボードイベント

OnKeyPress?

  • キーを押した
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      キーボードのキーが押された時に発生します。
    • 補足
      特殊キーの識別子一覧です。
      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

サーフィスイベント

OnSurfaceChange?

  • サーフィス変化
    icon_c.pngicon_s.png
    • 解説
      サーフィスが変化したときに呼ばれるイベントです。
      変化したサーフィス番号が渡されます。
      表示されていなければ、-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

OnSurfaceRestore?

  • サーフィス復帰指示
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      サーフィスが変化した後、一定時間で呼び出されるイベントです。
      このイベントに応答することにより、初期サーフィスに戻すことができますが、
      戻すかどうかは各ゴーストに任されています。
      また、このイベントはメイン側がサーフィス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

ドロップイベント

OnFileDrop?

  • ファイル・フォルダドロップ開始
    icon_s.png
    • 解説
      ファイルやフォルダがドラッグ&ドロップされた際に発生するイベントです。
    • 補足
      過去互換用です。OnFileDrop2/Exなどを利用してください。
      また、別途互換用にOnFileDroppedも送られてきますがこちらも利用非推奨です。
    • パラメータ
      Reference0ドロップされたファイル又はドロップされたフォルダ
      Reference1メインキャラ側なら0、サブキャラ側なら1、以下2・3…
      旧仕様のため使用非推奨

OnFileDrop2

  • ファイル・フォルダドロップ開始
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      ファイルやフォルダがドラッグ&ドロップされた際に発生するイベントです。
      複数のファイルやフォルダが同時にドロップされた場合は、バイト値 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が同時にドラッグ&ドロップされています。

OnFileDropEx?

  • ファイルドロップ開始
    icon_s.png
    • 解説
      ファイルがドラッグ&ドロップされた際に発生するイベントです。
      複数のファイルが同時にドロップされた場合は、バイト値 1 でセパレートされます。
      *補足 ドロップされたファイルがアーカイブ(NAR、ZIP、LZH)の場合、このイベントは発生せず、
      インストールイベントが発生します。
    • パラメータ
      Reference0ドロップされたファイル

OnFileDropping?

  • ファイルドロップ直前
    icon_s.png
    • 解説
      ファイルやフォルダがドラッグ&ドロップされる直前(マウスが重ねられた)際におきるイベントです。
    • パラメータ
      Reference0ドロップされたファイル又はドロップされたフォルダ(1つめのみ)
      Reference1メインキャラ側なら0、サブキャラ側なら1、以下2、3…

OnNarCreated?

  • NARファイル作成完了
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      「OnNarCreating」イベントによるNARファイルの作成が完了すると、このイベントが発生します。
      Reference2 には、NARファイル化されたデータの種類として、
      ghost ゴースト
      shell シェル
      balloon バルーン
      plugin プラグイン
      …が入ります。
    • パラメータ
      Reference0install.txtに記述されたnameの値
      Reference1生成したnarのファイル名
      Reference2install.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
      です。

OnNarCreating?

  • NARファイル作成開始
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      ゴーストにインストール情報を記述したテキストファイル「install.txt」を含む
      フォルダをドラッグ&ドロップした時に発生するイベントです。
      この後、「install.txt」の情報を元に、NARファイルが作成され、「OnNarCreated」イベントが呼ばれます。
    • 補足
      生成するnarのファイル名はドラッグしたフォルダの拡張子をnarに変更したものになります。
      ドラッグしたフォルダの直下にinstall.txtがある必要があります。
    • パラメータ
      Reference0install.txtに記述されたnameの値
      Reference1生成するnarのファイル名
      Reference2install.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
      です。

OnTextDrop?

  • テキストデータのドロップ
    icon_s.png
    • 解説
      テキストデータをD&Dした時に発生します。
    • 補足
      応答しない場合の標準動作は「SakuraScriptっぽいなら実行、それ以外は無視」です。
    • パラメータ
      Reference0テキストデータそのもの 改行はバイト値1に置換
      Reference1キャラID(メイン=0、以下1,2...)

OnUpdatedataCreated?

  • アップデート情報作成完成
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      「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

OnUpdatedataCreating?

  • アップデート情報作成開始
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      ゴーストに「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

OnURLDropFailure?

  • URLドロップ失敗
    icon_s.pngicon_m.png
    • 解説
      OnURLDroppingによって開始されたダウンロードが失敗した、
      もしくはユーザーがダウンロード中にバルーンをダブルクリックする事で中断を指示した場合に発生します。
      このイベントが発生した場合、Reference0 はダウンロードされる予定だった
      ファイルのローカルマシン上での絶対パス、Reference1 には、そのエラーの内容が入ります。
      現在起こるエラーは
      artifical ユーザーによる中断
      timeout ファイルのダウンロード失敗
    • 補足
      ダウンロードが失敗(もしくは中断)した時には、Reference0 で示されるパス上には、
      ファイルは存在しません(イベント発生時に削除される)。
    • パラメータ
      Reference0ダウンロードされる筈だったファイル(ローカルマシン上での絶対パス)
      Reference1失敗の理由(artificial/timeout)
    • サンプル
      GET SHIORI/3.0
      Sender: crow
      ID: OnURLDropFailure
      Reference0: C:\Crow\nar\sample.nar
      Reference1: timeout
      SecurityLevel: local
      Charset: Shift_JIS
      SHIORI/3.0 200 OK
      Value: \0\s[0]タイムアウトで失敗しました。\e

OnURLDropped

  • URLドロップ完了
    icon_s.pngicon_m.png
    • 解説
      「OnURLDropping」により発生したファイルのダウンロードが完了した時に発生します。
    • 補足
      現在の MATERIA phase583 では、イベントは発生していますが、
      返した Value は処理されず破棄されているようです。(OnTrancelateが発生しないため、処理されない)
      また、このイベントの後、強制的に一連のインストールイベントに移行します。
    • パラメータ
      Reference0ダウンロードしたファイルのローカルマシン上での絶対パス
    • サンプル
      GET SHIORI/3.0
      Sender: crow
      ID: OnURLDropped
      Reference0: C:\Crow\nar\sample.nar
      SecurityLevel: local
      Charset: Shift_JIS
      SHIORI/3.0 200 OK
      Value: \0\s[0]ダウンロード完了しました。\e

OnURLDropping

  • URLドロップ開始
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      ブラウザ等からアーカイブの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

OnWallpaperChange?

  • 壁紙設定
    icon_s.png
    • 解説
      BMP、JPEGなど、OSの壁紙として設定できそうなファイルがドロップされた際に発生します。
      このイベントに応答すると、本体の壁紙変更機能が動作し、壁紙が変更されます。
    • パラメータ
      Reference0ドロップされたファイル
      Reference1メインキャラ側なら0、サブキャラ側なら1、以下2、3…

ネットワーク更新イベント

OnUpdate?.OnDownloadBegin?

  • ファイルダウンロード開始
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      ネットワーク更新中に、ファイルのダウンロードを開始する時に発生するイベントです。
    • 補足
      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

OnUpdate?.OnMD5CompareBegin?

  • MD5の照合開始
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      ファイルをダウンロードした後、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

OnUpdate?.OnMD5CompareComplete?

  • MD5一致
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      ダウンロードしたファイルの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

OnUpdate?.OnMD5CompareFailure?

  • MD5不一致
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      ダウンロードしたファイルの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

OnUpdateBegin?

  • ネットワーク更新開始
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      ネットワーク更新が指示された直後に発生するイベントです。
      この後、更新情報の取得を行います。
    • 補足
      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

OnUpdateCheckComplete?

  • ネットワーク更新チェック完了
    icon_s.png
    • 解説
      \![updatebymyself,checkonly]
      タグを実行した際に、チェックが正常終了した後で発生するイベントです。
      何らかの理由で失敗した場合は、このイベントは呼ばれず、OnUpdateCheckFailureが呼ばれます。
      更新するファイルがなかった場合は、Reference0にnoneが返ります。
    • パラメータ
      Reference0状態(changed/none)
      Reference1カンマで区切られた更新ファイル名のリスト
      Reference3タイプ (shell,ghost,balloon,headline,plugin,basewareのいずれか)

OnUpdateCheckFailure?

  • ネットワーク更新チェック失敗
    icon_s.png
    • 解説
      \![updatebymyself,checkonly]
      タグで実行した更新チェックが、何らかの理由で失敗した際に呼ばれるイベントです。
    • 補足
      エラー内容を示すReference0は、OnUpdateFailureと同じです。
      詳しいリストについてはそちらをご覧下さい。
    • パラメータ
      Reference0エラー内容(timeout/md5 miss/404等)
      Reference3タイプ (shell,ghost,balloon,headline,plugin,basewareのいずれか)

OnUpdateComplete?

  • ネットワーク更新完了
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      ネットワーク更新で、すべてのファイルをダウンしインストールが完了された後に呼び出されるイベントです。
      何らかの理由で失敗した場合は、このイベントは呼ばれず、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]ネットワーク更新完了。

OnUpdateFailure?

  • ネットワーク更新失敗
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      何らかの理由でネットワーク更新が失敗した場合に発生するイベントです。
      このイベントが発生した場合、Reference0にそのエラーの内容が入ります。
      現在起こるエラーは
      404    そのステータスコードで失敗。404以外の数値もあり。
      timeout  転送タイムアウト
      md5 miss  MD5不一致
      too slow 転送タイムアウト(MATERIA)
      artificial バルーンダブルクリックでの手動中断
      fileio   ディスク容量不足等ファイルの書き込みに失敗(SSP)
      readonly  ゴーストディレクトリが書き込み禁止のため更新できない(SSP)
      です。
    • 補足
      MATERIAでは、このイベントが2回発生することがあるようです。
      その場合、2度目のReference0には200という値が入ることがあります。
      Reference3はCROW / SSP 2.0以降の実装です。
      SSPで、ゴーストと同時にバルーンやシェルも更新する機能が有効の場合、ゴースト以外の更新時には、
      OnUpdateOtherFailureが発生します。
      イベント名のみの変更で、他に違いはありません。
    • パラメータ
      Reference0エラー内容(timeout/md5 miss/404等)
      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

OnUpdateReady?

  • ネットワーク更新準備完了
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      ネットワーク更新を開始し、実際に更新するファイルがあった場合に発生するイベントです。
      更新するファイルがなかった場合はこのイベントは発生せず、OnUpdateCompleteが発生します。
    • 補足
      Reference3はCROW / SSP 2.0以降の実装です。
      SSPで、ゴーストと同時にバルーンやシェルも更新する機能が有効の場合、ゴースト以外の更新時には、
      OnUpdateOtherReadyが発生します。
      イベント名のみの変更で、他に違いはありません。
    • パラメータ
      Reference0更新を行うファイルの数-1
      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

ヘッドラインセンスイベント

OnHeadlinesense?.OnFind?

  • ヘッドラインセンス結果の読み上げ
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      ヘッドラインセンスにより情報が収拾・分析され、その結果が更新されていた場合、このイベントが発生します。
      Reference2 にセットされるデータ(OnFind フェーズ)は、
      「First」: 1ページ目(次ページが存在する)
      「First and Last」:1ページ目(次ページは無く、この1ページのみの場合)
      「Last」: 最終ページ
      「Next」: 上記3項目に該当しないページ
      となる。
      また、このイベントが発生した後、空の識別子を選択(例「 \q[次のページへ,] 」)を指示すると、
      改ページが指定したものとみなされ、
      次ページのヘッドラインデータをもった「OnHeadlinesense.OnFind」イベントが発生する。
    • 補足
      ヘッドラインデータは、さくらスクリプト形式であるが、MATERIA Phase583においては、
      データ中に「\-」(終了指示タグ)などが含まれてる事がある(データの抽出での問題)ため、
      そのままValueとして返すと、問題が発生する場合がある。
      そのため、特に制御を意図するタグとして解釈・誤動作しないように整形する処理を施す必要がある。
    • パラメータ
      Reference0対象サイト名
      Reference1対象URL
      Reference2OnFind? フェーズ
      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

OnHeadlinesenseBegin?

  • ヘッドラインセンス開始
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      ヘッドラインセンスが指示された直後に発生するイベントです。
      この後、サイト情報の取得・分析を行います。
    • 補足
      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

OnHeadlinesenseComplete?

  • ヘッドラインセンス成功(更新無し)
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      ヘッドラインセンスは正常終了したが、更新が無かった場合に発生する。
      そのため、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

OnHeadlinesenseFailure?

  • ヘッドラインセンス失敗
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      何らかの理由でヘッドラインセンスが失敗した場合に発生するイベントです。
      このイベントが発生した場合、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

OnRSSComplete

  • RSS受信成功
    icon_s.png
    • 解説
      RSSの受信に成功した場合に発生します。
      Reference0にRSSのタイトル、Reference1にRSSフィードを提供しているWebページのURL
      (RSS自身ではない点に注意!)が渡されます。
      更新があった場合のReferenceの数は可変です。Reference2から順に以下の書式で渡されます。
      タイトル[1]URL[1]更新日時
      [1]はバイト値1です。日付がない場合(タイトル[1]URL)もあります。
      更新日時のフォーマットは以下の通りです。カンマ区切りです。
      年,月,日,時,分,秒
    • 補足
      今後の拡張は[1]でさらに区切って追加していく方法で行われますので、
      バイト値1で区切られた要素数をあらかじめ決め打ちして解析する方法は避けてください。
      要素数がからっぽのフィードの場合、Reference2以降は存在しません。
      現在のところ、暫定仕様です。
    • パラメータ
      Reference0RSSのタイトル
      Reference1RSSフィードを提供しているWebページのURL(RSS自身ではない点に注意!)
      Reference2(これ以降、RSSのデータ - 説明参照)

マウスイベント

OnMouseClick?

  • マウスクリック
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      マウスがクリックされた時に発生するイベントです。
    • 補足
      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

OnMouseDoubleClick?

  • マウス左ボタンダブルクリック
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      マウスの左ボタンをダブルクリックした時に発生するイベントです。
    • 補足
      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

OnMouseDragEnd?

  • マウスドラッグ終了
    icon_s.png
    • 解説
      ゴーストのウインドウをドラッグし終わった時に発生します。
    • パラメータ
      Reference0マウスカーソルの x 座標(ローカル座標)
      Reference1マウスカーソルの y 座標(ローカル座標)
      Reference20
      Reference3スコープ番号
      Reference4当たり判定識別子
      Reference50

OnMouseDragStart?

  • マウスドラッグ開始
    icon_s.png
    • 解説
      ゴーストのウインドウをドラッグし始めた時に発生します。
    • パラメータ
      Reference0マウスカーソルの x 座標(ローカル座標)
      Reference1マウスカーソルの y 座標(ローカル座標)
      Reference20
      Reference3スコープ番号
      Reference4当たり判定識別子
      Reference50

OnMouseEnter?

  • マウスが当たり判定内に入った
    icon_s.png
    • 解説
      マウスが特定の当たり判定領域に入ったことを示します。
    • パラメータ
      Reference0マウスカーソルの x 座標(ローカル座標)
      Reference1マウスカーソルの y 座標(ローカル座標)
      Reference20
      Reference3スコープ番号
      Reference4当たり判定識別子
      Reference50

OnMouseEnterAll?

  • マウスがウインドウ内に入った
    icon_s.png
    • 解説
      マウスがキャラクターのウインドウ内に入ったことを示します。
      当たり判定は考慮せず、単純にウインドウ内に入ったかどうかで通知されます。
    • パラメータ
      Reference0マウスカーソルの x 座標(ローカル座標)
      Reference1マウスカーソルの y 座標(ローカル座標)
      Reference20
      Reference3スコープ番号
      Reference4当たり判定識別子
      Reference50

OnMouseHover?

  • マウスが「しばらく上で止まっている」
    icon_s.png
    • 解説
      マウスが「しばらく上で止まっている」時に起こります。
      ツールチップ表示とタイミングは(ほぼ)同じ。
    • 補足
      SSP/2.01.61以降
    • パラメータ
      Reference083 ←X座標
      Reference1245 ←Y座標
      Reference20 ←常に0
      Reference30 ←0(sakura) 1(kero) 2...
      Reference4Body ←当たり判定識別子
      Reference50 ←常に

OnMouseLeave?

  • マウスが当たり判定外に出た
    icon_s.png
    • 解説
      マウスが特定の当たり判定領域から出たことを示します。
    • パラメータ
      Reference0マウスカーソルの x 座標(ローカル座標)
      Reference1マウスカーソルの y 座標(ローカル座標)
      Reference20
      Reference3スコープ番号
      Reference4当たり判定識別子
      Reference50

OnMouseLeaveAll?

  • マウスがウインドウから出た
    icon_s.png
    • 解説
      マウスがキャラクターのウインドウ内から出たことを示します。
      当たり判定は考慮せず、単純にウインドウ内に入ったかどうかで通知されます。
    • パラメータ
      Reference0マウスカーソルの x 座標(ローカル座標)
      Reference1マウスカーソルの y 座標(ローカル座標)
      Reference20
      Reference3スコープ番号
      Reference4当たり判定識別子
      Reference50

OnMouseMove?

  • マウス移動
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      サーフィス上で、マウスが移動した時に発生するイベントです。
    • パラメータ
      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

OnMouseWheel?

  • マウスホイール回転
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      マウスのホイールが回転した時に発生するイベントです。
    • 補足
      あくまでも参考程度ですが、現在のところ、回転量は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

メールチェックイベント

OnBIFF2Complete

  • 新着メール通知
    icon_m.png
    • 解説
      MATERIAの設定で「新着のみ通知」とした時に、メールチェックが終了した時に発生するイベントです。
      なお、このイベントは、自動でメールチェックを行なった時に新着メールがない時には発生しません。
      また、このイベントに対してエラーで返した場合、「OnBIFFComplete」イベントが発生します。
    • 補足
      MATERIA Phase583では、Reference5・6は送られてきません。
      また、Reference3は、前回チェック時とのメール総数の増減を示すため、例えば、
      メールチェックで2通を確認(2通)→メール受信(0通)→新着メール到着(1通)
      という状態でこのイベントが発生すると、-1となります。
      また、本体側の設定により、Reference4~6は送られてこない場合があります。
    • パラメータ
      Reference0スプールされているメールの通数
      Reference1スプールされているメールのバイト数
      Reference2チェックするサーバ名
      Reference3前回チェック時より増減したメールの通数
      Reference4個々のメールのヘッダー部分
      Reference5個々のメールのサイズ
      Reference6個々のメールのuidl

OnBIFFBegin

  • メールチェック開始
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      メールチェックイベントが指示された直後に発生するイベントです。
      この後、メールサーバから情報の取得を行います。
    • 補足
      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

OnBIFFComplete

  • メールチェック成功
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      メールチェックが成功した時に、呼び出されるイベントです。
      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 +0900
      Received: 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 +0900
      Date: Sat, 05 Apr 2003 22:03:51 +0900
      From: xxxx@xxxx.jp
      To: xxxx@xxxx.jp
      Subject: testmail
      Message-Id: <20030405220343.5FE8.xxxx@xxxx.jp>
      MIME-Version: 1.0
      Content-Type: text/plain; charset="US-ASCII"
      Content-Transfer-Encoding: 7bit
      X-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

OnBIFFFailure

  • メールチェック失敗
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      何らかの理由でメールチェックが失敗した場合に発生するイベントです。
      このイベントが発生した場合、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

外部アプリ-きのこイベント

OnKinokoObjectChanged?

  • きのこスキンを切り替えた際に発生。
    icon_s.pngicon_m.png
    • 解説
      きのこスキンを切り替えた際に発生。
    • パラメータ
      Reference0切り替えた後のきのこの情報。
      Reference1切り替えた後のきのこの情報。
      Reference2切り替えた後のきのこの情報。

OnKinokoObjectChanging?

  • きのこスキンを切り替えようとしている際に発生。
    icon_s.pngicon_m.png
    • 解説
      きのこスキンを切り替えようとしている際に発生。
    • パラメータ
      Reference0切り替える直前のきのこの情報。
      Reference1切り替える直前のきのこの情報。
      Reference2切り替える直前のきのこの情報。

OnKinokoObjectCreate?

  • きのこスキンが頭に生えた際に発生。
    icon_s.pngicon_m.png
    • 解説
      きのこスキンが頭に生えた際に発生。
    • パラメータ
      Reference0そのきのこの情報。
      Reference1そのきのこの情報。
      Reference2そのきのこの情報。

OnKinokoObjectDestroy?

  • きのこスキンが頭から消えた際に発生。Reference0
    icon_s.pngicon_m.png
    • 解説
      きのこスキンが頭から消えた際に発生。Reference0
    • パラメータ
      Reference1そのきのこの情報。
      Reference2そのきのこの情報。

OnKinokoObjectInstalled?

  • きのこスキンをドロップでインストールした際に発生。
    icon_s.pngicon_m.png
    • 解説
      きのこスキンをドロップでインストールした際に発生。
    • パラメータ
      Reference0インストールされたきのこの情報。
      Reference1インストールされたきのこの情報。
      Reference2インストールされたきのこの情報。

OnSysResourceCritical?

  • システムリソースが20%を切った際に発生。
    icon_s.pngicon_m.png
    • 解説
      システムリソースが20%を切った際に発生。

OnSysResourceLow?

  • システムリソースが40%を切った際に発生。
    icon_s.pngicon_m.png
    • 解説
      システムリソースが40%を切った際に発生。

外部アプリ-猫どりふイベント

OnNekodorifObjectDodge?

  • ヒットしなかった落下物が可視領域内から消滅した際に発生。
    icon_s.pngicon_m.png
    • 解説
      ヒットしなかった落下物が可視領域内から消滅した際に発生。
    • パラメータ
      Reference0落下物の名前。
      Reference1落下物の対象ゴースト名。
      Reference2落下物のカテゴリ名。
      Reference3きのこフラグ。きのこにあった場合は1、そうでなければ0。
      Reference4落下物のターゲット名。

OnNekodorifObjectDrop?

  • 落下物を再投下する際に発生。
    icon_s.pngicon_m.png
    • 解説
      落下物を再投下する際に発生。
    • パラメータ
      Reference0落下物の名前。
      Reference1落下物の対象ゴースト名。
      Reference2落下物のカテゴリ名。
      Reference3きのこフラグ。きのこにあった場合は1、そうでなければ0。
      Reference4落下物のターゲット名。

OnNekodorifObjectEmerge?

  • 落下物が可視領域内に出現した際に発生。
    icon_s.pngicon_m.png
    • 解説
      落下物が可視領域内に出現した際に発生。
    • パラメータ
      Reference0落下物の名前。
      Reference1落下物の対象ゴースト名。
      Reference2落下物のカテゴリ名。
      Reference3きのこフラグ。きのこにあった場合は1、そうでなければ0。
      Reference4落下物のターゲット名。

OnNekodorifObjectHit?

  • 落下物がヒットした際に発生。
    icon_s.pngicon_m.png
    • 解説
      落下物がヒットした際に発生。
    • パラメータ
      Reference0落下物の名前。
      Reference1落下物の対象ゴースト名。
      Reference2落下物のカテゴリ名。
      Reference3きのこフラグ。きのこにあった場合は1、そうでなければ0。
      Reference4落下物のターゲット名。

OnNekodorifObjectVanish?

  • ヒットした落下物が可視領域内から消滅した際に発生。
    icon_s.pngicon_m.png
    • 解説
      ヒットした落下物が可視領域内から消滅した際に発生。
    • パラメータ
      Reference0落下物の名前。
      Reference1落下物の対象ゴースト名。
      Reference2落下物のカテゴリ名。
      Reference3きのこフラグ。きのこにあった場合は1、そうでなければ0。
      Reference4落下物のターゲット名。

外部アプリイベント

OnApplicationBoot?

  • 外部アプリケーションが起動した際に発生。
    icon_s.pngicon_m.png
    • 解説
      外部アプリケーションが起動した際に発生。
    • パラメータ
      Reference0アプリケーション名。
      Reference1アプリケーションの情報。

OnApplicationClose?

  • 外部アプリケーションが終了した際に発生。
    icon_s.pngicon_m.png
    • 解説
      外部アプリケーションが終了した際に発生。
    • パラメータ
      Reference0アプリケーション名。
      Reference1アプリケーションの情報。

OnApplicationExist?

  • 外部アプリケーションの存在を通知された際に発生。
    icon_s.pngicon_m.png
    • 解説
      外部アプリケーションの存在を通知された際に発生。
    • パラメータ
      Reference0アプリケーション名。
      Reference1アプリケーションの情報。

OnApplicationFileOpen?

  • 外部アプリケーションがドキュメントファイルを開いた際に発生。
    icon_s.pngicon_m.png
    • 解説
      外部アプリケーションがドキュメントファイルを開いた際に発生。
    • パラメータ
      Reference0アプリケーション名。
      Reference1ファイルのフルパス。

OnApplicationOperationFinish?

  • 外部アプリケーションか何らかの処理が完了した際に発生。
    icon_s.pngicon_m.png
    • 解説
      外部アプリケーションか何らかの処理が完了した際に発生。
    • パラメータ
      Reference0アプリケーション名。
      Reference1処理の内容。
      Reference2処理の対象。

OnApplicationVersion?

  • 外部アプリケーションのバージョン情報を通知された際に発生。
    icon_s.pngicon_m.png
    • 解説
      外部アプリケーションのバージョン情報を通知された際に発生。
    • パラメータ
      Reference0アプリケーション名。
      Reference1アプリケーションの情報。
      Reference2バージョン番号。
      Reference3著作権。
      Reference4開発元のURL。

OnWebsiteUpdateNotify?

  • ウェブサイトの更新・新着情報を通知された際に発生。
    icon_s.pngicon_m.png
    • 解説
      ウェブサイトの更新・新着情報を通知された際に発生。
    • パラメータ
      Reference0ウェブサイト名。
      Reference1最終更新日時。
      Reference2更新内容。

時間イベント

OnMinuteChange?

  • 分変化
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      現在時刻の分の単位が変更された時に呼ばれるイベントです。
    • パラメータ
      Reference0連続起動時間(単位:時間)
      Reference1見切れフラグ(1-見切れ中、0-通常)
      Reference2重なりフラグ(1-重なり中、0-通常)
      Reference3cantalkフラグ(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

OnSecondChange?

  • 秒変化
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      現在時刻の秒の単位が変更された時に呼ばれるイベントです。
    • パラメータ
      Reference0連続起動時間(単位:時間)
      Reference1見切れフラグ(1-見切れ中、0-通常)
      Reference2重なりフラグ(1-重なり中、0-通常)
      Reference3cantalkフラグ(1-実際に再生される、0-再生されない)
    • サンプル
      GET SHIORI/3.0
      Sender: crow
      ID: OnSecondChange
      Reference0: 2
      Reference1: 0
      Reference2: 0
      Reference3: 1
      SecurityLevel: local
      Charset: Shift_JIS
      SHIORI/3.0 204 No Content

時計合わせイベント

OnSNTPBegin

  • 時計合わせ開始
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      時計合わせイベントが指示された直後に発生するイベントです。
      この後、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

OnSNTPCompare

  • 時計合わせ情報取得
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      SNTPサーバより情報の取得に成功した時に、呼び出されるイベントです。
      Reference1,2 には、それぞれSNTPサーバとローカルマシンの時刻が、次の順番に、
      半角カンマで区切られて代入されます。
      (年),(月),(日),(時),(分),(秒),
    • 補足
      SSPでは、代入される時刻に、ミリ秒単位の項目が追加されて、
      (年),(月),(日),(時),(分),(秒),(ミリ秒)
      …と送られてきます。
    • パラメータ
      Reference0接続先のSNTPサーバ名
      Reference1カンマでセパレートされた正確な(SNTP サーバ側の)時刻
      Reference2カンマでセパレートされた現在の(自分のマシン側の)時刻
      Reference3SNTPサーバと自分のマシンとの時刻のずれ(秒,常に正)
    • サンプル
      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

OnSNTPCorrect

  • 時計合わせ完了
    icon_s.png
    • 解説
      さくらスクリプトの「\6」タグ処理により、時計合わせが実際に行われた直後に呼び出されるイベントです。
    • 補足
      MATERIA 583 では、このイベントは発生しません。
      また、Reference1はSSPのみ発生し、それぞれSNTPサーバとローカルマシンの時刻が、
      次の順番に、半角カンマで区切られて代入されます。
      (年),(月),(日),(時),(分),(秒),(ミリ秒)
    • パラメータ
      Reference0接続先のSNTPサーバ名
      Reference1カンマでセパレートされた正確な(SNTP サーバ側の)時刻(SSPのみ)

OnSNTPFailure

  • 時計合わせ情報取得失敗
    icon_s.pngicon_m.png
    • 解説
      何らかの理由でSNTPサーバから情報が得られなかった場合に発生するイベントです。
    • パラメータ
      Reference0接続先のSNTPサーバ名

消滅イベント

OnOtherGhostVanished?

  • 他のゴーストが消えた
    icon_s.png
    • 解説
      前のゴーストが、消滅指示イベント(または「 \![vanishbymyself] 」タグ実行)によって消滅した後に、
      何か別のゴーストに切り替えられた際に、
      その時に同時起動していたほかのゴーストに通知されるイベントです。
      Vanishして切り替えられた先にはOnVanishedイベントが通知されます。
    • パラメータ
      Reference0消されたゴーストの\0名(sakuraname)
      Reference1消されたゴーストのOnVanishSelected?イベントで喋ったスクリプト
      Reference2消されたゴーストのフル名称(name)

OnVanishButtonHold?

  • 消滅指示後のキャンセル
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      「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

OnVanishCancel?

  • 消滅指示取り消し
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      「OnVanishSelecting」イベントで表示された指示確認のダイアログボックスで
      「指示を取り消す」旨の選択が行なわれた時に発生します。
    • サンプル
      GET SHIORI/3.0
      Sender: crow
      ID: OnVanishCancel
      SecurityLevel: local
      Charset: Shift_JIS
      SHIORI/3.0 200 OK
      Value: \0\s[0]消滅指示が取り消されました。\e

OnVanished?

  • ゴースト切り替え(前ゴースト消滅時)
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      前のゴーストが、消滅指示イベント(または「 \![vanishbymyself] 」タグ実行)によって消滅した後に、
      自分に切り替えられ、切り替え処理が完了後、
      「OnGhostChanged」の代わりに一番最初に呼ばれるイベントです。
    • 補足
      このイベントに返答しない(204またはエラーを返した)場合、「OnGhostChanged」が発生します。
      また、MATERIA Phase583 では、Reference0 は空データが送られてきます。
      Reference1,2,7はSSP(1.10以降)でのみ利用できます。
    • パラメータ
      Reference0消されたゴーストの\0名(sakuraname)
      Reference1消されたゴーストのOnVanishSelected?イベントで喋ったスクリプト [SSP]
      Reference2消されたゴーストのフル名称(name) [SSP]
      Reference7シェルの名前 [SSP]

OnVanishSelected?

  • 消滅指示実行
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      「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]消滅指示を実行します。

OnVanishSelecting?

  • 消滅が指示された
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      ポップアップメニュー等から「消滅指示」が指示された直後に発生するイベントです。
      この後「消滅を実行しますか?」と確認のダイアログ・ボックスが出ます。
    • 補足
      さくらスクリプト/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

情報通知イベント

basewareversion

  • 実行環境のバージョン通知
    icon_c.pngicon_s.png
    • 解説
      今現在ゴーストを実行中の環境のバージョンを通知します。
      例:
      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のみ)

installedghostname

  • インストールされているゴーストの名前を通知
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      現在インストールされている、全ゴーストの名前を通知します。
      この「全ゴースト」には自分自身も含みます。
    • 補足
      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: リリス

OnNotifyDressupInfo?

  • 着せ替え情報の通知
    icon_s.png
    • 解説
      Reference0以降にバイト値1で区切りで以下の情報を通知
      キャラクターID [1] カテゴリー名 [1] パーツ名 [1] オプション [1] 有効1/無効0 [1] サムネイルパス
    • 補足
      http://emily.shillest.net/specwiki/index.php?SSP%2F%E4%BB%95%E6%A7%98%E6%9B%B8%2FOnNotifyDressupInfo

OnNotifyOSInfo

  • OS情報の通知
    icon_s.png
    • 解説
      現在ゴーストが動作しているOSの情報を通知します。
      読み込み時のタイミングに一度だけ通知されますので
      後で利用したい場合は、どこかにこの情報を保持しておく必要があります。
    • パラメータ
      Reference0システム,バージョン (例:WindowsNT,5.00)
      Reference1CPUタイプ,クロックMHz,その他の追加情報 (例:GenuineIntel?,2550,3.15.2.7,ffffffff)
      Reference2物理,仮想メモリ の空き容量(KB)
      Reference3システム起動からの経過時間

OnNotifySelfInfo?

  • ゴースト自身の情報通知
    icon_c.pngicon_s.png
    • 解説
      ゴーストが起動した際に、そのゴースト自身の情報がまとめて通知されます。
    • 補足
      このイベントはNotifyイベントです。スクリプトを返しても再生されません。
      Reference5、Reference6はSSP 1.10.04以降での追加です。
    • パラメータ
      Reference0ゴースト名
      Reference1Sakura名
      Reference2Kero名
      Reference3起動時のシェル名
      Reference4起動時のシェルのパス (例: shell/master/) 絶対パスか相対パスかは処理系依存
      Reference5起動時のバルーン名
      Reference6起動時のバルーンのパス (例: balloon/master/) 絶対パスか相対パスかは処理系依存

OnNotifyUserInfo?

  • ユーザ情報通知
    icon_s.png
    • 解説
      ゴーストが起動した際、またはユーザ情報が変更された際に、ユーザ情報を通知します。
    • 補足
      このイベントはNotifyイベントです。
      スクリプトを返しても再生されません。
    • パラメータ
      Reference0呼び方(ニックネーム)
      Reference1フルネーム
      Reference2誕生日 カンマ区切りで 年,月,日 のように
      Reference3性別

otherghostname

  • 同時起動しているゴーストの名前を通知
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      他に同時起動しているゴーストそれぞれについて、
      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: リリス

ownerghostname

  • 現在のゴースト名を通知
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      現在のゴースト、つまり自分自身の名前を通知します。
    • パラメータ
      Reference0sakura側キャラクターの名前
    • サンプル
      NOTIFY SHIORI/3.0
      Charset: Shift_JIS
      ID: ownerghostname
      Reference0: リリス
      SecurityLevel: local
      Sender: crow
      SHIORI/3.0 204 No Content
      Charset: Shift_JIS
      Sender: リリス

rateofusegraph

  • 使ってるぞグラフの内容表示
    icon_s.png
    • 解説
      使ってるぞグラフの情報をそのまま通知します。
      起動中何度も通知される可能性があります。
    • 補足
      Reference0以降には以下のフォーマットで情報が入ります。
      なお、[1]はバイト値1です。
      名前(name)[1]sakura名[1]kero名[1]起動回数[1]起動時間(分)[1]起動時間%[1](boot|install|vanish)
      bootは起動中、installはインストールされている、vanishはログのみに情報が残存を示します。
    • パラメータ
      Reference0(補足参照)

状態変更イベント

OnBoot?

  • 通常起動
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      本体起動時に発生するイベントです。
    • 補足
      インストール後初めての起動の場合は、このイベントは呼ばれず、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

OnClose?

  • 終了指示
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      本体終了が指示された時に発生するイベントです。
      通常は、本体終了タグ(\-)を含んだ応答を返す必要があります。
      本体終了タグが含まれていないと、終了しません。
    • パラメータ
      Reference0終了理由 userならユーザーがメニュー操作にて終了、shutdownならWindowsシャットダウン(SSP/2.01.71以降)
    • サンプル
      GET SHIORI/3.0
      Sender: crow
      ID: OnClose
      SecurityLevel: local
      Charset: Shift_JIS
      SHIORI/3.0 200 OK
      Value: \0\s[0]終了\-\e

OnCloseAll?

  • 全ゴースト終了指示
    icon_s.png
    • 解説
      本体終了が指示された時に発生するイベントです。
    • パラメータ
      Reference0終了理由 userならユーザーがメニュー操作にて終了、shutdownならWindowsシャットダウン(SSP/2.01.69以降)
    • 補足
      OnCloseと異なり、本体終了タグが含まれていない場合でも、
      スクリプトの再生終了時点で強制的に終了される点に注意してください。

OnDisplayChange?

  • デスクトップ変化
    icon_s.png
    • 解説
      デスクトップの解像度や色深度が変化した時に発生します。
    • 補足
      ゴーストの起動時にも、その時点でのデスクトップの状態を送る目的で発生します。
      +(Notifyイベント)+
    • パラメータ
      Reference0画面の色深度(bit)
      Reference1画面の解像度(横方向ドット数=幅)
      Reference2画面の解像度(縦方向ドット数=高さ)

OnFirstBoot?

  • 初回起動
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      ゴーストインストール後の一番最初の起動において、
      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

OnShellScaling?

  • シェル拡大/縮小率変更
    icon_s.png
    • 解説
      シェル拡大/縮小率が変更されたときに通知されます。
    • パラメータ
      Reference0新しい拡大率ヨコ(X)
      Reference1元の旧い拡大率ヨコ(X)
      Reference2新しい拡大率タテ(Y)
      Reference3元の旧い拡大率タテ(Y)

OnWindowStateMinimize?

  • 最小化
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      アイコン化を選んだときに発生するイベントです。
      サイレントイベントのため、応答があっても無視されます。
    • サンプル
      GET SHIORI/3.0
      Sender: crow
      ID: OnWindowStateMinimize
      SecurityLevel: local
      Charset: Shift_JIS
      SHIORI/3.0 204 No Content
      Charset: Shift_JIS

OnWindowStateRestore?

  • 最小化復帰
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      アイコン化解除が指示された時に発生するイベントです。
      実際にアイコン化解除処理が行われたあとに、この応答が処理されます。
    • 補足
      このイベントが応答を返さないと、何も表示されない状態になります。
      必ず、サーフィスを表示するタグを応答に含めてください。
      なお、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

切り替えイベント

OnGhostCallComplete?

  • ゴースト呼び出し完了(呼び出し元)
    icon_s.png
    • 解説
      複数ゴースト起動機能において、ゴーストの呼び出し機能でのゴーストが起動が完了して、
      起動スクリプトを喋り終わったタイミングで、呼び出し元(呼び出し操作を実行したゴースト)に通知されます。
    • 補足
      SSP 1.10.16より実装。通知される「起動スクリプト」は、OnGhostCalledの反応とは限りません。
    • パラメータ
      Reference0呼び出し先ゴーストの\0側の名前
      Reference1呼び出し先ゴーストの起動スクリプト
      Reference2呼び出し先ゴーストのフルネーム(nameエントリ)
      Reference7呼び出し先ゴーストの起動時のシェル

OnGhostCalled?

  • ゴースト呼び出し完了
    icon_s.png
    • 解説
      複数ゴースト起動機能において、ゴーストの呼び出し機能でゴーストが起動された場合に通知されます。
      このイベントを無視した場合(204、その他エラー、または空スクリプトを返した場合)、
      通常のOnBootが再度通知されます。
    • 補足
      SSP 1.09.18より仮実装、1.10以降より正式に利用可能。
    • パラメータ
      Reference0呼び出し元ゴーストの\0側の名前
      Reference1呼び出し元ゴーストのOnGhostCalling?反応スクリプトもしくは\![call,ghost]を含むスクリプト
      Reference2呼び出し元ゴーストのフルネーム(nameエントリ)
      Reference7シェルの名前

OnGhostCalling?

  • ゴースト呼び出し中
    icon_s.png
    • 解説
      複数ゴースト起動機能において、ゴーストの呼び出し開始時に呼び出し操作を行ったゴーストに通知されます。
    • 補足
      SSP 1.09.18より仮実装、1.10以降より正式に利用可能。
      呼び出しメソッドのautomaticは現在のところ利用されていません。
    • パラメータ
      Reference0次のゴーストの\0側の名前
      Reference1呼び出しメソッド(manual/automatic)
      Reference2次のゴーストのフルネーム(nameエントリ)
      Reference3次のゴーストがインストールされているファイルパス [SSP]

OnGhostChanged?

  • ゴースト切り替え完了
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      ゴースト切り替え完了後に、最初に呼ばれるイベントです。
    • 補足
      切り替えた先のゴーストがインストール後初の呼び出しだった場合、
      このイベントは発生せず、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

OnGhostChanging?

  • ゴースト切り替え指示
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      別のゴーストへの切り替えが指示された時に発生するイベントです。
      自分自身へ切り替えたときにも発生します。
    • 補足
      メニューから切り替えた際には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

OnOtherGhostBooted?

  • 他のゴーストが起動
    icon_s.png
    • 解説
      複数ゴースト起動機能において、同時起動中の他のゴーストの呼び出し機能でのゴーストが起動が完了して、
      起動スクリプトを喋り終わったタイミングで、呼び出し元(呼び出し操作を実行したゴースト)以外に通知されます。
    • 補足
      実装時期不明。通知される「起動スクリプト」は、OnGhostCalledの反応とは限りません。
    • パラメータ
      Reference0呼び出し先ゴーストの\0側の名前
      Reference1呼び出し先ゴーストの起動スクリプト
      Reference2呼び出し先ゴーストのフルネーム(nameエントリ)
      Reference7呼び出し先ゴーストの起動時のシェル

OnOtherGhostChanged?

  • 他のゴーストが切り替え完了
    icon_s.png
    • 解説
      自分以外のゴースト切り替え完了後に呼ばれるイベントです。
    • 補足
      他のゴーストが切り替わった際に発生します。
      基本的なReferenceの構成はOnOtherGhostBootedと同じですが、
      切り替わり前と後の2倍の情報が必要になりますので、
      解決策として交互にReferenceを詰めていく方法を取りました。
      Reference14: 前 - シェル名
      Reference15: 後 - シェル名
    • パラメータ
      Reference0前 - さくら名
      Reference1後 - さくら名
      Reference2前 - OnGhostChanging?スクリプト
      Reference3後 - OnGhostChanged?/OnBoot?スクリプト
      Reference4前 - 名前(descript.txtのname)
      Reference5後 - 名前(descript.txtのname)

OnOtherGhostClosed?

  • 同時起動中のほかのゴーストが終了した
    icon_s.png
    • 解説
      同時起動中のほかのゴーストが終了した後に、呼ばれるイベントです。
      具体的には、\-が実行された時点で他に通知されます。
    • 補足
      OnGhostChangedなどと同じ書式です。 SSP 1.10.24から実装されています。
    • パラメータ
      Reference0終了したゴーストの\0側の名前
      Reference1終了したゴーストの最後のスクリプト
      Reference2終了したゴーストのフルネーム(nameエントリ) [SSP/CROW]

OnShellChanged?

  • シェル切り替え完了
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      別のシェルへの切り替えが指示された時に発生するイベントです。
      今までと同じシェルへ切り替えたときにも発生します。
    • 補足
      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

OnShellChanging?

  • シェル切り替え指示
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      別のシェルへの切り替えが指示された時に発生するイベントです。
    • 補足
      シェルインストールにより切り替わった場合は、このイベントは発生しません。
      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

選択肢イベント

OnAnchorSelect?

  • アンカークリック
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      アンカーをクリックしたときに発生するイベントです。
    • 補足
      アンカーがクリックされても、このイベントに応答を返さなければバルーンは閉じず、
      そのままの状態を維持します。
    • パラメータ
      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

OnAnchorSelectEx?

  • アンカークリック(拡張情報付き)
    icon_s.png
    • 解説
      アンカーをクリックしたときに発生するイベントです。
    • 補足
      アンカーがクリックされても、このイベントに応答を返さなければバルーンは閉じず、
      そのままの状態を維持します。
    • パラメータ
      Reference0選択されたアンカー
      Reference1選択されたアンカーが持つ識別子
      Reference2以降拡張情報

OnChoiceEnter?

  • 選択肢フォーカス変化
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      アンカー以外の選択肢の上にカーソルが乗った瞬間および外れた瞬間に発生するイベントです。
      外れた際は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

OnChoiceHover?

  • 選択肢上でマウスが「しばらく上で止まっている」
    icon_s.png
    • 解説
      OnMouseHoverのバルーン版。
      マウスが「しばらく上で止まっている」時に起こります。
      ツールチップ表示とタイミングは(ほぼ)同じ。
    • 補足
      SSP/2.01.62以降
    • パラメータ
      Reference0なにか話して(F12)  <-選択肢ラベル
      Reference1Choice_AITALK <-選択肢ID(これ以降選択肢Reference指定が挿入される)

OnChoiceSelect?

  • 選択肢クリック
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      選択肢をクリックした時に発生するイベントです。
    • パラメータ
      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

OnChoiceSelectEx?

  • 選択肢クリック(拡張情報付き)
    icon_s.png
    • 解説
      選択肢をクリックした時に発生するイベントです。
    • パラメータ
      Reference0選択された選択肢
      Reference1選択された選択肢が持つ識別子
      Reference2以降拡張情報

OnChoiceTimeout?

  • 選択肢タイムアウト
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      選択肢がタイムアウトしたときに発生するイベントです。
      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

入力ボックスイベント

OnCommunicate?

  • コミュニケート
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      外部から話し掛けられた瞬間に発生するイベントです。
      ユーザから話し掛けられた場合、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

OnCommunicateInputCancel?

  • CommunicateBox?入力中止
    icon_s.png
    • 解説
      CommunicateBoxが閉じられた際に発生。
    • 補足
      SSP/2.01.07以降
    • パラメータ
      Reference0(空欄)
      Reference1cancel(×やESCで閉じた)

OnTeachStart?

  • TeachBox?オープン
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      TeachBoxがオープンした際に発生するイベントです。
    • サンプル
      GET SHIORI/3.0
      Sender: crow
      ID: OnTeachStart
      SecurityLevel: local
      Charset: Shift_JIS
      SHIORI/3.0 204 No Content
      Charset: Shift_JIS

OnTeachInputCancel?

  • TeachBox?入力中止
    icon_s.png
    • 解説
      TeachBoxが閉じられた際に発生。
    • 補足
      SSP/2.01.07以降
    • パラメータ
      Reference0(空欄)
      Reference1cancel(×やESCで閉じた)

OnUserInput?

  • InputBox?クローズ
    icon_c.pngicon_s.pngicon_m.png
    • 解説
      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

OnUserInputCancel?

  • InputBox?入力中止
    icon_s.png
    • 解説
      InputBoxを×を押して閉じたり、タイムアウトした際に発生するイベントです。
    • 補足
      OnUserInputCancel Reference1: timeoutに応答しない場合、
      互換のため続けてOnUserInput Reference1: timeoutが発生します。
    • パラメータ
      Reference0\![open,inputbox]で指定した識別子
      Reference1close - ×で閉じた / timeout - タイムアウト

添付ファイル: fileicon_m.png 544件 [詳細] fileicon_s.png 606件 [詳細] fileicon_c.png 524件 [詳細]

トップ   編集 凍結 差分 バックアップ 添付 複製 名前変更 リロード   新規 一覧 検索 最終更新   ヘルプ   最終更新のRSS
Last-modified: 2010-02-04 (木) 08:02:09