起動/終了/切換事件

OnFirstBoot

初次起動

解說
人格安裝後第一次起動時代替OnBootOnGhostChanged事件而觸發的事件。
補足
那人格如果之前有反安裝過的話,
反安裝的次數會傳入到Reference0中。
沒有的話,Reference0會填入0。
參數
Reference0人格的反安裝次數
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

OnBoot

通常起動

解說
本體起動時觸發此事件。
補足
安裝後初次起動時,會不觸發此事件改為觸發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

終了指示

解說
關閉人格被指示時觸發此事件。
必須要包含本體終了標籤(\-)在回應。
沒有本體終了標籤的話會關閉不了。
參數
Reference0終了理由 user為使用者從右鍵選單中選擇關閉指令,shutdown為視窗關機(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

全部人格終了指示

解說
本体關閉被指示時觸發此事件。
補足
注意:和OnClose不一樣,就算沒有本體終了標籤也好,Sakura Script執行完成後會強制關閉。
參數
Reference0終了理由 user為使用者從右鍵選單中選擇關閉指令,shutdown為視窗關機(SSP/2.01.69以後)

OnGhostChanged

切換人格完成

解說
切換人格完成後,最初會觸發此事件。
補足
切換到的人格是安裝後首次登場時,就不會觸發此事件而改為觸發OnFirstBoot事件。
Reference2只有SSP,CROW會填入。
Reference7只有SSP會填入。
參數
Reference0之前的人格\0側的名稱
Reference1之前的人格最後的Sakura Script
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

正在切換人格

解說
切換到其他人格時會觸發此事件。
自己切換到自己時也會觸發此事件。
補足
從右鍵選單中選取切換人格時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

OnGhostCalled

呼叫人格完成(被呼叫的一方)

解說
複數人格起動功能中,被呼叫的一方起動時觸發此事件。
不回應這事件時(204,其他錯誤,又或者是回傳空字串時),
通常會再次觸發OnBoot事件。
補足
SSP 1.09.18中暫時實裝,1.10以後正式可以使用。
參數
Reference0呼叫人格的一方\0側的名稱
Reference1呼叫人格的一方的OnGhostCalling回應Sakura Scipt或是含有\![call,ghost]的Sakura Scipt
Reference2呼叫人格的一方的名稱(name項目)
Reference7外表名稱

OnGhostCalling

呼叫人格中

解說
複數人格起動功能中,呼叫人格開始時呼叫人格的一方會觸發此事件。
補足
SSP 1.09.18中暫時實裝,1.10以後正式可以使用。 呼叫方法的automatic現時沒被使用。
參數
Reference0被呼叫的人格\0側的名稱
Reference1呼叫方法(manual/automatic)
Reference2被呼叫的人格名稱(name項目)
Reference3被呼叫的人格所安裝到的路徑 [SSP]

OnGhostCallComplete

呼叫人格完成(呼叫人格的一方)

解說
複數人格起動功能中,使用呼叫人格起動另一人格完成後,起動Sakura Scipt執行完成後,呼叫人格的一方就會觸發此事件。
補足
SSP 1.10.16中實裝。被通知的「起動Sakura Script」不限於OnGhostCalled
參數
Reference0被呼叫的人格\0側的名稱
Reference1被呼叫的人格的起動Sakura Script
Reference2被呼叫的人格名稱(name項目)
Reference7被呼叫的人格起動時的外表

OnOtherGhostBooted

其他人格起動

解說
複數人格起動功能中,使用呼叫人格起動另一人格完成後,起動Sakura Scipt執行完成後,其他同時起動中的人格(執行呼叫動作的人格)會觸發此事件。
補足
實裝時期不明。被通知的「起動Sakura Script」不限於OnGhostCalled
參數
Reference0被呼叫的人格\0側的名稱
Reference1被呼叫的人格的起動Sakura Script
Reference2被呼叫的人格名稱(name項目)
Reference7被呼叫的人格起動時的外表

OnOtherGhostChanged

其他人格切換完成

解說
自己以外的人格切換完成時會觸發此事件。
補足
其他人格切換完成時也會觸發此事件。
基本上Reference的構成和OnOtherGhostBooted一樣,但是切換前後的資料都是需要的導致兩倍資料量,最後以Reference前後交替的方法解決。
參數
Reference0前 - 主菜名稱
Reference1後 - 主菜名稱
Reference2前 - OnGhostChanging回傳的Sakura Script
Reference3後 - OnGhostChanged/OnBoot回傳的Sakura Script
Reference4前 - 人格名稱(descript.txt的name項目)
Reference5後 - 人格名稱(descript.txt的name項目)
Reference14前 - 外表名稱
Reference15後 - 外表名稱

OnOtherGhostClosed

其他同時起動中的人格關閉

解說
其他同時起動中的人格關閉後會觸發此事件。
具体來說,執行\-標籤時就通知其他人格。
補足
OnGhostChanged等一樣的格式。 SSP 1.10.24中實裝。
參數
Reference0關閉了的人格\0側的名稱
Reference1關閉了的人格最後的Sakura Script
Reference2關閉了的人格的名稱(name項目) [SSP/CROW]

OnShellChanged

外表切換完成

解說
切換到其他外表後觸發此事件。
切換到相同的外表也會觸發此事件。
補足
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

外表切換指示

解說
切換其他外表的指示下達後觸發此事件。
補足
因安裝外表而切換時,不會觸發此事件。
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

OnDressupChanged

衣物更換通知。

補足
此通知事件可能會複數通知。先處理衣物群組相關的自動穿脫通知後才通知使用者。
參數
Reference0人物視窗ID(0=Sakura 1=Kero 2...)
Reference1衣物部件名稱
Reference20=脫 1=穿

OnBalloonChange

更換對話框。

補足
1.10.04開始實裝。 ※之前試驗實裝時不通知Reference1的路徑。
參數
Reference0對話框名稱
Reference1對話框路徑 (可能依照伺か平台不同而傳入相對路徑或絕對路徑,SSP會傳入絕對路徑)

OnWindowStateRestore

從最小化還原

解說
解除最小化被指示時觸發此事件。
實際從最小化還原後會執行此事件的回應。
補足
不回應這事件的話,會變成什麼都不顯示的狀態。
所以必須回傳會顯示表情的標籤。
另外,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

OnWindowStateMinimize

最小化

解說
點選最小化後觸發此事件。
因為是安靜的事件,所以回傳的Sakura Script不會被執行。
例子
GET SHIORI/3.0
Sender: crow
ID: OnWindowStateMinimize
SecurityLevel: local
Charset: Shift_JIS

SHIORI/3.0 204 No Content
Charset: Shift_JIS

OnFullScreenAppMinimize

全屏應用啟動導致ssp最小化時被觸發
其餘情况下都會觸發OnWindowStateMinimize事件。

OnFullScreenAppRestore

全屏應用結束導致的SSP從最小化狀態恢復時被觸發。
其餘情况下都會觸發OnWindowStateRestore事件。

OnVirtualDesktopChanged

切换虚拟桌面时被触发,Windows 10之后的系统有效。
这个属于测试性质的功能,实际上可能会更改。

參數
Reference0current:人格顯示在當前虛擬桌面上 hidden:人格被切換到當前隱藏起來的虛擬桌面上 minimize:由於視窗最小化,人格顯示在哪邊的虛擬桌面上不明確的狀況
Reference1當前虛擬桌面的ID

OnCacheRestore

從 Ghost 預備暫存區中回復時通知。

解說
ghost關閉後,從 Ghost 預備暫存區中回復時發生的通知。有什麼要在關閉後處理的話就得在這時候處理了。

OnCacheSuspend

Ghost 關閉後存入預備暫存區時通知。

OnInitialize

Ghost 起動,SHIORI載入記憶體中後的第一個通知。

補足
此為通知事件(Notify),回傳什麼也不會顯示。

OnDestroy

Ghost 關閉,SHIORI從記憶體中解放前最後的通知。

補足
此為通知事件(Notify),回傳什麼也不會顯示。

OnSysResume

從系統待機中回復。

OnSysSuspend

系統從入待機狀態。

補足
此為通知事件(Notify),回傳什麼也不會顯示。

OnBasewareUpdating

ssp有更新,下載檔案開始安裝更新時被觸發。沒有寫這個事件時會跳過它依次執行OnCloseAll、OnClose事件

參數
Reference0更新之前的版本號 例:2.3.58
Reference1和更新之前的windowsExplorer中顯示内容相同的版本號 例:2.3.58.3000

OnBasewareUpdated

ssp更新結束後,人格再次啟動時被觸發。如果沒有寫這個事件則會跳過它來執行OnBoot事件

參數
Reference0更新後的版本號 例:2.3.59
Reference1與更新後的windows瀏覽器顯示裏相同的版本號 例:2.3.59.3000

輸入框事件

OnTeachStart

開啟TeachBox

解說
開啟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輸入中止

解說
TeachBox被關閉時觸發此事件。
補足
SSP/2.01.07以後
參數
Reference0(空欄)
Reference1cancel(使用×按鈕或ESC鍵關閉)

OnTeach

以 TeachBox 由使用者向 Ghost 教育。

參數
Reference0使用者輸入
Reference1使用者對Reference0的補充輸入
例子
紅字為輸入藍字為Shiori輸出 //為註解
GET SHIORI/3.0
ID: OnTeach
Reference0: 伺か //TeachBoxに「伺か」と入れた
SHIORI/3.0 311 Not Enough
Value: \0\s0伺かって何?\e //Reference0(さっき入れたもの)は保存しておいて次を聞く
GET SHIORI/3.0
ID: OnTeach
Reference0: 伺か
Reference1: まてりあ //TeachBoxに「まてりあ」と入れた
SHIORI/3.0 312 Advice
Value: \0\s7まてりあって言われてもわかるかーっ!\1\s[11]まともに教えたってや。\e //さっき入れたReference1は破棄することを指示
GET SHIORI/3.0
ID: OnTeach
Reference0: 伺か
Reference1: 人生をちょっぴり楽しくするモノ //前回のReference1は消え,新たな内容が入る
SHIORI/3.0 200 OK
Value: \0\s0なりゅほろー。\e //311,312以外のステータスコードで会話終了

OnCommunicate

溝通

解說
從外部搭話時觸發此事件。
使用者搭話時,Reference0為user,
人格搭話時,Reference0為該人格的名稱。
參數
Reference0搭話人的名稱(user/人格名稱)
Reference1Sakura Script
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輸入中止

解說
CommunicateBox被關閉時觸發此事件。
補足
SSP/2.01.07以後
參數
Reference0(空欄)
Reference1cancel(使用×按鈕或ESC鍵關閉)

OnUserInput

InputBox被關閉

解說
InputBox被關閉時觸發此事件。
也會有使用者輸入後按[Enter]鍵,或是逾時的情況。
逾時的話,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輸入中止

解說
InputBox按押×按鈕關閉,或是逾時的時候就會觸發此事件。
補足
OnUserInputCancel Reference1: timeout不回應時,
作為互換會繼續觸發OnUserInput Reference1: timeout。
參數
Reference0\![open,inputbox]中指定的識別字
Reference1close - 按×按鈕關閉 / timeout - 逾時

inputbox.autocomplete

開啟輸入框時被觸發。這個事件在使用自動完成輸入時返回值為用byte1值(頓號)區分的字串。(WinMe/2000以後的版本)

參數
Reference0輸入框種類。inputbox/teachbox/communicatebox中任意一個。
Reference1只作用於使用inputbox的情况,確認輸入時被觸發的事件名/參數。

Dialog事件

OnSystemDialog

儲存/OK等選擇完成而關閉標準對話方塊

補足
SSP 2.01.00 RC4實裝。
ID中為On出頭時、就不觸發此事件,改為觸發ID所指定的事件。(2.01.85)
詳細請參照 http://emily.shillest.net/specwiki/index.php?SSP%2F%E4%BB%95%E6%A7%98%E6%9B%B8%2F%E3%82%B3%E3%83%A2%E3%83%B3%E3%83%80%E3%82%A4%E3%82%A2%E3%83%AD%E3%82%B0%E7%B3%BB
參數
Reference0open/save
Reference1--id=所指定的ID / 沒指定時為空字串
Reference2以後選擇資料(按所開啟的對話方塊不同而定)
選擇檔案時為所選擇的檔案路徑
顏色選擇時為R,G,B (例:255,255,255)

OnSystemDialogCancel

按下取消按鈕關閉標準對話方塊

補足
SSP 2.01.00 RC4實裝。
詳細請參照 http://emily.shillest.net/specwiki/index.php?SSP%2F%E4%BB%95%E6%A7%98%E6%9B%B8%2F%E3%82%B3%E3%83%A2%E3%83%B3%E3%83%80%E3%82%A4%E3%82%A2%E3%83%AD%E3%82%B0%E7%B3%BB
參數
Reference0open/save
Reference1--id=所指定的ID / 沒指定時為空字串

OnConfigurationDialogHelp

點擊設定視窗幫助按鈕各項功能時被觸發。

參數
Reference0視窗ID。種類和頁面對應關係如下。setup……一般 ghost……人格(1) ghost2……人格(2) folder……資料夾 display……顯示 talk……對話/對話方塊 network……網絡(1) network2……網絡(2) biff……POP application……其它應用 messenger……IM ipmessenger……IPMessenger international……國際化 developer……開發/其它
Reference1視窗標題。
Reference2項目type:項目名。
Reference3專案內容text。

時間事件

OnSecondChange

秒改變

解說
現在時間的秒改變時觸發此事件。
參數
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

OnMinuteChange

分鐘改變

解說
現在時間的分鐘改變時觸發此事件。
參數
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

OnHourTimeSignal

整點報時事件。時間在(?時0分0秒左右)觸發。
和其它對話衝突時會等其它對話進行完畢後再進行。不一定是準時的。

參數
Reference0作業系統的連續開啟時間(hour)
Reference1超出荧幕時值為1其餘情况均為0。
Reference2(主人格與副人格圖片)重疊時值為1其餘情况均為0。
Reference3可以進行對話時值為1其餘情况為0。
Reference4※僅SSP(作業系統層面的)沒有任何操作,單純被放置的時間。以秒為組織。

反安裝事件

OnOtherGhostVanished

其他人格被消滅

解說
之前的人格被指示反安裝(又或者執行了「 \![vanishbymyself] 」標籤)而消滅後,
切換成任何其他的人格時,此時其他同時起動中的人格就會觸發此事件。
被消滅後而切換成的人格則會觸發OnVanished事件。
參數
Reference0被消滅人格的主菜名(sakuraname)
Reference1被消滅人格的OnVanishSelected事件中說過的Sakura Script
Reference2被消滅人格的名稱(name)

OnVanishButtonHold

反安裝被打斷

解說
OnVanishSelected」事件時正在執行向本體回傳的Sakura Script時,
雙擊對話框的話,則視為取消反安裝(挽留),並觸發此事件。
補足
OnVanishSelecting」事件中,人物被雙擊時也會觸發此事件,
此時除了此事件還同時彈出消滅確認對話框。
這裡選「是」的話會觸發「OnVanishSelected」事件,
再往人物雙擊的話會觸發「OnMouseDoubleClick」事件反安裝事件則被取消。
SSP 1.11起開始傳送Reference0,1。
參數
Reference0被打斷的Sakura Scipt(如果有的話)
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

取消反安裝

解說
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

人格交替(之前的人格被消滅時)

解說
之前的人格被指示反安裝(又或者執行了「 \![vanishbymyself] 」標籤)而消滅後,
自已被交替出來,交替處理完成後,
此事件代替了「OnGhostChanged」成為第一個觸發的事件。
補足
不回應此事件(204又或者回傳錯誤)時,會觸發「OnGhostChanged」事件。
還有,MATERIA Phase583 中,Reference0 會填入空資料。
Reference1,2,7為僅SSP(1.10以後)可以使用。
參數
Reference0被消滅人格的主菜名(sakuraname)
Reference1被消滅人格的OnVanishSelected事件中說過的Sakura Script (僅SSP)
Reference2被消滅人格的名稱(name) (僅SSP)
Reference7外表的名稱 (僅SSP)

OnVanishSelected

執行反安裝

解說
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

被指示反安裝

解說
右鍵選單等點選了「反安裝」後立刻觸發此事件。
在這之後會彈出「要執行反安裝嗎?」的確認對話框。
補足
執行SakuraScript/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

選擇事件

OnAnchorSelect

錨點點擊

解說
錨點被點擊時觸發此事件。
補足
錨點被點擊也好,這事件不回傳的話對話框就不會關閉,一直維持這狀態。
參數
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

錨點點擊(附擴張資料)

解說
錨點被點擊時觸發此事件。
補足
錨點被點擊也好,這事件不回傳的話對話框就不會關閉,一直維持這狀態。
參數
Reference0選擇了的錨點
Reference1選擇了的錨點的識別字
Reference2以後的擴張資料

OnChoiceEnter

選項焦點變化

解說
滑鼠游標進出錨點以外的選項時觸發此事件。
離開時Reference0和Reference1為空字串。
因為是安靜事件,回傳的Sakura Script將不會執行。
補足
決定選項前也會觸發此事件。此時,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

滑鼠游標暫時停留在選項上

解說
OnMouseHover的對話框版本。
滑鼠游標暫時停留在選項時觸發此事件。
和工具提示標籤顯示的時機(差不多)。
補足
SSP/2.01.62以後
參數
Reference0選項標題
Reference1選項識別名
Reference2以下選項擴張資料

OnChoiceSelect

選項點擊

解說
選項被點擊時觸發此事件。
參數
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

選項點擊(附擴張資料)

解說
選項被點擊時觸發此事件。
參數
Reference0選項標題
Reference1選項識別名
Reference2以下選項擴張資料

OnChoiceTimeout

選項逾時

解說
選項逾時的時候會觸發此事件。
Reference0為含有這個選項標籤的Sakura Script。
補足
[MATERIA] 逾時時間約15秒。
[SSP] 逾時時間可由使用者設定。
參數
Reference0含有這個選項標籤的Sakura Script
例子
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

表情事件

OnSurfaceChange

表情變化。

解說
表情變化時會觸發此事件。起變化的表情編號將會傳入。不顯示的話會傳入-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

表情回復。

解說
表情變化後,一定時間後呼叫的事件。
回應此事件說是可以回復原本表情,其實是交由人格自行處理。
還有,此事件當0號(主菜側)的表情編號為 0 而1號(使魔側)的表情編號為 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

滑鼠事件

OnMouseClick

滑鼠點擊

解說
滑鼠點擊時觸發此事件。
補足
SHIORI/3.0仕様中加入了 Reference5 ,就算是右鍵時也會觸發此事件。
而且,由右鍵時觸發此事件時,不回傳錯誤(「200 OK」且有Value回傳)時,
顯示選單(及因此動作而觸發的事件)也不會發生。
參數
Reference0滑鼠游標的 x 座標(本地座標)
Reference1滑鼠游標的 y 座標(本地座標)
Reference2通常為0
Reference3人物視窗ID
Reference4碰撞區域識別名(head/face/bust等)
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

滑鼠雙擊

解說
滑鼠雙擊時觸發此事件。
補足
處理時要考慮沒有Reference5的時候。
參數
Reference0滑鼠游標的 x 座標(本地座標)
Reference1滑鼠游標的 y 座標(本地座標)
Reference2通常為0
Reference3人物視窗ID
Reference4碰撞區域識別名(head/face/bust等)
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

OnMouseUp

滑鼠釋放

解說
滑鼠釋放時觸發此事件。
補足
SSP/2.01.55之後實裝。
參數
Reference0滑鼠游標的 x 座標(本地座標)
Reference1滑鼠游標的 y 座標(本地座標)
Reference2通常為0
Reference3人物視窗ID
Reference4碰撞區域識別名(head/face/bust等)
Reference5被點擊的按鍵(0或沒有數值:左 / 1:右 / 2:中(依存Windows或滑鼠))

OnMouseDown

滑鼠按下

解說
滑鼠按下時觸發此事件。
補足
SSP/2.01.55之後實裝。
參數
Reference0滑鼠游標的 x 座標(本地座標)
Reference1滑鼠游標的 y 座標(本地座標)
Reference2通常為0
Reference3人物視窗ID
Reference4碰撞區域識別名(head/face/bust等)
Reference5被點擊的按鍵(0或沒有數值:左 / 1:右 / 2:中(依存Windows或滑鼠))

OnMouseDragEnd

滑鼠拖曳終了

解說
人格視窗拖曳終了時觸發此事件。
參數
Reference0滑鼠游標的 x 座標(本地座標)
Reference1滑鼠游標的 y 座標(本地座標)
Reference20
Reference3人物視窗ID
Reference4碰撞區域識別名(head/face/bust等)
Reference50

OnMouseDragStart

開始滑鼠拖曳

解說
開始拖曳人格視窗時觸發此事件。
參數
Reference0滑鼠游標的 x 座標(本地座標)
Reference1滑鼠游標的 y 座標(本地座標)
Reference20
Reference3人物視窗ID
Reference4碰撞區域識別名(head/face/bust等)
Reference50

OnMouseEnter

滑鼠游標進入碰撞區域

解說
滑鼠游標進入特定的碰撞區域(head/face/bust等)時觸發此事件。
參數
Reference0滑鼠游標的 x 座標(本地座標)
Reference1滑鼠游標的 y 座標(本地座標)
Reference20
Reference3人物視窗ID
Reference4碰撞區域識別名(head/face/bust等)
Reference50

OnMouseEnterAll

滑鼠游標進入人物視窗

解說
滑鼠游標進入人物視窗時觸發此事件。
不考慮碰撞區域,單純的滑鼠進入人物視窗時就會觸發此事件。
參數
Reference0滑鼠游標的 x 座標(本地座標)
Reference1滑鼠游標的 y 座標(本地座標)
Reference20
Reference3人物視窗ID
Reference4碰撞區域識別名(head/face/bust等)
Reference50

OnMouseHover

滑鼠游標暫時停留在人物上

解說
滑鼠游標暫時停留在人物上時觸發此事件。
和工具提示標籤顯示的時機(差不多)。
補足
SSP/2.01.61以後實裝
參數
Reference0滑鼠游標的 x 座標(本地座標)
Reference1滑鼠游標的 y 座標(本地座標)
Reference2通常為0
Reference3人物視窗ID
Reference4碰撞區域識別名(head/face/bust等)
Reference50

OnMouseLeave

滑鼠游標離開碰撞區域

解說
滑鼠游標離開碰撞區域時觸發此事件。
參數
Reference0滑鼠游標的 x 座標(本地座標)
Reference1滑鼠游標的 y 座標(本地座標)
Reference20
Reference3人物視窗ID
Reference4碰撞區域識別名(head/face/bust等)
Reference50

OnMouseLeaveAll

滑鼠游標離開人物視窗

解說
滑鼠游標離開人物視窗時觸發此事件。
不考慮碰撞區域,單純的滑鼠離開人物視窗時就會觸發此事件。
參數
Reference0滑鼠游標的 x 座標(本地座標)
Reference1滑鼠游標的 y 座標(本地座標)
Reference20
Reference3人物視窗ID
Reference4碰撞區域識別名(head/face/bust等)
Reference50

OnMouseMove

滑鼠移動

解說
滑鼠在外表上移動時觸發此事件。
參數
Reference0滑鼠游標的 x 座標(本地座標)
Reference1滑鼠游標的 y 座標(本地座標)
Reference2通常為0
Reference3人物視窗ID
Reference4碰撞區域識別名(head/face/bust等)
例子
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

旋轉滑鼠滾輪

解說
旋轉滑鼠滾輪時觸發此事件。
補足
現時滑鼠滾輪一格時表示+-120(只作参考)。無段式滾輪等數值可能有變。
參數
Reference0滑鼠游標的 x 座標(本地座標)
Reference1滑鼠游標的 y 座標(本地座標)
Reference2滑鼠滾輪的旋轉量及旋轉方向 (上為+,下為-)
Reference3人物視窗ID
Reference4碰撞區域識別名(head/face/bust等)
例子
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

對話框事件

OnBalloonBreak

被SSTP以外的事件打斷對話。

補足
SSP 1.11起開始傳送Reference1。
參數
Reference0被打斷的Sakura script
Reference1從哪一方的對話框打斷對話 (\0 = 0 \1 = 1 \p[2] = 2 ...)

OnBalloonClose

對話框不等到逾時就被使用者關閉。

參數
Reference0執行中的Sakura script

OnBalloonTimeout

沒有選項的對話框逾時關閉。

參數
Reference0Sakura script

系統匣氣球提示事件

OnTrayBalloonClick

使用者雙擊系統匣氣球提示。

解說
以 \![set,trayballoon] 顯示在系統匣的氣球提示被使用者雙擊時觸發。
補足
SSP 2.00.07 實裝。
參數
Reference0氣球標題 (--title指定)
Reference1氣球文字 (--text指定,無視改行)

OnTrayBalloonTimeout

系統匣氣球提示逾時。

解說
以 \![set,trayballoon] 顯示在系統匣的氣球提示逾時或被使用者點擊×按鈕關閉時觸發。
補足
SSP 2.00.07 實裝。
參數
Reference0氣球標題 (--title指定)
Reference1氣球文字 (--text指定,無視改行)

安裝事件

OnInstallBegin

開始安裝。

解說
當有安裝包被拖曳到人物上時觸發。

OnInstallComplete

安裝完成。

解說
安裝無誤完成時將會觸發此事件。
在SSP中會先觸發 OnInstallCompleteEx 然後才觸發此事件。
如果 OnInstallCompleteEx 有回傳Sakura Script的話此事件將不會被觸發。
補足
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如有多於一個物件時,第二個物件的名稱
例子
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

OnInstallCompleteEx

安裝完成。(擴張)

解說
安裝無誤完成時將會觸發此事件。
為確保互換性,如果此事件不回傳Sakura Script的話(200 OK以外)將會觸發 OnInstallComplete
補足
Reference0中放填入安裝的安裝包種類,但不限install.txt中所記載的種類。
尤其是with ballon的時候,就如例子中那樣會以ghost[1]balloon的方式利用CHR(1)分隔列出所有項目。種類清單如下:
shell外表
ghost人格
supplement人格追加檔案
balloon對話框
plugin外掛
headline在線新聞
calendar skin日曆外表 (僅SSP)
calendar plugin在線日曆 (僅SSP)
參數
Reference0安裝好的物件的種類,以CHR(1)分隔
Reference1安裝好的物件的名稱,以CHR(1)分隔
Reference2安裝好的物件的路徑,以CHR(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

安裝失敗。

解說
安裝失敗時將會觸發此事件。
失敗時,Reference0中會填入失敗理由。
unlha32unlha32載失敗
extraction解壓失敗(壓縮包損毀)
invalid typeinstall.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

拒絕安裝。

解說
拒絕安裝時將會觸發此事件。
被拖曳到人物中的安裝包是其他人物專用的。
參數
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

滑鼠拖曳事件

OnFileDrop

檔案/資料夾拖曳開始。

補足
過去互換用。請利用OnFileDrop2/Ex代替。
還有,另一個互換用的OnFileDropped也會被觸發也是不推薦使用。
參數
Reference0被拖曳的檔案或資料夾
Reference1人物視窗ID

OnFileDrop2

檔案/資料夾拖曳開始。

解說
檔案或資料夾被拖曳到人物時會觸發此事件。
多個檔案被拖曳的話會以CHR(1)分隔。
Reference1為被拖曳到的人物ID。
補足
此事件因為出錯而不回傳(「200 OK」和回傳Value)時,SHIORI側不再判断和處理,以後的處理(滑鼠事件)也不執行。
MATERIA,CROW的話拖曳的檔案或資料夾到使魔側並不會觸發此事件。
參數
Reference0被拖曳的檔案或資料夾,以CHR(1)分隔
Reference1人物視窗ID
例子
GET SHIORI/3.0
Sender: crow
ID: OnFileDrop2
Reference0: C:\sample.png[1]C:\test.txt
Reference1: 0
SecurityLevel: local
Charset: Shift_JIS
這是sample.png和test.txt同時拖曳到主菜側的情況。

OnFileDropEx

檔案拖曳開始。

解說
檔案被拖曳到人物時會觸發此事件。
多個檔案被拖曳的話會以CHR(1)分隔。
補足
壓縮包(NAR,ZIP,LZH)被拖曳到人物時會進行安裝程序而不會觸發此事件。
參數
Reference0被拖曳的檔案,以CHR(1)分隔

OnFileDropping

檔案拖曳前

解說
檔案或資料夾被拖曳到人物上還沒放開時會觸發此事件。
參數
Reference0被拖曳的檔案或資料夾(僅第一個)
Reference1人物視窗ID

OnNarCreated

NAR包裝完成

解說
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檔案

解說
把含有人格中的安裝資訊所記載的文字檔案「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

文字拖曳。

解說
文字拖曳到人物會觸發此事件。
補足
不回傳的話標準動作是「像Sakura Script的話執行,其餘無視」。
參數
Reference0文字 改行會置換為CHR(1)
Reference1人物視窗ID

OnUpdatedataCreated

升級資訊產生完成

解說
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

開始產生升級資訊

解說
人格中的「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拖曳失敗

解說
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拖曳完成

解說
OnURLDropping」後下載完成時觸發此事件。
補足
現在 MATERIA phase583 中,事件觸發後回傳的 Value 不處理就被破棄。(不觸發OnTranslate,不被處理)
還有,此事件後會強制進行安裝程序。
參數
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拖曳開始

解說
從瀏覽器等把安裝包網址拖曳到人物會觸發此事件。
補足
此事件觸發時機只有當URL不是本機(file://~)而且為可被安裝的壓縮包(檔尾為NAR・ZIP・LZH)。
參數
Reference0被拖曳的網址
例子
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

壁紙設定

解說
BMP,JPEG等可被設定為壁紙的檔案拖曳到人物會觸發此事件。
這事件有回傳的話,本體會進更換壁紙的動作。
參數
Reference0被拖曳的檔案
Reference1人物視窗ID

網路更新事件

OnUpdate.OnDownloadBegin

檔案下載開始

解說
網路更新時,檔案下載開始時會觸發此事件。
補足
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

解說
檔案下載了後,比對MD5前觸發此事件。
在這之後,MD5一致的話,[[OnUpdate.OnMD5CompareComplete>#OnUpdate.OnMD5CompareComplete]]
不一致的話,[[OnUpdate.OnMD5CompareFailure>#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一致

解說
下載好的檔案的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不一致

解說
下載好的檔案的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

網路更新開始

解說
網路更新的指示下達就立刻觸發的事件。
在這之後,就會下載更新資料。
補足
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

網路更新檢查完成

解說
\![updatebymyself,checkonly]
標籤執行後,檢查正常完成後觸發的事件。
任何理由導致失敗時,不觸發此事件而觸發OnUpdateCheckFailure
沒有需要更新的檔案的時候,Reference0中會填入none。
參數
Reference0狀態(changed/none)
Reference1逗號分隔的更新檔案名稱清單
Reference3類型 (shell,ghost,balloon,headline,plugin,baseware等)

OnUpdateCheckFailure

網路更新檢查失敗

解說
\![updatebymyself,checkonly]
標籤執行後,任何理由導致失敗時觸發的事件。
補足
錯誤代碼放在Reference0,和OnUpdateFailure一樣。
詳細請參考那邊的清單。
參數
Reference0錯誤代碼(timeout/md5 miss/404等)
Reference3類型 (shell,ghost,balloon,headline,plugin,baseware等)

OnUpdateComplete

網路更新完了

解說
網路更新時,所有檔案均下載安裝完成後觸發的事件。
任何理由導致失敗時,不觸發此事件而觸發 OnUpdateFailure
沒有需要更新的檔案的時候,Reference0中會填入none。
補足
因為Materia仕様書中只規定none,如果更要按新有無來決定說話內容的話,
建議按Reference0是否為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

網路更新失敗

解說
任何理由導致失敗時觸發的事件。
觸發此事件時,錯誤代碼會放在Reference0。
錯誤代碼為:
404HTTP錯誤。還有404以外的數值。
timeout傳送逾時
md5 missMD5不一致
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

網路更新準備完成

解說
開始網路更新,有實際需要更新的檔案時觸發的事件。
沒有有實際需要更新的檔案時這個事件被跳過而觸發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

對時事件

OnSNTPBegin

開始對時

解說
校對時間指示下達就立刻觸發的事件。
在這之後,將從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

取得對時資料

解說
從SNTP伺服器成功取得時間資料時觸發的事件。
Reference1為SNTP伺服器的時間,而Reference2 為本機的時間,按次序以半形逗號分隔填入:
(年),(月),(日),(時),(分),(秒),
補足
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

對時完成

解說
Sakura Script的「\6」標籤處理後,實際有校正時間後觸發的事件。
補足
MATERIA 583 中,不觸發此事件。
還有,只有SSP會填入Reference1,按次序以半形逗號分隔填入:
(年),(月),(日),(時),(分),(秒),(微秒)
參數
Reference0連接到的SNTP伺服器
Reference1逗號分隔了的正確(SNTP伺服器側的)時間

OnSNTPFailure

取得對時資料失敗

解說
任何理由導致不能從SNTP伺服器取得對時資料時觸發的事件。
參數
Reference0連接到的SNTP伺服器

檢查郵件事件

OnBIFFBegin

開始檢查郵件

解說
檢查郵件的指示下達就立刻觸發的事件。
在這之後,就會從郵件伺服器下載資料。
補足
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

檢查郵件成功

解說
檢查郵件成功時觸發此事件。
Reference4 為每個郵件抬頭部份,改行置換成CHR(1),郵件區間為CHR(2)分隔的形式傳送。
Reference5 為每個郵件的郵件編號和大小以「(郵件編號) (大小)」以CHR(1)分隔的形式傳送。
Reference6 為每個郵件的uidl(郵件的唯一識別號)以CHR(1)分隔的形式傳送。
[SSP擴張]
Reference7 為每個郵件的概要が以CHR(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

檢查郵件失敗

解說
任何理由導致檢查郵件失敗時觸發此事件。
觸發此事件時,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

在線新聞事件

OnHeadlinesense.OnFind

閱讀在線新聞

解說
在線新聞分析器把資料下載、分析後而結果有更新的話就會觸發此事件。
Reference2 中被填入的代碼(OnFind 階段):
First第一頁(有下一頁存在)
First and Last第一頁(沒有下一頁,只有一頁時)
Last最後一頁
Next上記三項皆非
還有,這事件觸發後,使用者選擇了空識別字(例「 \q[次のページへ,] 」)時,將會換頁
載有下一頁的在線新聞資料又會再次觸發「OnHeadlinesense.OnFind」。
補足
在線新聞資料,以Sakura Script形式,在MATERIA Phase583中,
資料中含有「\-」(終了指示標籤)等情況(資料抽出時出現的問題),
就這樣放到Value回傳的話,會出現問題。
正因如此,解釋有特別操作用途的標籤、不要產生誤操作的標籤而對輸出進行置換處理是必要的。
參數
Reference0對象網站名稱
Reference1對象URL
Reference2OnFind 階段
Reference3在線新聞資料本體(Sakura Script片斷)
例子
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

開始處理在線新聞

解說
在線新聞指示下達就立刻觸發的事件。
在這之後,將進行取得並分析網站資料的工作。
補足
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

成功處理在線新聞(沒有更新)

解說
在線新聞分析器正常終了,沒有更新的話就會觸發此事件。
因此如此,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

處理在線新聞失敗

解說
任何理由導致處理在線新聞時觸發此事件。
觸發此事件時,Reference0中會填入錯誤代號:
can't download下載不到檔案
can't analyze解析・取得不到有效的新聞資料
參數
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成功

解說
接收RSS成功時觸發此事件。
Reference0為RSS標題,Reference1為提供RSS Feed的網頁的URL(注意:並不是RSS自己!)。
有更新的話Reference數為可變。Reference2之後順序按以下格式列出。
標題[1]URL[1]更新日期
[1]為CHR(1)。沒有日期時(標題[1]URL)也會有。
更新日期的格式如下以逗號分隔:
年,月,日,時,分,秒
補足
因為以後的擴張會以[1]分隔從後追加,
請避免靠CHR(1)分隔出來的數目來解析的方法。
遇到沒有要素數的Feed時,Reference2以後不會存在。
現時是暫定仕様。
參數
Reference0RS標題
Reference1提供RSS Feed的網頁的URL(注意:並不是RSS自己!)
Reference2(這個以後,RSS資料 - 請参照說明)

SSP擴張事件

OnDisplayChange

桌面變化

解說
桌面解像度或色深變化時觸發此事件。
補足
人格起動時也會把當時桌面的狀態傳入而觸發此事件(Notify事件)。
參數
Reference0畫面色深(bit)
Reference1畫面寬度
Reference2畫面高度

OnShellScaling

外表放大/縮小率改變

解說
外表放大/縮小率改變時觸發此事件。
參數
Reference0新的擴大率(X)
Reference1舊的擴大率(X)
Reference2新的擴大率(Y)
Reference3舊的擴大率(Y)

OnAITalk

\a等要求說話的時候觸發。

OnBatteryCritical

電池電量緊拙的時候觸發。

解說
電池電量緊拙的時候觸發。觸發時機則依賴Windows的電源設定。
參數
Reference0剩餘電源百分比,檢測不到時為-1
Reference1離斷電的時間(秒),檢測不到時為-1
Reference2電源狀態 offline=電池 online=AC電源 backup=UPS等後備電源

OnBatteryLow

電池電量低的時候觸發。

解說
電池電量低的時候觸發。觸發時機則依賴Windows的電源設定。
參數
Reference0剩餘電源百分比,檢測不到時為-1
Reference1離斷電的時間(秒),檢測不到時為-1
Reference2電源狀態 offline=電池 online=AC電源 backup=UPS等後備電源

OnBatteryNotify

電池狀態通知。

解說
電池殘量或AC電源/電池切換,電源的狀態改變時觸發的通知事件。利用這通知事件,可以做到當電池充滿電時顯示訊息等功能。
補足
沒電池的機器一概不通知。不支援Windows NT4。OnBoot時也會通知。
參數
Reference0剩餘電源百分比,檢測不到時為-1
Reference1離斷電的時間(秒),檢測不到時為-1
Reference2電源狀態 offline=電池 online=AC電源 backup=UPS等後備電源

OnEmbryoExist

SSP起動時Materia已經起動。

OnExecuteHTTPComplete

OnExecuteHTTPFailure

非同步HTTP請求執行成功 / 失敗

補足
SSP 2.00.01以後實裝。請參照 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所設定的Cookie字串(己加工成可多次使用的樣式)

OnNekodorifExist

SSP起動時猫どりふが已經起動。

OnNetworkStatusChange

網路連接狀態更變。

解說
當網路線連接或拔除等時候觸發。
補足
起動時為Notify事件,其後為Get事件。
參數
Reference0online 或 offline
Reference1現在機器中的IP清單,以CHR(1)分隔

OnOtherGhostTalk

其他 Ghost 說話的通知。

解說
以 \![set,otherghosttalk,true] 生效時,其他 Ghost 說話時所發出的通知。
補足
SecurityLevel抬頭會繼承元對話的狀態。
Remote SSTP等所發生的對話這通知的SecurityLevel也會是remote。
參數
Reference0Ghost名
Reference1Ghost的Sakura名
Reference2對話狀態。break(已中斷),communicate(溝通),remote(來自非Local SSTP)
Reference3事件ID。OnBoot等所引發的對話的事件。SSTP等非事件的對話為空。
Reference4已說出的Sakura Script
Reference5該事件的Reference引數群,以CHR(1)分隔
例子
GET SHIORI/3.0
ID: OnOtherGhostTalk
Reference0: Emily/Phase4
Reference1: Emily
Reference2: break,communicate
Reference3: OnCommunicate
Reference4: \h\s[4]なにいってるのかわからないよ…
Reference5: ほげほげ
SecurityLevel: local

OnScreenSaverEnd

螢幕保護程式完結。

OnScreenSaverStart

螢幕保護程式開始。

OnSoundStop

聲音檔案播放結束。

參數
Reference0聲音檔案名稱

OnURLQuery

URL 拖曳時的通知

解說
URL拖曳到人物視窗時通知。處理這通知後回傳(200)的話,OnURLDroppingDropped這樣通常下載處理就會被取消。在只有你希望由 Ghost 側自行處理URL時才回傳。
參數
Reference0URL
Reference1人物視窗ID(0=Sakura 1=Kero 2...)
Reference2下載到的檔案的MIME

OnDeviceArrival

OnDeviceRemove

設備檢測/ 刪除事件。

補足
SSP 2.02.18 實裝。
參數
Reference為1行對應1個設備,格式如下。 類型\1名稱\1製造商名\1設備文件名[\1為Bit值1]
類型:USB・PORT・DRIVE・Volume等設備的種類識別用的字符串。
設備文件名:卷標(C:等)或可以訪問設備的虛擬文件名。

OnPingProgress

OnPingComplete

\![execute,ping,(參數)]指定回數送信途中/指定回數結束。

補足
SSP 2.2.51 實裝。Reference2之後、僅已送信Ping的1回信息記錄。 Progress時不完全。
錯誤信息參照 http://msdn.microsoft.com/en-us/library/aa366053(v=vs.85).aspx ,返回時數據化 IP_DATA_MISMATCH。
參數
Reference0--event=指定字符串
Reference1送信方地址[\1] 所有送信回數[\1] 成功回數[\1] 失敗回數
Reference2之後「OK」或錯誤信息[\1] 應答方地址[\1] RTT(來回時間ms)

OnNSLookupComplete

OnNSLookupFailure

\![execute,nslookup,(參數)]実行成功/失敗。

補足
SSP 2.2.64 實裝。
參數
Reference0--event=指定字符串
Reference1域名或IP --host=指定字符串
Reference2正向="lookup"・逆向="reverse"
Reference3僅成功場合、結果(正向為IP、逆向為域名)

OnExecuteHTTPSSLInfo

\![execute,http-***]標籤實行時,取得https://開頭時、SSL/TLS的連接信息通知。

補足
SSP 2.2.57 實裝。
參數
Reference0async ID (沒有就留空)
Reference1取得URL
Reference2http響應碼 (錯誤時也通知)
Reference3通信版本基本上是TLSv1/SSLv3
Reference4加密方法 AES256-SHA 等
Reference5要發布名字確認時,/O=的後續字符串最好剔除
Reference6有效期限開始日時年,月,日,時,分,秒
Reference7有效期限結束日時年,月,日,時,分,秒
Reference8發行者名字確認時,/O=的後續字符串最好剔除

SSTP事件

OnMusicPlay

解說
遵循 SSTP Protocol NOTIFY/1.1 仕様,向本體傳送「Event:OnMusicPlay」時觸發的事件。
補足
現在依照這仕様傳送SSTP送信的程式只有Winamp2用插件「YunaSexyFont Plug-in 2000」(Version 7.9b21)。 還有這插件會在Reference0中代入演奏開始曲目的標題(Winamp上的表記,預設為「(歌手) - (曲名)」)以發出請求。
參數
Reference0曲目資料(標題)

其他事件

OnNetworkHeavy

伺服器沒回應。

解說
拖曳事件(「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

右鍵選單的推薦網址被點擊。

解說
右鍵選單中的「推薦網址」或「門戶網址」被點擊時觸發。
參數
Reference0被選擇項目的名稱
Reference1被選擇項目的網址
例子
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

OnSSTPBreak

接收SSTP訊息時被中斷。

解說
接收SSTP協定的SEND時在對話框雙擊中止接收時觸發。
補足
SSP 1.11起開始傳送Reference1。
參數
Reference0被打斷的Sakura script
Reference1從哪一方的對話框打斷對話 (\0 = 0 \1 = 1 \p[2] = 2 ...)

OnTranslate

Sakura Script翻譯事件。

解說
此為特殊事件,在其他事件返回Sakura Script後在顯示前必然會執行的事件。
必須處理的Sakura script會放到Reference0中。
如果有回傳的話,回傳的Sakura Script將會替代原本的Sakura Script顯示出來。
補足
Materia程式中有瑕疵的關係,遇到 \x 標籤的話會再執行此事件一次。
要在Materia中使用 \x 標籤的話編寫時要讓此事件可以多次執行。
參數
Reference0必須處理的Sakura script
例子
紅字為輸入藍字為Shiori輸出 //為註解
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
この場合,直前の何らかのイベントで”トランスレートします。”と返しています。
このイベントでトランスレートされるため,実際には”トランスレートしました。”と表示されます。

鍵盤事件

OnKeyPress

鍵盤按鍵被按下

解說
鍵盤按鍵被按下時會觸發此事件。
補足
特殊按鍵的識別名稱一覧:
backtabclearreturncontrolpauseescapespacepriornextendhomeleftupright
downdeletef1f2f3f4f5f6f7f8f9f10f11f12
參數
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

外部程式-きのこ事件

OnKinokoObjectChanged

蘑菇的外表改變後觸發此事件。

參數
Reference0改變後的蘑菇資料
Reference1改變後的蘑菇資料
Reference2改變後的蘑菇資料

OnKinokoObjectChanging

蘑菇的外表改變時觸發此事件。

參數
Reference0改變前的蘑菇資料
Reference1改變前的蘑菇資料
Reference2改變前的蘑菇資料

OnKinokoObjectCreate

蘑菇在頭部長出時觸發此事件。

參數
Reference0那蘑菇的資料
Reference1那蘑菇的資料
Reference2那蘑菇的資料

OnKinokoObjectDestroy

蘑菇在頭部消失時觸發此事件。

參數
Reference1那蘑菇的資料
Reference2那蘑菇的資料

OnKinokoObjectInstalled

蘑菇外表被拖曳安裝時觸發此事件。

參數
Reference0被安裝的蘑菇資料
Reference1被安裝的蘑菇資料
Reference2被安裝的蘑菇資料

OnSysResourceCritical

系統資源剩下20%時觸發此事件。

OnSysResourceLow

系統資源剩下40%時觸發此事件。

外部程式-猫どりふイベント

OnNekodorifObjectDodge

沒擊中的落下物從可視範圍中消滅時觸發此事件。

參數
Reference0落下物名稱
Reference1落下物的對象人格名稱
Reference2落下物的種類
Reference3蘑菇旗子。有蘑菇時為1,否則為0。
Reference4落下物的目標名稱

OnNekodorifObjectDrop

落下物再投下時觸發此事件。

參數
Reference0落下物名稱
Reference1落下物的對象人格名稱
Reference2落下物的種類
Reference3蘑菇旗子。有蘑菇時為1,否則為0。
Reference4落下物的目標名稱

OnNekodorifObjectEmerge

落下物在可視範圍内出現時觸發此事件。

參數
Reference0落下物名稱
Reference1落下物的對象人格名稱
Reference2落下物的種類
Reference3蘑菇旗子。有蘑菇時為1,否則為0。
Reference4落下物的目標名稱

OnNekodorifObjectHit

落下物擊中時觸發此事件。

參數
Reference0落下物名稱
Reference1落下物的對象人格名稱
Reference2落下物的種類
Reference3蘑菇旗子。有蘑菇時為1,否則為0。
Reference4落下物的目標名稱

OnNekodorifObjectVanish

擊中了的落下物從可視範圍中消滅時觸發此事件。

參數
Reference0落下物名稱
Reference1落下物的對象人格名稱
Reference2落下物的種類
Reference3蘑菇旗子。有蘑菇時為1,否則為0。
Reference4落下物的目標名稱

外部程式事件

OnApplicationBoot

外部程式起動時觸發此事件。

參數
Reference0程式名稱
Reference1程式資料

OnApplicationClose

外部程式終了時觸發此事件。

參數
Reference0程式名稱
Reference1程式資料

OnApplicationExist

外部程式存在時觸發此事件。

參數
Reference0程式名稱
Reference1程式資料

OnApplicationFileOpen

外部程式開啟文件時觸發此事件。

參數
Reference0程式名稱
Reference1程式資料

OnApplicationOperationFinish

外部程式有任何處理完成時觸發此事件。

參數
Reference0程式名稱
Reference1處理内容
Reference2處理對象

OnApplicationVersion

外部程式通知其版本時觸發此事件。

參數
Reference0程式名稱
Reference1程式資料
Reference2版本號
Reference3著作權
Reference4開發單位的URL

OnWebsiteUpdateNotify

網站通知其更新或新到信息時觸發此事件。

參數
Reference0網站名稱
Reference1最終更新日期
Reference2更新内容

情報通知事件

balloonpathlist

對話框存放基底目錄清單通知

解說
對話框存放基底目錄清單通知。 (僅SSP)
系統載入時,存放對話框基底目錄的絕對路徑,如果在[偏好設定]→[目錄]中的[對話框]中有增加目錄的話,也會一併納入通知。
系統預設的對話框存放基底目錄只在Reference0。
補足
Reference0, 1, 2, ...中外掛的名稱會逐一填入。Reference的最大數目不定。
參數
Reference0(補足参照)

balloon_tooltip

對話框工具提示標籤顯示通知

解說
詢問對話框工具提示標籤的內容。
OnChoiceHover沒回應時觸怒此事件。
補足
SSP 2.01.62 以後
Reference0選項標題
Reference1選項識別名
Reference2以下選項擴張資料

basewareversion

運行環境的版本通知

解說
通知現時運行人格的環境的版本。
例:
Reference0: 0.4.11
Reference1: CROW
Reference0: 1.10.17[B]
Reference1: SSP
Reference2: 1.10.17.3001
補足
SHIORI載入後,其他情報通知事件通常會同時通知。
參數
Reference0版本資料
Reference1本體識別字串 (SSP・CROW等)
Reference2四組數値的版本資料 (僅SSP)

calendarpluginpathlist

日曆外掛存放基底目錄清單通知

解說
日曆外掛存放基底目錄清單通知。 (僅SSP)
系統載入時,存放日曆外掛基底目錄的絕對路徑,如果在[偏好設定]→[目錄]中的[日曆外掛]中有增加目錄的話,也會一併納入通知。
系統預設的日曆外掛存放基底目錄只在Reference0。
補足
Reference0, 1, 2, ...中外掛的名稱會逐一填入。Reference的最大數目不定。
參數
Reference0(補足参照)

calendarskinpathlist

日曆存放基底目錄清單通知

解說
日曆存放基底目錄清單通知。 (僅SSP)
系統載入時,存放日曆基底目錄的絕對路徑,如果在[偏好設定]→[目錄]中的[日曆]中有增加目錄的話,也會一併納入通知。
系統預設的日曆存放基底目錄只在Reference0。
補足
Reference0, 1, 2, ...中外掛的名稱會逐一填入。Reference的最大數目不定。
參數
Reference0(補足参照)

ghostpathlist

人格存放基底目錄清單通知

解說
人格存放基底目錄清單通知。 (僅SSP)
系統載入時,存放人格基底目錄的絕對路徑,如果在[偏好設定]→[目錄]中的[人格]中有增加目錄的話,也會一併納入通知。
系統預設的人格存放基底目錄只在Reference0。
補足
Reference0, 1, 2, ...中外掛的名稱會逐一填入。Reference的最大數目不定。
參數
Reference0(補足参照)

headlinepathlist

在線新聞存放基底目錄清單通知

解說
在線新聞存放基底目錄清單通知。 (僅SSP)
系統載入時,存放在線新聞基底目錄的絕對路徑,如果在[偏好設定]→[目錄]中的[在線新聞]中有增加目錄的話,也會一併納入通知。
系統預設的在線新聞存放基底目錄只在Reference0。
補足
Reference0, 1, 2, ...中外掛的名稱會逐一填入。Reference的最大數目不定。
參數
Reference0(補足参照)

hwnd

視窗句柄通知

解說
現在人格自己所擁有的視窗的識別碼通知。
參數
Reference0每一個人物的視窗識別碼,以CHR(1)分隔(\0hwnd[1]\1hwnd[1]\p[2]hwnd[1]...)
Reference1每一個人物對話框的視窗識別碼,以CHR(1)分隔(\0hwnd[1]\1hwnd[1]\p[2]hwnd[1]...)

installedballoonname

已安裝的對話框名稱通知

解說
現在所有被安裝的對話框的名稱通知。
補足
Reference0, 1, 2, ...中對話框的名稱會逐一填入。Reference的最大數目不定。
參數
Reference0(補足参照)

installedghostname

已安裝的人格名稱通知

解說
現在所有被安裝的人格的名稱通知。
這裡指的「全部人格」包括自已。
補足
Reference0, 1, 2, ...中人格的名稱會逐一填入。Reference的最大數目不定。
注意:被通知的不是主菜側人物的名稱,而是人格的名稱。
參數
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: リリス

installedheadlinename

已安裝的在線新聞名稱通知

解說
現在所有被安裝的在線新聞的名稱通知。
補足
Reference0, 1, 2, ...中在線新聞的名稱會逐一填入。Reference的最大數目不定。
參數
Reference0(補足参照)

installedplugin

已安裝的外掛名稱通知

解說
現在所有被安裝的外掛的名稱通知。
補足
Reference0, 1, 2, ...中外掛的名稱會逐一填入。Reference的最大數目不定。
參數
Reference0(補足参照)

OnNotifyDressupInfo

衣服情報通知

解說
Reference0以後把以下資料以CHR(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情報通知

解說
通知現時運行人格的OS資料。
載入時此事件只通知一次。以後要使用的話,請自行保存此資料。
參數
Reference0系統,版本 (例:WindowsNT,5.00)
Reference1CPU生產商,時脈MHz,其他追加資料 (例:GenuineIntel,2550,3.15.2.7,ffffffff)
Reference2物理,虛儗記憶體 剩下容量(KB)
Reference3從系統起動起經過的時間

OnNotifySelfInfo

人格自己的情報通知

解說
人格起動時,它自己的資料綜合通知。
補足
此事件為通知(Notify)事件。回傳Sakura Script也不會顯示。
Reference5,6為SSP 1.10.04以後追加。
參數
Reference0人格名稱
Reference1主菜名稱
Reference2使魔名稱
Reference3起動時的外表名稱
Reference4起動時外表的路徑 (例: shell/master/) 可能依照伺か平台不同而傳入相對路徑或絕對路徑
Reference5起動時的對話框名稱
Reference6起動時對話框的路徑 (例: balloon/master/) 可能依照伺か平台不同而傳入相對路徑或絕對路徑

OnNotifyUserInfo

使用者情報通知

解說
人格起動時,或使用者資料改變時,就會通知使用者資料。
補足
此事件為通知(Notify)事件。回傳Sakura Script也不會顯示。
參數
Reference0暱稱
Reference1全名
Reference2生日日期,以逗號分隔:年,月,日
Reference3性別

otherghostname

同時起動中的人格名稱通知

解說
通知其他同時起動中人格的主菜側名稱、現在的表情編號。
(就算沒有同時起動中的人格這個通知還是會執行)
補足
Reference0以後會以下列的格式填入,而[1]為CHR(1)。
主菜側名稱[1]主菜側的表情編號[1]使魔側的表情編號
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

現在的人格名稱通知

解說
現在的人格,也就是自己的名稱會被通知。
參數
Reference0主菜側名稱
例子
NOTIFY SHIORI/3.0
Charset: Shift_JIS
ID: ownerghostname
Reference0: リリス
SecurityLevel: local
Sender: crow

SHIORI/3.0 204 No Content
Charset: Shift_JIS
Sender: リリス

pluginpathlist

外掛存放基底目錄清單通知

解說
外掛存放基底目錄清單通知。 (僅SSP)
系統載入時,存放外掛基底目錄的絕對路徑,如果在[偏好設定]→[目錄]中的[外掛]中有增加目錄的話,也會一併納入通知。
系統預設的外掛存放基底目錄只在Reference0。
補足
Reference0, 1, 2, ...中外掛的名稱會逐一填入。Reference的最大數目不定。
參數
Reference0(補足参照)

rateofusegraph

人格使用率統計表内容顯示

解說
人格使用率統計表内容被通知。
起動中可能會被通知幾次。
補足
Reference0以後會以下列的格式填入,而[1]為CHR(1)。
人格名稱[1]主菜側名稱[1]使魔側名稱[1]起動次數[1]起動時間(分)[1]起動時間%[1](boot|install|vanish)
boot為起動中,install為已被安裝,vanish為只剩下統計資料。
參數
Reference0(補足参照)

tooltip

工具提示標籤顯示通知

解說
詢問工具提示標籤的內容。
可以在 surfaces.txt 中填寫,填寫後不觸發此事件。
補足
SSP 2.01.58 以後
Reference0滑鼠游標的 x 座標(本地座標)
Reference1滑鼠游標的 y 座標(本地座標)
Reference20
Reference3人物視窗ID
Reference4碰撞區域識別名(head/face/bust等)
Reference50

uniqueid

Owned SSTP用唯一識別碼通知

解說
人格每一次被分配的唯一識別碼通知。
參數
Reference0唯一識別碼

外部連結


首頁   編輯 封鎖 差異 備份 上傳檔案 複製 變更名稱 重新載入   新建條目 一覽 搜索 最近的變更   幫助   最近更新的RSS
Last-modified: 2018-01-26 (五) 14:13:52 (119d)