Traceless.OPQSDK 0.0.31

.NET Core 3.1 
dotnet add package Traceless.OPQSDK --version 0.0.31
NuGet\Install-Package Traceless.OPQSDK -Version 0.0.31
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Traceless.OPQSDK" Version="0.0.31" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add Traceless.OPQSDK --version 0.0.31
#r "nuget: Traceless.OPQSDK, 0.0.31"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
// Install Traceless.OPQSDK as a Cake Addin
#addin nuget:?package=Traceless.OPQSDK&version=0.0.31

// Install Traceless.OPQSDK as a Cake Tool
#tool nuget:?package=Traceless.OPQSDK&version=0.0.31

Traceless.OPQ

OPQ C# SDK 【netcore 3.1】

这里是Netcore 3.1 OPQ C# SDK

.NET Core NuGet

WIKI点击进入

我的测试环境：Linux centos 3.10.0-1127.el7.x86_64

开发【直接使用本库】
  1. clone本库
  2. 复制Traceless.Robot.Plugins.MyPlugin并更改插件名，修改插件信息
  3. 在事件中完成逻辑开发
  4. 完成
开发【使用Nuget】

  1. 新建项目

  2. Nuget引用Traceless.OPQSDK

  3. 在程序某处添加代码 await OPQSDK.Plugin.OPQMain.Client();

  4. 创建<项目命名空间>.Plugins.<你的插件Class名称>,并使用OPQSDK.Plugin.BasePlugin作为基类，如MyPlugin

  5. 在事件中完成逻辑开发

  6. 完成

使用
  1. 配置App.config，设置OPQ地址及机器人QQ【你也可以直接修改运行目录下的<程序集名称>.config文件】
  2. 编译【自己选择平台，理论上netcore支持的平台，SDK也都支持（艹那不是全平台了么）】
  3. 发布【发布到对应机器上】
  4. 启动【启动对应平台文件 win可直接支持exe，linux需安装dotnet环境 使用dotnet命令启动，当然如果带着依赖的独立包的话，就不需要dotnet环境了】

TODO

  1. 更优雅的接口调用
  2. ......

已完成

  1. 重构basePlugin，不再使用反射调用事件方法 ✔
  2. 增加OPQ码机制，功能类似酷Q码 ✔
  3. 修复了获取群列表和群成员列表出现的NPE问题 ✔
  4. 增加发送消息接口延迟等待机制，减少调用发送接口过于频繁产生消息丢失的可能性 ✔
  5. 增加腾讯AI平台-智能闲聊\语音合成 接口 ✔
  6. 采用V6版本框架，发送消息使用SendMsgV2 ✔
  7. 简化发送消息接口，去除语音\图片参数，统一使用OPQ码 ✔
  8. 拆分原先的EventQQGroupInvite 为 1入群请求\2加群请求被同意\5退群，不再需要在EventQQGroupInvite中按照Type判断了【其他ttype类型功能不明，仍然在该事件中回调】 ✔
项目结构

Traceless.OPQSDK：SDK本体，不做二次开发无需修改，SDK更新替换即可

Traceless.SocketIO：基于Websocket4Net的Socket.io实现【用于连接socket接收事件】

Traceless.Utils：一些工具方法

  1. 高效、自带并发控制、内存控制等netcore自带HttpclientFactory的控制台使用实现
  2. 腾讯AI开放平台-智能闲聊及语音合成（AILab）实现
  3. 随机工具类
  4. 腾讯文本理解工具与服务（使用AI分析自然语言）说明文档
  5. QQ音乐搜索与获取

Traceless.Robot：SDK宿主程序，本DEMO实用Netcore控制台程序，你也可以使用任何程序作为宿主程序

Api支持备注

涉及支付、转账的接口不对接，如 转账\获取钱包余额\发红包 等

