起動/終了/切換事件 †

↑

OnFirstBoot †

初次起動

解說
人格安裝後第一次起動時代替OnBoot或OnGhostChanged事件而觸發的事件。
補足
那人格如果之前有反安裝過的話，
反安裝的次數會傳入到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」資料夾，１個人格也沒被安裝時，資料就會被刪除)
例子
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]アンカー１が選ばれました。\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[選択肢１,sel1,expand]\q[選択肢２,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 為本機的時間，按次序以半形逗號分隔填入：
(年),(月),(日),(時),(分),(秒),
補足
ＳＳＰ的話，所填入的時間中，追加了微秒單位的項目：
(年),(月),(日),(時),(分),(秒),(微秒)
參數
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 [email protected])
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: [email protected]
To: [email protected]
Subject: testmail
Message-Id: <[email protected]>
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 [email protected]
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)的話，OnURLDropping → Dropped這樣通常下載處理就會被取消。在只有你希望由 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～」)、網路更新事件、在線新聞事件、郵件檢查事件等，從伺服器下載資料時，一定時間對方伺服器沒回應時觸發。
補足
ＳＳＰ的話會在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]Ａが押されました。\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 (2097d)