初始化/登录
class wxpy.Bot(cache_path=None, console_qr=False, qr_path=None, qr_callback=None, login_callback=None, logout_callback=None)
参数：
cache_path：设置当前会话缓存路径，并开启缓存功能；为None（默认）则不开启缓存功能；
开启缓存后可在短时间内避免重复扫码，缓存失效时会重新要求登陆;
设为True时，使用默认的缓存路径 ‘wxpy.pkl’;
console_qr：在终端中显示登陆二维码，需要安装 pillow 模块 (pip3 install pillow)；
可为整数(int)，表示二维码单元格的宽度，通常为 2 (当被设为 True 时，也将在内部当作 2)
也可为负数，表示以反色显示二维码，适用于浅底深字的命令行界面;
qr_path：保存二维码的路径
qr_path： 获得二维码后的回调，可以用来定义二维码的处理方式，接收参数: uuid, status, qrcode
login_callback – 登陆成功后的回调，若不指定，将进行清屏操作，并删除二维码文件
logout_callback – 登出时的回调
Bot.enable_puid(path='wxpy_puid.pkl')
# 启用 puid 属性，并指定 puid 所需的映射数据保存/载入路径
bot.enable_puid('wxpy_puid.pkl')
# 指定一个好友
my_friend = bot.friends().search('游否')[0]
# 查看他的 puid
print(my_friend.puid)
# 'edfe8468'
启用聊天对象的 puid 属性:wxpy 特有的聊天对象/用户ID,不同于其他 ID 属性，puid 可始终被获取到，且具有稳定的唯一性;
Bot.auto_mark_as_read::为 True 时，将自动消除手机端的新消息小红点提醒 (默认为 False);
获取聊天对象
Bot.self
机器人自身 (作为一个聊天对象);
|
1
2
3
4
5
6
|
# 在 Web 微信中把自己加为好友
bot.
self
.add()
bot.
self
.accept()
# 发送消息给自己
bot.
self
.send(
'能收到吗？'
)
|
Bot.file_helper
文件传输助手
Bot.friends(update=False)
参数：update – 是否更新
返回：聊天对象合合集
返回类型：wxpy.chats
Bot.groups(update=False,contact_only=False)
参数：update – 是否更新；contact_only=是否限于保存为联系人的群聊；
返回：聊天群聊合集
返回类型：wxpy.chats
Bot.maps(update=False)
参数：update – 是否更新；
返回：聊天对象合集
返回类型：wxpy.chats
Bot.chats(update=False)
参数：update – 是否更新；
返回：聊天对象合集
返回类型：wxpy.chats
搜索聊天对象
通过。search()获得的结果均为列表；若希望获得唯一结果，可使用ensure_one()
搜索好友：
# 搜索名称包含 '游否' 的深圳男性好友
found = bot.friends().search('游否', sex=MALE, city='深圳')
# [<Friend: 游否>]
# 确保搜索结果是唯一的，并取出唯一结果
youfou = ensure_one(found)
# <Friend: 游否>
搜索群聊：
# 搜索名称包含 'wxpy'，且成员中包含 `游否` 的群聊对象
wxpy_groups = bot.groups().search('wxpy', [youfou])
# [<Group: wxpy 交流群 1>, <Group: wxpy 交流群 2>]
在群聊中搜索：
# 在刚刚找到的第一个群中搜索 group = wxpy_groups[0] # 搜索该群中所有浙江的群友 found = group.search(province='浙江') # [<Member: 浙江群友 1>, <Group: 浙江群友 2>, <Group: 浙江群友 3> ...]
搜索任何类型的聊天对象 (但不包含群内成员)：
# 搜索名称含有 'wxpy' 的任何聊天对象
found = bot.search('wxpy')
# [<Friend: wxpy 机器人>, <Group: wxpy 交流群 1>, <Group: wxpy 交流群 2>]
加好友和建群
Bot.add_friend(user, verify_content='')
添加好友
参数：user – 用户对象，或 user_name；
verify_content – 验证说明信息
Bot.add_mp(user)
添加公众号
参数：user – 公众号对象，或 user_name；
Bot.accept_friend(user)
接收好友请求
参数：user – 用户对象，或 user_name；
verify_content – 验证说明信息
返回：新的好友对象
返回类型：wxpy.chats
自动接收好友请求：
# 注册好友请求类消息
@bot.register(msg_types=FRIENDS)
# 自动接受验证信息中包含 'wxpy' 的好友请求
def auto_accept_friends(msg):
# 判断好友请求中的验证文本
if 'wxpy' in msg.text.lower():
# 接受好友 (msg.card 为该请求的用户对象)
new_friend = bot.accept_friend(msg.card)
# 或 new_friend = msg.card.accept()
# 向新的好友发送消息
new_friend.send('哈哈，我自动接受了你的好友请求')
Bot.creaete_group(users,topic=None)
创建一个新的群聊
参数：users – 用户列表，不含自己，至少两位；
topic --群名称
返回：群建立成功，返回一个新的群聊对象
返回类型：wxpy.Group
其他
Bot.user_details(user_or_users,chunk_size=50)
获取单个或批量获取多个用户的详细信息(地区、性别、签名等)，但不可用于群聊成员
参数：user_or_users – 单个或多个用户对象或 user_name；
chunk_size – 分配请求时的单批数量，目前为 50
返回：单个或多个用户用户的详细信息
Bot.upload_file(path)
上传文件，并获取 media_id,可用于重复发送图片、表情、视频，和文件
参数：path – 文件路径；
返回：media_id
返回类型：str
Bot.join()
堵塞进程，直到结束消息监听 (例如，机器人被登出时)
Bot.logout()
登出当前账号
微信多开
初始化多个Bot对象，即可：
bot1 = Bot() bot2 = Bot()