Api支持【持续更新中】
API 可用 测试过 备注
发群消息【图片、语音、文字】 ✔ ✔ 语音\图片采用在文本信息中加入OPQ码方式发送，简化发送接口 参考MyPlugin
发好友消息【图片、语音、文字】 ✔ ✔ 语音\图片采用在文本信息中加入OPQ码方式发送，简化发送接口 参考MyPlugin
群组管理 ✔ ✔ 加群 拉人 踢群 退群
添加好友 ✔ ✔
获取好友列表 ✔ ✔
获取群组列表 ✔ ✔
撤回消息 ✔ ✔
搜索群组 ✔ ✔
群成员列表 ✔ ✔
QQ资料卡点赞 ✔ ✔
获取QQ相关ck ✔ ✔
处理好友请求 ✔ ✔
处理群邀请 ✔ ✔
修改群名片 ✔ ✔
设置头衔 ✔ ✔
发送群公告 ✔ ✔
获取任意用户信息昵称头像等 ✔ ✔
全员禁言开启/关闭 ✔ ✔
禁言某人 ✔ ✔
三方Api支持【持续更新中】
API 可用 测试过 备注
获取插件数据根目录 ✔ ✔
事件支持【理论上全都可用，欢迎提交Issue帮我完成测试】
事件 可用 测试过 备注
群消息 ✔ ✔
私聊消息 ✔ ✔
QQ登陆成功事件 ✔ ✖
网络变化事件 ✔ ✖ 网络波动引起当前链接 释放 随机8-15s会自动重连登陆 被t下线的QQ 不会在重连
QQ离线事件 ✔ ✖ 可能的原因(TX 踢号/异地登陆/冻结/被举报等 导致等Session失效)
加好友申请被同意/拒绝 ✔ ✔
主动删除了好友 ✔ ✔
加好友成功后的通知 ✔ ✔
收到好友请求 ✔ ✔
退群成功 ✔ ✔
好友消息撤回 ✔ ✔
群禁言 ✔ ✔
群撤回 ✔ ✔
群头衔变更 ✔ ✔
加群请求 ✔ ✔
群管理变更 ✔ ✔ 机器人是不是管理员都能收到此群管变更事件
有人退群 ✔ ✔ 无论机器人是不是管理员 群里任意成员 都能收到 此退群事件
加群成功 ✔ ✔
收到群邀请 ✔ ✔
OPQ码
类型 格式 说明 是否OPQ自带 备注
AT人 [ATUSER(QQ号)] AT某个人 ✔
AT全体 [ATALL()] AT全体 ✔
获取昵称 [GETUSERNICK(QQ号)] 获取某个人的QQ昵称 ✔
网络图片 [CODE:pic,url=网络图片URL,path=本地图片路径,flash=是否闪照] 表示发送某张网络\本地图片 ✖ 网络图片需要带https/http标头
语音 CODE:voice,url=语音URL,path=本地语音路径] 表示发送某段网络\本地语音 ✖ 语音URL为OPQ语音消息返回体中的url，暂不支持自定义网络url
富文本分享卡片 [CODE:rich,url=跳转地址,title=标题,desc=描述,prompt=在聊天列表里的缩略信息,preview=缩略图,tag=左角标的说明] 表示发送具有点击跳转功能的卡片 ✖ 地址\缩略图 需要http(s)地址

参考项目：

C# 插件 By:枫林

仓鼠的QQ Bot框架-Java版本

License

FOSSA Status

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp3.1 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
0.0.31 397 10/12/2021
0.0.30 799 11/18/2020
0.0.28 463 11/6/2020
0.0.27 423 10/23/2020
0.0.26 499 10/12/2020
0.0.25 474 10/12/2020
0.0.24 455 10/10/2020
0.0.23 474 10/10/2020
0.0.22 505 10/9/2020
0.0.21 444 9/30/2020
0.0.20 439 9/30/2020
0.0.19 491 9/30/2020
0.0.18 458 9/29/2020
0.0.17 461 9/29/2020
0.0.16 476 9/27/2020
0.0.15 462 9/23/2020
0.0.14 489 9/22/2020
0.0.13 440 9/22/2020
0.0.12 454 9/17/2020
0.0.11 443 9/11/2020
0.0.10 525 9/11/2020
0.0.10-Test 438 9/11/2020
0.0.9 456 9/11/2020
0.0.8 491 9/10/2020
0.0.7 467 9/10/2020
0.0.6 518 9/4/2020
0.0.5 528 9/4/2020
0.0.3 462 9/4/2020
0.0.2 475 9/4/2020