ricq
| Crates.io | ricq |
| lib.rs | ricq |
| version | 0.1.19 |
| source | src |
| created_at | 2022-05-07 16:06:09.330904 |
| updated_at | 2022-12-11 16:15:36.233175 |
| description | Android IM protocol |
| homepage | https://github.com/lz1998/ricq |
| repository | https://github.com/lz1998/ricq |
| max_upload_size | |
| id | 582175 |
| size | 160,433 |
(lz1998)
documentation
README
RICQ
QQ Android 协议的 Rust 实现，移植于 OICQ。
- ricq：提供异步 API
- ricq-core：不带 IO 的数据包构造器、解析器（通常用于 FFI）
- ricq-axum-api：提供 HTTP API 形式的登录接口，配合 ricq-react-ui，只需要开发登录后的逻辑。
如何使用
本项目是协议 Lib，如果需要直接使用，可以参考 examples 中的例子进行开发。
普通开发者推荐使用 SDK、框架进行开发：
| 框架 / SDK | 语言 | 说明 |
|---|---|---|
| rust_proc_qq | Rust | 模仿rocket |
| Walle-Q | - | onebot协议 |
| pbrq | - | websocket+protobuf协议（附带Web-UI） |
| atri_qq | - | 加载原生动态库插件，高性能低占用 |
| awr | Python | 基于 ricq 包装，供 Python 使用的 QQ 无头客户端。 |
本项目是一个年轻的项目，请使用 Nightly 工具链构建本项目哦（正经人谁用 Stable 啊）
相关项目
| 项目 | 描述 |
|---|---|
| lomirus/gtk-qq | Unofficial Linux QQ client, based on GTK4 and libadwaita, developed with Rust and Relm4. |
| a1967629423/esp32c3-rs-qq | 在单片机上运行QQ |
已完成功能 / 开发计划
登录
- 账号密码登录
- 二维码登录
- 验证码提交
- 设备锁验证
- 错误信息解析
消息类型
- 文本
- 表情
- At
- 回复
- 匿名
- 骰子
- 石头剪刀布
- 图片
- 语音
- 长消息（仅支持群聊发送）
- 合并转发（仅支持群聊发送）
- 链接分享
- 小程序（暂只支持 RAW）
- 短视频
- 群文件（上传与接收信息）
事件
- 群消息
- 好友消息
- 新好友请求
- 收到其他用户进群请求
- 新好友
- 群禁言
- 好友消息撤回
- 群消息撤回
- 收到邀请进群请求
- 群名称变更
- 好友删除
- 群成员权限变更
- 新成员进群 / 退群
- 登录号加群
- 临时会话消息
- 群解散
- 登录号退群（包含踢出）
- 客户端离线
- 群提示（戳一戳 / 运气王等）
主动操作
为防止滥用，将不支持主动邀请新成员进群
- 修改昵称
- 发送群消息
- 获取群列表
- 获取群成员列表
- 获取好友列表 / 分组
- 获取好友个性签名
- 添加 / 删除 / 重命名好友分组
- 群成员禁言 / 解除禁言
- 踢出群成员
- 戳一戳群友
- 戳一戳好友
- 设置群管理员
- 设置群公告
- 设置群名称
- 全员禁言
- 获取群@全体剩余次数
- 翻译
- 修改群成员头衔
- 设置群精华消息
- 发送好友消息
- 发送临时会话消息
- 修改群成员 Card
- 撤回群消息
- 撤回好友消息
- 处理被邀请加群请求
- 处理加群请求
- 处理好友请求
- 删除好友
- 获取陌生人信息
- 设置在线状态
- 修改个人资料
- 修改个性签名
- 获取群文件下载链接
- 获取群荣誉（龙王 / 群聊火焰等）
-
群成员邀请
敏感操作
由于 QQ 钱包支付用户服务协议, 将不提供一切有关 QQ 钱包的功能。
4.13 您不得利用本服务实施下列任一的行为：
（9） 侵害 QQ 钱包支付服务系統；
-
QQ 钱包协议（收款 / 付款等）