| verify_content | 验证说明信息 |
返回:新的好友对象
返回类型:wxpy.Friend
其他属性
.mark_as_read()
消除当前聊天对象的未读提示小红点
.pin()
将聊天对象置顶
.unpin()
取消聊天对象的置顶状态
.get_avatar(save_path=None)
获取头像
参数: save_path – 保存路径(后缀通常为.jpg),若为 None 则返回字节数据
.uin
微信中的聊天对象ID,固定且唯一
因微信的隐私策略,该属性有时无法被获取到
建议使用 puid 作为用户的唯一 ID
.alias
若用户进行过一次性的 “设置微信号” 操作,则该值为用户设置的”微信号”,固定且唯一
因微信的隐私策略,该属性有时无法被获取到
建议使用 puid 作为用户的唯一 ID
.wxid
聊天对象的微信ID (实际为 .alias 或 .uin)
因微信的隐私策略,该属性有时无法被获取到
建议使用 puid 作为用户的唯一 ID
.user_name
该聊天对象的内部 ID,通常不需要用到
注意:同个聊天对象在不同用户中,此 ID 不一致 ,且可能在新会话中 被改变!
.send(content=None, media_id=None)
动态发送不同类型的消息,具体类型取决于 content 的前缀
| 参数 | 说明 |
| :-- | :-- |
| content | 由 前缀 和 内容 两个部分组成,若 省略前缀,将作为纯文本消息发送
前缀 部分可为: @fil@: 文件,@img@: 图片,@msg@: 纯文本,@vid@: 视频
内容 部分可为: 文件、图片、视频的路径,或纯文本的内容 |
| media_id | 填写后可省略上传过程 |
返回类型:wxpy.SentMessage
发送文本
.send_msg(msg=None)
| 参数 | 说明 |
| :-- | :-- |
| msg | 文本内容 |
发送图片
.send_image(path, media_id=None)
| 参数 | 说明 |
| :-- | :-- |
| path | 文件路径 |
| media_id | 设置后可省略上传过程 |
发送视频
.send_video(path=None, media_id=None)
| 参数 | 说明 |
| :-- | :-- |
| path | 文件路径 |
| media_id | 设置后可省略上传过程 |
发送文件
my_friend.send_file(path, media_id=None)
| 参数 | 说明 |
| :-- | :-- |
| path | 文件路径 |
| media_id | 设置后可省略上传过程 |
以原始格式发送其他类型消息
send_raw_msg(raw_type, raw_content, uri=None, msg_ext=None)
| 参数 | 说明 |
| :-- | :-- |
| raw_type: int | 原始的整数消息类型 |
| raw_content: str | 原始的消息内容 |
| uri: str | 请求路径,默认为 ‘/webwxsendmsg’ |
| msg_ext: dict | 消息的扩展属性 (会被更新到 Msg 键中) |
注册函数
可通过预先注册的方式,实现消息的自动处理。
预先将特定聊天对象的特定类型消息,注册到对应的处理函数,以实现自动回复等功能。
每当收到新消息时,将根据注册规则找到匹配条件的执行函数。并将消息对象作为唯一参数传入该函数。
将 bot.register() 作为函数的装饰器,即可完成注册。
bot.register(chats=None, msg_types=None, except_self=True, run_async=True, enabled=True
其中msg_types参数,是指定接收消息的类型,wxpy中支持以下消息类型:
| 值 | 描述 |
| :-- | :-- |
| TEXT 或 ‘Text’ | 文本 |
| MAP 或 ‘Map’ | 位置 |
| CARD 或 ‘Card’ | 名片 |
| NOTE 或 ‘Note’ | 提示 |
| SHARING 或 ‘Sharing’ | 分享 |
| PICTURE 或 ‘Picture’ | 图片 |
| RECORDING 或 ‘Recording’ | 语音 |
| ATTACHMENT 或 ‘Attachment’ | 文件 |
| VIDEO 或 ‘Video’ | 视频 |
| FRIENDS 或 ‘Friends’ | 好友请求 |
| SYSTEM 或 ‘System’ | 系统 |
其他参数
| 参数 | 描述 |
| :-- | :-- |
| chats | 消息所在的聊天对象:单个或列表形式的多个聊天对象或聊天类型,为空时匹配所有聊天对象;
既可以是聊天对象实例,也可以是对象类。当为类时,表示匹配该类型的所有聊天对象。 |
| msg_types | 消息的类型:单个或列表形式的多个消息类型,为空时匹配所有消息类型 (SYSTEM 类消息除外) |
| except_self | 排除由自己发送的消息 |
| run_async | 是否异步执行所配置的函数:可提高响应速度 |
| enabled | 当前配置的默认开启状态,可事后动态开启或关闭 |
在被注册函数中,可以通过直接 return <回复内容> 的方式来回复消息,等同于调用 msg.reply(<回复内容>)。
Message 消息对象
每当机器人接收到消息时,会自动执行以下两个步骤:
1.将消息保存到 Bot.messages 中
2.查找消息预先注册的函数,并执行(若有匹配的函数)
基本属性
消息的类型
Message.type
返回消息的类型:str
机器人对象
Message.bot
接收此消息的机器人对象
消息的唯一 ID
Message.id
(通常为大于 0 的 64 位整型)
内容数据
消息的文本内容
Message.text
下载图片、视频、语音、附件消息中的文件内容
可与 Message.file_name 配合使用
参数: save_path – 文件的保存路径。若为 None,将直接返回字节数据
Message.get_file(save_path=None)
消息中文件的文件名
Message.file_name
消息中文件的体积大小
Message.file_size
文件类消息中的文件资源 ID (但图片视频语音等其他消息中为空)
Message.media_id
原始数据 (dict 数据
)Message.raw
用户相关
Message.chat
消息所在的聊天会话
对于自己发送的消息,为消息的接收者
对于别人发送的消息,为消息的发送者
返回类型:wxpy.User, wxpy.Group
Message.sender
消息的发送者
返回类型: wxpy.User, wxpy.Group
Message.receiver
消息的接收者
返回类型:wxpy.User, wxpy.Group
Message.member
消息的实际发送人
若消息来自群聊,则此属性为消息的实际发送人(具体的群成员)
若消息来自其他聊天对象(非群聊),则此属性为 None# 返回类型:NoneType, wxpy.Member
Message.card
#好友请求中的请求用户
#名片消息中的推荐用户
群聊相关
Message.member
发送人
若消息来自群聊,则此属性为消息的实际发送人(具体的群成员)
若消息来自其他聊天对象(非群聊),则此属性为 None
返回类型: NoneType,wxpy.Member
Message.is_at
是否被 @
当消息来自群聊,且被 @ 时,为 True
时间相关
服务端发送时间
Message.create_time
本地接收时间
Message.receive_time
消息的延迟秒数 (发送时间和接收时间的差值)
Message.latency
不同类型消息
图片、视频、语音
图片高度
Message.img_height
图片宽度
Message.img_width
视频长度
Message.play_length
语音长度
Message.voice_length
文章
一、Python所有方向的学习路线
Python所有方向的技术点做的整理,形成各个领域的知识点汇总,它的用处就在于,你可以按照下面的知识点去找对应的学习资源,保证自己学得较为全面。
二、Python必备开发工具
工具都帮大家整理好了,安装就可直接上手!
三、最新Python学习笔记
当我学到一定基础,有自己的理解能力的时候,会去阅读一些前辈整理的书籍或者手写的笔记资料,这些笔记详细记载了他们对一些技术点的理解,这些理解是比较独到,可以学到不一样的思路。
四、Python视频合集
观看全面零基础学习视频,看视频学习是最快捷也是最有效果的方式,跟着视频中老师的思路,从基础到深入,还是很容易入门的。
五、实战案例
纸上得来终觉浅,要学会跟着视频一起敲,要动手实操,才能将自己的所学运用到实际当中去,这时候可以搞点实战案例来学习。
六、面试宝典
简历模板
小编13年上海交大毕业,曾经在小公司待过,也去过华为、OPPO等大厂,18年进入阿里一直到现在。
深知大多数初中级Python工程师,想要提升技能,往往是自己摸索成长或者是报班学习,但自己不成体系的自学效果低效又漫长,而且极易碰到天花板技术停滞不前!
因此收集整理了一份《2024年Python爬虫全套学习资料》送给大家,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。
由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频
如果你觉得这些内容对你有帮助,可以添加下面V无偿领取!(备注:python)
六、面试宝典
简历模板
小编13年上海交大毕业,曾经在小公司待过,也去过华为、OPPO等大厂,18年进入阿里一直到现在。
深知大多数初中级Python工程师,想要提升技能,往往是自己摸索成长或者是报班学习,但自己不成体系的自学效果低效又漫长,而且极易碰到天花板技术停滞不前!
因此收集整理了一份《2024年Python爬虫全套学习资料》送给大家,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。
由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频
如果你觉得这些内容对你有帮助,可以添加下面V无偿领取!(备注:python)
[外链图片转存中…(img-xMvgtxVt-1710974422914)]