资料介绍
软件简介
一、介绍
QQBot 是一个用 python 实现的、基于腾讯 SmartQQ 协议的简单 QQ 机器人,可运行在 Linux 和 Windows 平台下,所有代码均集成在一个 [qqbot.py][code] 文件中,代码量仅 400 多行(不包括注释)。程序采用单线程的方式运行,且尽可能的减少了网络和登录错误(特别是所谓的 103 error )发生的概率。
[code]: https://raw.githubusercontent.com/pandolia/qqbot/master/qqbot.py
本项目 github 地址: https://github.com/pandolia/qqbot/
你可以用 QQBot 来实现:
* 监控、收集 QQ 消息
* 自动消息推送
* 聊天机器人
* 通过 QQ 远程控制电脑、智能家电
二、安装方法
在 Python 2.7 下使用,用 pip 安装,安装命令:
$ pip install qqbot
也可以直接下载 [qqbot.py][code] 运行,但需先安装 [requests](https://pypi.python.org/pypi/requests) 库。
三、使用方法
##### 1. 启动 QQBot
在命令行输入: **qqbot** ,或直接运行 [qqbot.py][code] : **python qqbot.py** 。启动过程中会自动弹出二维码图片(Linux下需安装有 gvfs ,否则需要手动打开图片),需要用手机 QQ 客户端扫码并授权登录。启动成功后,会将本次登录信息保存到本地文件中,下次启动时,可以输入: **qqbot qq号码**,或:**python qqbot.py qq号码** ,先尝试从本地文件中恢复登录信息(不需要手动扫码),只有恢复不成功或登录信息已过期时才会需要手动扫码登录。
##### 2. 操作 QQBot
QQ 机器人启动后,用另外一个 QQ 向本 QQ 发送消息即可操作 QQBot 。目前提供以下命令:
1) 帮助:
-help
2) 列出 好友/群/讨论组:
-list buddy/group/discuss
3) 向 好友/群/讨论组 发送消息:
-send buddy/group/discuss uin message
其中 uin 是临时 qq 号,利用 -list 命令查看好友等的临时 qq 号。
4) 停止 QQBot :
-stop
四、实现你自己的 QQ 机器人
实现自己的 QQ 机器人非常简单,只需要继承 [qqbot.py][code] 中提供的 **QQBot** 类并重新实现此类中的消息响应方法 **onPullComplete** 方法。示例代码:
from qqbot import QQBot class MyQQBot(QQBot): def onPollComplete(self, msgType, from_uin, buddy_uin, message): if message == '-hello': self.send(msgType, from_uin, '你好,我是QQ机器人') elif message == '-stop': self.stopped = True self.send(msgType, from_uin, 'QQ机器人已关闭') myqqbot = MyQQBot() myqqbot.Login() myqqbot.PollForever()
以上代码运行后,用另外一个 QQ 向本 QQ 发送消息 **“-hello”**,则会自动回复 **“你好,我是 QQ 机器人”**,发送消息 **“-stop”** 则会关闭 QQ 机器人。
五、 QQBot 类中的主要方法、属性
#### 1. 构造方法、登录方法、主要属性
>>> bot = QQBot() >>> bot.Login() ...
构造方法生成一个 QQBot 实例,其实没做任何工作。全部的登录、获取 好友/群/讨论组 列表的工作在 **Login** 方法中完成。Login 方法会检查命令行参数 sys.argv 中是否提供了 qq 号码。若没有提供 qq 号码,则需要手动扫码登录。登录后会将登录信息保存在本地。若提供了 qq 号码,则会先尝试从本地恢复会话信息(不需要手动扫码),只有恢复不成功或登录信息已过期时才会需要手动扫码登录。
QQBot 登录完成后,可以进行消息收发了,且 好友/群/讨论组 的列表保存在 **buddy, buddyStr, group, groupStr, discuss, discussStr** 属性当中。
>>> bot.buddy ((1880557506, 'Jack'), (2776164208, 'Mike'), ..., (2536444957, 'Kebi')) >>> print bot.buddyStr
好友列表:
0, Jack (2348993434)
1, Mike (348093248)
...
#### 2. 消息收发
>>> bot.poll() ('buddy', 207353438, 207353438, 'hello') >>> bot.poll() ('', 0, 0, '') >>> bot.send('buddy', 45789321, 'hello')
向buddy45789321发送消息成功
**poll** 方法向 QQ 服务器查询消息,如果有未读消息则会立即返回,返回值为一个四元 tuple :
(msgType, from_uin, buddy_uin, message)
其中 **msgType** 可以为 **'buddy'** 、 **'group'** 或 **'discuss'**,分别表示这是一个 **好友消息** 、**群消息** 或 **讨论组消息** ; **from_uin** 和 **buddy_uin** 代表消息发送者的 **uin** ,可以通过 uin 向发送者回复消息,如果这是一个好友消息,则 from_uin 和 buddy_uin 相同,均为好友的 uin ,如果是群消息或讨论组消息,则 from_uin 为该群或讨论组的 uin , buddy_uin 为消息发送人的 uin ; **message** 为消息内容,是一个 **utf8** 编码的 string 。
如果没有未读消息,则 **poll** 方法会一直等待两分钟,若期间没有其他人发消息过来,则返回一个只含空值的四元 tuple :
('', 0, 0, '')
**send** 方法的三个参数为 **msgType** 、 **to_uin** 和 **message** ,分别代表 **消息类型** 、**接收者的 uin** 以及 **消息内容** ,消息内容必须是一个 **utf8** 编码的 string 。
如果发送消息的频率过快, qq 号码可能会被锁定甚至封号。因此每发送一条消息,会强制 sleep 3 秒钟,每发送 10 条消息,会强制 sleep 30 秒钟。同一条消息重复发送多次也可能被锁号或封号,因此每条消息发送之前都会在开头附加一个随机数字。
这里需要注意的是,当 poll 方法因等待消息而阻塞时,不要试图在另一个线程中调用 send 方法发送消息,也不要试图用多线程的方式同时调用 send 方法,否则可能引起一些无法预料的错误。
#### 3. 无限消息轮询
>>> bot.PullForever()
**PullForever** 方法会不停的调用 poll 方法,并将 poll 方法的返回值传递给 **onPullComplete** 方法,直到 stopped 属性变为 True 。如下:
def PollForever(self): self.stopped = False while not self.stopped: pullResult = self.poll() self.onPollComplete(*pullResult)
onPollComplete 方法是 QQ 机器人的灵魂。你可以自由发挥,重写此方法,实现更智能的机器人。
六、参考资料
QQBot 参考了以下开源项目:
- [ScienJus/qqbot](https://github.com/ScienJus/qqbothttps://github.com/pandolia/qqbot/) (ruby)
- [floatinghotpot/qqbot](https://github.com/floatinghotpot/qqbot) (node.js)
在此感谢以上两位作者的无私分享,特别是感谢 ScienJus 对 SmartQQ 协议所做出的深入细致的分析。
### 七、反馈
有任何问题或建议可以发邮件给我,邮箱:
- Python写机器人上位机 0次下载
- 基于深度学习的机器人示教系统设计与实现 76次下载
- 机器学习必学的Python代码示例集 10次下载
- 机器人无线充电电路设计 46次下载
- 基于Matlab的机构与机器人分析资料下载 10次下载
- 基于DSP和PC的农业机器人控制系统 16次下载
- 基于DSP的排险机器人车体控制系统 11次下载
- 基于DSP芯片的足球机器人实现与设计 24次下载
- 基于EtherCAT和TwinCAT3的协作机器人控制系统 14次下载
- 基于Python的scikit-learn包实现机器学习 11次下载
- python机器学习笔记资料免费下载 36次下载
- 如何实现双足机器人的步态规划与仿真研究 15次下载
- 如何使用Python实现QQ号码测吉凶API调用代码实例免费下载 12次下载
- 如何进行简易避障机器人的设计 25次下载
- 基于Scratch和ROS的教育机器人编程与实现 10次下载
- 机器人技术中常用的路径规划算法的开源库 370次阅读
- 基于Python实现随机森林算法 564次阅读
- 机器人定位是如何实现的? 761次阅读
- 如何使用Python直接给微信推送消息 1076次阅读
- 抽样在Python中是如何实现的 870次阅读
- MOTOMAN机器人实现对产品的精确控制设计 1993次阅读
- 面对疫情 医疗机器人能帮上什么忙? 2022次阅读
- 协作机器人的起源_为什么需要协作机器人 7894次阅读
- Python | 群聊太多?三步教你用Python自动监听转发群消息 3878次阅读
- 手把手教你用Python创建微信机器人 3234次阅读
- 工业机器人设计过程详解 1.3w次阅读
- 机器学习实例:Spark与Python结合设计 2609次阅读
- 机器人的最佳编程语言是什么?机器人十大流行编程语言汇总 3.4w次阅读
- Python+树莓派实现的微信拍摄机器人 1w次阅读
- 蚁群算法python编程实现 7225次阅读
下载排行
本周
- 1储能电源市场分析
- 7.99 MB | 6次下载 | 免费
- 2传感芯片选型指南
- 3.60 MB | 5次下载 | 免费
- 310 A 12-V输入非隔离降压开关电源模块PTH12060数据表
- 1.11MB | 1次下载 | 免费
- 450-A,4.5-V至14-V输入,非隔离,宽输出调节,采用TurboTrans™技术的电源模块PTH08T250W数据表
- 2.42MB | 1次下载 | 免费
- 532×4 LCD显示驱动芯片VK1C21系列数据手册
- 7.28 MB | 1次下载 | 免费
- 6IP5383 QFN60 规格书pdf
- 3.19 MB | 1次下载 | 免费
- 7具有DCS-Control™ 功能的 3V 到 17V 0.5A 降压转换器TPS6217x-Q1数据表
- 3.17MB | 1次下载 | 免费
- 8磁环电感定制时应该注意什么
- 0.32 MB | 1次下载 | 免费
本月
- 1ES9038PRO解码芯片的电路原理图介绍
- 0.25 MB | 33次下载 | 5 积分
- 2UHD智能显示SoC VS680产品简介
- 0.46 MB | 11次下载 | 免费
- 3STM32国内外发展现状
- 1.15 MB | 10次下载 | 免费
- 4TDK电容器产品指南
- 11.88 MB | 7次下载 | 1 积分
- 5CR6842 12V/5A 反激式开关电源方案介绍
- 0.10 MB | 6次下载 | 免费
- 6电池管理系统(BMS)软硬件介绍
- 0.23 MB | 6次下载 | 2 积分
- 716A 输出电流,高可靠、高效率 同步降压转换器PCD3201产品手册
- 0.47 MB | 6次下载 | 免费
- 8储能电源市场分析
- 7.99 MB | 6次下载 | 免费
总榜
- 1matlab软件下载入口
- 未知 | 935085次下载 | 免费
- 2开源硬件-PMP21529.1-4 开关降压/升压双向直流/直流转换器 PCB layout 设计
- 1.48MB | 420050次下载 | 免费
- 3Altium DXP2002下载入口
- 未知 | 233067次下载 | 免费
- 4电路仿真软件multisim 10.0免费下载
- 340992 | 191316次下载 | 免费
- 5十天学会AVR单片机与C语言视频教程 下载
- 158M | 183316次下载 | 免费
- 6labview8.5下载
- 未知 | 81567次下载 | 免费
- 7Keil工具MDK-Arm免费下载
- 0.02 MB | 73786次下载 | 免费
- 8NI LabVIEW中实现3D视觉的工具和技术
- 未知 | 70088次下载 | 免费
评论
查看更多