酷Q插件_SDK———入门与使用

傷城~ 2021-10-26 14:34 609阅读 0赞

1.这里使用的是易语言的SDK，所以请看不惯的人自行离开。\{wymbf.\}

1.2 这里不会直接给你工程，请用动手打代码，动脑思考。

1.3 不知道、不了解酷Q是干嘛的，请访问：[https://cqp.cc/forum.php][https_cqp.cc_forum.php]

2. 请阅读文档\[请用一两分钟的时间仔细阅读以下条例\] ：

限制行为（开发者、用户）：  
  
2.1 \[×\] 禁止在任何地方发布或使用违反法律的应用（[相关公告][Link 1]）。一经发现，社区团队将直接删除应用、停用相关账号，并配合公安机关调查取证。  
  
2.2 \[×\] 禁止在任何地方发布或使用下列包含高风险功能的应用。一经发现，社区团队将直接删除应用、停用相关账号：  
  2.2.1 主打批量发送或定时批量发送功能的  
  2.2.2 用于按顺序发送特定内容的  
  2.2.3 主打广告发送的  
  2.2.4 违反社会道德规范的（如骂人应用等）  
  2.2.5 涉及彩票相关功能的（若违反 2.1 条，则直接按 2.1 条进行处理）  
  2.2.6 涉及赌博性质游戏，但不涉及财物的（若涉及财物，则直接按 2.1 条进行处理）  
  2.2.7 涉及破坏网游公平性的（如网游修改器等，若违反 2.1 条，则直接按 2.1 条进行处理）  
  2.2.8 涉及收发红包功能的  
  
2.3 \[!\] 不要在社区发布下列类别的应用。一经发现，社区团队将采取对应措施。  
  2.3.1 在应用所发消息中包含广告、推广性质信息的：归档或删除应用  
  2.3.2 邀请加群（如邀请统计等）：归档或删除应用  
  2.3.3 引流、薅羊毛等：归档或删除应用  
  2.3.4 涉及漏洞利用：归档或删除应用  
  
2.4 对于诸如下列不违反 2.1 至 2.3 条，但包含风险功能的应用，社区团队可能会视情况采取关闭回复、归档或删除应用的措施：  
  2.4.1 采集、发送影视链接  
  2.4.2 好友点赞  
  2.4.3 购物商品推荐  
  
2.5 不推荐在社区发布需加群授权/推广使用类的应用。在明确注明使用限制的情况下，此类应用可以发布，但社区团队将关闭回复。（请阅读[详细公告][Link 2]）

————————————————————————————————————————————

2. |鉴于工具的不同使用方式|使用者与开发者有可能违法上述条例中的2.2 | 有可能对社区造成不好的影响|

|请大家勿将其用于任何非法途径，这将对支持酷Q社区及其团队的长期发展是很好的帮助。

2.1|因开发规范的限制，将不会发布工程文件。

3.入门

3.1 为什么选择了易语言

易语言是我小时候的玩具，这是一项非常方便的开发工具。从小学到初中，我曾经将它爱不释手，带着它经历了windowsxp,7,8,10四个版本的变更。直到2016年还有在断断续续的使用。当然四五年之后，我再次面对它shi,我是这样的：

Dim get\_time as .... !!! 下拉菜单不见了？

沙雕，这是Basic的语法好不啦。

哦对，那个时候，酷Q机器人貌似才诞生不久来着。\[忙着做外挂，哪里知道这些，而且那时候的我还小，只是为了开心而去玩弄而已\]

这么多年发展过来,真的佩服吴涛，居然带着易语言撑下来了。而且易语言的社区空前的壮大\[/ 。。。什么时候vb6也能被孩子们多重视。\]

扯远了，所以选择易语言一方面是因为眼瞎，没看到提供的其他语言SDK，一方面是想重温一下。而且，易语言与VB6类似，IDE秒开秒编译秒运行，死气沉沉的VS....你走吧，不爱你了。

3.2 我们需要准备什么：

易语言开发工具

SDK【由官方和其他开发者建立的】 的下载地址：[https://cqp.cc/t/15124][https_cqp.cc_t_15124]

开发文档：[https://d.cqp.me/Pro/开发][https_d.cqp.me_Pro] \[这里仅有几个说明......  显然对我这种把易语言关键字忘光了的人没有卵用。\]

酷QAir 小i版 \[貌似是没有区别的。\] [https://cqp.cc/t/23253\#pid873447][https_cqp.cc_t_23253_pid873447]

两个/一个QQ账号：　　[https://ssl.zc.qq.com/v3/index-chs.html][https_ssl.zc.qq.com_v3_index-chs.html]

3.3　　使用酷Q并打开开发模式：

将酷Q下载并解压下来。

将SDK下载并解压下来。

打开酷Q，登录它。

在悬浮窗/酷Q托盘 右键鼠标弹出菜单，选择 应用-->应用管理-->在弹出来的这个窗体 疯狂的按关闭按钮左边的版本号！

这个时候打开根目录，你将发现多了一个/dev的文件夹。

3.4 了解APPID

[https://d.cqp.me/Pro/开发/基础信息][https_d.cqp.me_Pro 1]

去上面这个链接，你能知道appid该怎么设置。

3.5　打开DEMO！

解压下载下来的DEMO之后，可以看到三个文件夹和一个E语言模块源码以及模块文件和其他声明文本文档。

打开 com.example.demo/

我们将看到文件夹下有两个东西 一个是 json 文件 一个是E语言源码文件

使用易语言工具打开源码文件，我们来看一下里面的东西。

注意 ：打开的时候可能会有一个易模块丢失的提示框，找到前面的根目录，将那个EC文件替换引用就好了。

3.6 　分析代码：

虽然做好了心理准备，但是打开这个DEMO的时候，我还是懵了。

【这些表格和中文是个啥!!!!!   30分钟后： 欸，真香。】

单击左边的 【程序】——》程序数据——》展开CQ应用

![1598513-20190711075231391-1582904252.png][]  再右边的代码窗口，右键菜单，展开所有子程序。

这就是酷Q插件中的事件，并且它的声明已经很完整了，|代码注释是中文这一点倒是很直观

你可以花费一分钟的时间将它看一下。

——————————————————————

我们主要来关心这个函数  　　| 　　Function AppInfo ×

|　　  子程序　   AppInfo  √

.版本 2

.子程序 AppInfo, 文本型, 公开, \[请填写\] 应用的ApiVer、Appid //请不要在本子程序添加其他代码  
.局部变量 ApiVer, 整数型  
.局部变量 AppID, 文本型

ApiVer ＝ 9 ' Api版本号  
AppID ＝ “com.example.demo” ' AppID，规则见 https://d.cqp.me/Pro/开发/基础信息  
返回 (到文本 (ApiVer) ＋ “,” ＋ AppID)

根据之前了解的AppID,我们很容易将这里的appid改成自己的。

例如

me.cqp.inkhin.groupsend

\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_

为了确保唯一性，请不要照抄我的设置，欸？我怎么绿了。

当你改好了Appid的时候，大概就完成了第一步。

打开\_eventPrivateMsg这个函数，我们可以看到下面写了什么。

.子程序 \_eventPrivateMsg, 整数型, 公开, Type=21 私聊消息 .参数 subType, 整数型, , 子类型，11/来自好友 1/来自在线状态 2/来自群 3/来自讨论组 .参数 msgId, 整数型, , 消息ID .参数 fromQQ, 长整数型, , 来源QQ .参数 msg, 文本型, , 消息内容 .参数 font, 整数型, , 字体 ' 本子程序会在酷Q【线程】中被调用，请注意使用对象等需要初始化(CoInitialize,CoUninitialize)。 CQ.发送私聊消息 (fromQQ, CQ.CQ码\_At (fromQQ) ＋ “你发送了消息：” ＋ msg) ' 如果要回复消息，请调用 api 发送，则 返回(\#消息\_拦截) - 拦截本条消息，不再由其他应用继续处理 //注意：应用优先级设置为"最高"(10000)时，无法使用本返回值 ' 如果不回复消息，交由之后的应用处理，则 返回(\#消息\_忽略) - 忽略本条消息 返回 (\#消息\_忽略)  
'''

这是一个接受私聊消息的事件，其中有一个要提到，CQ码，在这里是转义“@”的意思，fromQQ参数就是发给你私聊消息那个人的QQ。你可以在右边的文档链接里了解到。[https://d.cqp.me/Pro/CQ%E7%A0%81][https_d.cqp.me_Pro_CQ_E7_A0_81]

哦，对了，这也是我说为什么要两个QQ的原因，不然你在尝试加载插件后，可能会出现下面的场景：

![1598513-20190711084332249-243450970.png][]

![1598513-20190711084356268-1245401992.png][]

3.7 尝试编译并载入插件

使用 静态编译 生成 app.dll

复制你的appid，将目录名称com.example.demo,修改为你的appid。

将它这个目录移动到/dev下，确保这个路径里有以下两个文件 app.dll app.json.

按照之前的步骤打开应用管理，你将看到这样一些属性。

![1598513-20190711081435392-879689139.png][]

在菜单里，还能看到 设置A和设置B，点击它，居然出现了弹框，哇好神奇啊！再仔细比对代码，咦，这不就是\_menuA和\_menuB么。

但是你找遍代码也没找到设置的点对不对？

没错，是时候打开/dev/appid/下的app.json了！

3.8　　分析Json

【又见vs..... 谁让你是我的默认编辑器呢。】

很明显了，所有的参数都在里面，包括函数的使用。

![1598513-20190711083254055-543228684.png][]

![1598513-20190711083333847-37487411.png][]

我懒得讲...你也懒得看。

3.9 修改DEMO。

这个也不说了，这是编程最好的学习方式。

4.通过上面的这些介绍，于是你很容易就能做出各种各样的插件：

以下是昨天制作的群消息定时发送插件，但是据开发规范2.2，此类工具具有非常高的风险，所以不会公布源文件。请大家理解并支持CQ。

![1598513-20190711085101411-1327972002.png][]![1598513-20190711085245517-744789027.png][]

使用效果。

![1598513-20190711090418719-695385050.png][]

以上仅总结我的个人经验，单纯的为了出于学习的目的，由于没有了解到到CQ的开发者规范，造成了不好的影响，非常抱歉。

转载于:https://www.cnblogs.com/lingqingxue/p/11167169.html

[https_cqp.cc_forum.php]: https://cqp.cc/forum.php?
[Link 1]: https://cqp.cc/t/28126
[Link 2]: https://cqp.cc/t/23520
[https_cqp.cc_t_15124]: https://cqp.cc/t/15124
[https_d.cqp.me_Pro]: https://d.cqp.me/Pro/%E5%BC%80%E5%8F%91
[https_cqp.cc_t_23253_pid873447]: https://cqp.cc/t/23253#pid873447
[https_ssl.zc.qq.com_v3_index-chs.html]: https://ssl.zc.qq.com/v3/index-chs.html
[https_d.cqp.me_Pro 1]: https://d.cqp.me/Pro/%E5%BC%80%E5%8F%91/%E5%9F%BA%E7%A1%80%E4%BF%A1%E6%81%AF
[1598513-20190711075231391-1582904252.png]: /images/20211026/af48dd9cfa0a49a2b47badda40ccf30d.png
[https_d.cqp.me_Pro_CQ_E7_A0_81]: https://d.cqp.me/Pro/CQ%E7%A0%81
[1598513-20190711084332249-243450970.png]: /images/20211026/70935abbd52d4862beef3dbdae52005d.png
[1598513-20190711084356268-1245401992.png]: /images/20211026/9201accf72dc4fbd80f7792550525ad7.png
[1598513-20190711081435392-879689139.png]: /images/20211026/4f5fe35141e744cf97944bc71c7d89c4.png
[1598513-20190711083254055-543228684.png]: /images/20211026/f4c8725617634d17bb06251eb8f61725.png
[1598513-20190711083333847-37487411.png]: /images/20211026/bde5a693a0ee4322a303405c94c5aa2c.png
[1598513-20190711085101411-1327972002.png]: https://img2018.cnblogs.com/blog/1598513/201907/1598513-20190711085101411-1327972002.png
[1598513-20190711085245517-744789027.png]: /images/20211026/800876e141a84ac98aab9ed7860de584.png
[1598513-20190711090418719-695385050.png]: /images/20211026/d64cc1e73a8148b1af8a2d1d514c136d.png