大家好,我是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方式
(UDP方式必须保持代理端开启,不可关闭)
方式而:CLR方式
(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