![[PukiWiki]](image/pukiwiki.png "[PukiWiki]")
* 人格套件 - SAORI [#p252b932] #contents * 套件使用 [#k45e6f8e] 人格套件(SAORI)是專門為了擴充人格機能而製作的一種外掛插件(plugin)，以實作諸如音樂播放、螢幕特效、字串處理、系統資訊等等偽AI所沒有提供的功能。基本上如果能善用這些套件的話，可以做出一般人格所做不到的事。 由於標準化的緣故，現今大多數的偽AI都支援在人格內呼叫人格套件的功能。如果你覺得一般的事件寫作已經無法滿足你的創作欲望的話，歡迎你加入這個大坑～。 (XD) ** 套件列表 [#ec0b2125] 相關頁面 - [[人格套件列表>開發文件/SAORI/人格套件列表]] 外部連結 - [[SAORI COLLECTION>http://umeici.hp.infoseek.co.jp/etcetera/saoricollect.html]] - [[さおりん>http://refrain.sakura.ne.jp/nisesakura/saorin.html]] - [[SAORI - 伺かwiki>http://www.towano.net/ua-ks/index.php?SAORI]] - %%[[SAORI - 伺かwiki>http://www.towano.net/ua-ks/index.php?SAORI]]%%(連接已失效) ** 在Ghost中呼叫人格套件 [#p75141b4] 不同的偽AI呼叫套件的方式都不一樣，但基本上大同小異。主要需要下列資訊： - 偽AI呼叫套件的函式名稱 - 套件所在路徑 - 套件的事件指令 - 引數1、引數2、引數3、…… 首先，你必須知道套件的規格與事件種類，這些通常都寫在隨套件附帶的 readme 文件，在使用前務必讀熟其內容。接下來，我們決定好要使用的事件指令後，就要根據事件的需求來輸入引數(argument)。 以播放音樂套件 mciaudior.dll 為例，它本身內建了 "load" 、 "play" 、 "loop" 、 "stop" 四種事件指令，其功能分別為 "載入音樂" 、 "播放" 、 "重複播放" 、 "停止" 。其中 "load" 這個指令需要使用者提供音樂的路徑，其餘三者則不需要任何額外的引數。於是當我們要透過 mciaudior.dll 來播放音樂的時候，我們要這麼寫： - 美坂的呼叫方式 {$saori("mciaudior.dll","load","C:\music\op.mp3")} {$saori("mciaudior.dll","play")} - 文的呼叫方式 FUNCTIONEX("mciaudior.dll","load","C:\music\op.mp3"); FUNCTIONEX("mciaudior.dll","play"); - 華和梨的呼叫方式 $(callsaori mciaudio.dll load C:\music\op.mp3) $(callsaori mciaudio.dll play) 第一行指令先載入音樂的路徑，然後第二行則執行播放音樂的工作。這裡的路徑可以是相對路徑或絕對路徑，相對路徑會以人格 ghost\master 所在的資料夾為基準。 * 套件實作 [#zfb0e156] 人格套件分為 universal 與 BASIC 兩種型式， universal其實就是標準的DLL文件，而 BASIC 則是 Win32 Console Application ，也就是一般初學者在學C語言時最常使用的那種DOS風格的EXE程式，經由 proxy.dll 這個人格套件的傳換後，會把印出來的文字傳送到人格裡面。 ** 基本範例 [#x2991f72] - Universal 請參考下面實例。 - BASIC void main(int argc, char* argv[]) { printf("Hello, world."); } ** 製作教學 [#fefeedca] 首先請到[[csaori - Google Code>http://code.google.com/p/csaori/]]下載CSaori的原始碼，這是日本方面預先寫好的Saori原型，裡面已經幫你做好除了你要寫的功能以外的所有事情。 下載好後，請開啟任意的C++ IDE開發工具(如Visual C++)，建立一個空專案，將這兩個檔案加入專案之中。接下來，再新增一個cpp檔，並實作以下三個函式： void CSAORI::exec(const CSAORIInput& in,CSAORIOutput& out) bool CSAORI::load() bool CSAORI::unload() load()與unload()主要是處理記憶體配置的工作，如果你沒有做這些事情的需求，那麼直接回傳true即可。exec()就是實際實作功能的地方了，你主要要記住的事情有二： - 偽春菜呼叫Saori時所傳入的引數都在in.args中。 - 你的輸出要放在out.value中。 最後再將專案的組態型別改成動態函式庫(.dll)即可。 現在，讓我們來實作一個簡單的例子。首先，我們要製作一個talk.dll，它的功能是當偽春菜呼叫此Saori並傳入「talk」字眼時，便回傳「喵。」。在這例子中我們定義第一個引數是決定是誰講話，第二個引數是決定要講什麼。例如當使用者呼叫 FUNCTIONEX('talk.dll', 'kero', 'cattalk'); 時，我們便要在value[0]中回傳「\1喵。」。 那麼，我們首先在專案中加入一個talk.cpp，並將以下程式碼加入其中： #include "csaori.h" void CSAORI::exec(const CSAORIInput& in,CSAORIOutput& out) { string_t s = L""; if (in.args[0] == L"sakura") s += L"\\0"; else if (in.args[0] == L"kero") s += L"\\1"; else return; if (in.args[1] == L"cattalk") s += L"喵。"; else if (in.args[1] == L"dogtalk") s += L"汪。"; else return; out.values.push_back(s); } bool CSAORI::load() { return true; } bool CSAORI::unload() { return true; } 注意因為我們使用寬字串來運作，所以所有的字串的雙引號前面得加上「L」來告知編譯器這是個寬字元字串。接下來我們首先判斷第一引數是sakura或是kero，然後決定要加入\0或\1到字串裡，如果都不相同的話則直接return什麼都不輸出，第二引數也是相同的道理。 再來便是輸出了，由於CSaori在這裡使用C++的vector容器，因此要增加元素的話就要用push_back這個成員函數來新增。之後CSaori的內部函式會把你加到out.value中的字串做成核心程式看得懂的格式回傳給偽春菜。 (注意：如果你看不懂我這邊在寫什麼，那麼建議你去買本C++的書來看看會比較好。) 接下來就是編譯了，記得把你的專案組態換成.dll型式。編譯好後將產生出來的dll檔複製到ghost資料夾底下，就可以運作了。 一個簡單的AYA版呼叫例子： FUNCTIONEX('talk.dll', 'kero', 'cattalk'); "%(valueex0)\n"; 有沒有發現使魔叫了聲「喵。」呢？XD ** 加註 [#wc62a886] 由於美坂在語系支援上的缺陷，此專案產生的SAORI在美坂下會顯示亂碼。 除了用Saori Value[n]多值返回格式之外，也可用Saori return result格式，做法是將 out.values.push_back(s); 改成 out.result = s; 此時的呼叫範例如下： _ret = FUNCTIONEX('talk.dll', 'kero', 'cattalk'); "%(_ret)\n"; ** 相關資料(日文) [#nf919ab2] SAORI - universal (DLL形式) - [[さおリ>http://www.boreas.dti.ne.jp/~sdn/saori.html]] SAORI - basic (EXE形式) - [[さおりちゃんと遊ぼう>http://www.geocities.jp/poskoma/tips/saori.html]]~ ** 討論區 [#h6fcd286] 如果想討論SAORI開發相關的問題，可以到這裡一起參與討論： [[http://cuc2.idv.tw/viewthread.php?tid=1426&extra=page%3D1]] [[http://cuc.moe.hm/>http://cuc.moe.hm/viewthread.php?tid=1426&extra=page%3D1]]
