大家好,我是Traceless,很高興能得到作者 幸運★星 大佬的授權,為大家整理框架使用教程及開發文檔,本文及立足於基礎科普,包含框架原理介紹、開發環境、使用環境搭建及日常框架使用說明。對開發老鳥來說,說許你只需要翻閱使用環境、插件使用和下載API介面文檔即可。 此處要對框架的版權等信息做一個說明 ...
大家好,我是Traceless,很高興能得到作者 幸運★星 大佬的授權,為大家整理框架使用教程及開發文檔,本文及立足於基礎科普,包含框架原理介紹、開發環境、使用環境搭建及日常框架使用說明。對開發老鳥來說,說許你只需要翻閱使用環境、插件使用和下載API介面文檔即可。
此處要對框架的版權等信息做一個說明:
本框架作者 幸運★星 ,在酷Q社區看到了 moecraft 大大的C#SDK (原帖地址:https://cqp.cc/t/24088 )後茅塞頓開,借鑒了moecraft 大大的UDP轉發原理和思路,開發並逐漸完善了Flexlive C#SDK(Flexlive首發帖:https://cqp.cc/t/28865),我也是在看到了這個帖子,異常興奮,立即加入了框架交流群,和 星哥 開始了一段不得不說的故事。
在框架之初,UDP代理方式的插件介面已經很齊全,苦於需要多開一個UDP中轉代理程式,星哥 開始探索新的更方便快捷的方式,星哥 參考群內 CLR 大佬 ♡+.史萊姆 (由於找不到大佬的博客園地址和酷Q論壇ID,只能貼上QQ昵稱以表感謝)提供的CLR反射思路和DEMO源碼,決定再以CLR方式實現官方API介面的調用,達到免除代理的目的,讓二次開發者能夠像使用CPK插件一樣使用Flexlive框架開發的C#插件。
經過幾天的努力,功能齊全的測試版於2016年10月27日出爐,28日 星哥 將框架交給我測試基本功能,在一晚的BUG修複後,CLR方式終於實現了全部功能並可以成功使用,29日 星哥 重新整理並添加了框架內容,在群內發佈了 UDP/CLR 並行的框架(CLR方式插件不支持調試,日誌無法獲取,暫無解決辦法)。我在日常UDP方式穩定使用的情況下,分別使用雙酷Q(1CLR 1UDP)(2UDP)(2CLR)三種形式運行我自己開發的插件並持續使用,均未出現問題。
於是,真正的完整公開測試版,就誕生了!
接下來,Flexlive之路,需要大家幫助星哥共同走下去啦!
下麵我們來開始搭建開發環境,使用插件~
1.下載框架包,解壓Flexlive.CQP.Demo 文件夾。解壓目錄如下:
2.打開解決方案
本框架,使用VS2015編譯,.net框架版本3.5,C++端或許是4.0,有待測試。但是這個都不是重點,只需要使用VS2012及以上版本,打開解決方案。
3.創建新項目,仿照MyPlugin.cs 新建自己的插件主類,仿照FormSettings,新建自己的插件設置頁面,仿照CSharpPlugins項目,向自己的項目添加引用。
(此處不多加累贅,這都不會,建議多讀讀基礎數據再來開發插件,或者……加入我們的交流QQ群吧:8621436 嘿嘿嘿)
4.查閱API介面文檔,調用對應API實現插件功能,編譯、測試、調試、發佈使用……
API介面文檔下載:
鏈接: http://pan.baidu.com/s/1mhKjeMc 密碼: 8bkr
嗯,其實下麵開始才是重點,因為我在剛使用框架開發完成插件以後,對框架插件的使用也是一頭霧水,所以在這裡,要重點科普一下框架的使用。
1.拷貝相關依賴文件至酷Q目錄:
作者為了方便大家使用,已經做過整合和自動處理。
編譯後,直接找到項目文件目錄 Publish 文件夾,將文件夾內所有項目直接複製到酷Q根目錄(即:CQP.EXE或CQA.EXE 所在 目錄)
註意,自己開發的C#插件的類庫DLL一定要複製到酷Q CSharpPlugins 文件夾下!!!
2.使用
方式一:UDP方式
- 打開並登錄酷Q,啟用酷Q應用中 Flexlive.CQP.CQEProxy
- 打開Flexlive.CQP.CSharpProxy.exe (代理端)
- 在代理端可以看到你的插件,選中點擊啟用即可啟用
- 點擊 設置 進入插件設置頁面(如果你沒有給你的插件添加配置頁面,點擊無效。)
- 點擊 應用目錄 可以快速打開CSharpPlugins 文件夾
- 點擊 重新載入應用 可以在熱覆蓋插件DLL以後,重新載入DLL
- 點擊 功能測試 可以進入功能測試後臺,C#開發的插件日誌也顯示在這裡(酷Q端日誌不會具體到哪個C#插件,所以需要查閱C#插件日誌,請使用代理端 功能測試)
- 點擊 卸載 刪除插件並刪除本地插件DLL
(UDP方式必須保持代理端開啟,不可關閉)
方式而:CLR方式
- 打開並登錄酷Q,啟用酷Q應用中 Flexlive.CQP.CQCProxy
- 選中 Flexlive.CQP.CQCProxy 點擊菜單-設置B 進入C#插件管理頁面
- 在C#插件管理頁面可以看到你的插件,選中點擊啟用即可啟用
- 點擊 設置 進入插件設置頁面(如果你沒有給你的插件添加配置頁面,點擊無效。)
- 點擊 應用目錄 可以快速打開CSharpPlugins 文件夾
- 點擊 重新載入應用 可以在熱覆蓋插件DLL以後,重新載入DLL
- 點擊 卸載 刪除插件並刪除本地插件DLL
(1.CLR方式,功能測試頁面無法獲取日誌,有待解決
2.C#插件管理頁面可以關閉不同於UDP方式必須保持代理端開啟)
【FAQ】 1.問:酷Q無法載入dll插件怎麼辦? 答:找到酷Q目錄\conf\CQP.cfg,用記事本打開,添加開啟開發者模式
[Debug] DeveloperMode = 1
重啟酷Q
2.問:UDP方式調試不了怎麼辦? 答:在酷Q中確認引啟用了cc.flexlive.cqeproxy插件後,請用其它QQ向掛機QQ發個消息,激活UDP埠。
更多問題 Flexlive.CQP.Framework 交流群:8621436 歡迎您的到來。
本文及SDK開發文檔,已由作者授權,轉載請保留以下信息,謝謝!
框架作者: 幸運★星
協助: ♡+.史萊姆
內部版測試: Traceless
文檔:Traceless
交流群:86214636