7.1.1 好友消息

FriendMessage

支持属性

属性名	类型	说明
type	str	消息类型，固定为friend
content	str	消息内容
sender	str	发送者
sender_remark	str	发送者备注名
info	list	原始消息信息，包含了消息的所有信息
control	uiautomation.Control	该消息的uiautomation控件
id	str	消息id

...  # 此处省略wx对象的初始化
msgs = wx.GetAllMessage()
for msg in msgs:
    if msg.type == 'friend':
        sender = msg.sender # 这里可以将msg.sender改为msg.sender_remark，获取备注名
        print(f'{sender}：{msg.content}')

支持方法

引用消息quote方法

参数：

参数	类型	默认值	说明
msg	str	/	要回复的消息内容

示例：

text = '补充说明一下：xxxx'
msg.quote(text)

返回值：无

转发消息forward方法

参数：

参数	类型	默认值	说明
friend	str	/	要转发给谁，昵称、备注、微信号都可以，手机号不可以

示例：

friend = '好友昵称'
msg.forward(friend)

返回值(bool)：

返回值为bool格式，是否转发成功

解析合并消息parse方法

参数：无

示例：

# 解析合并消息内容，可以用msg.content == '[聊天记录]' 来判断是否为合并消息
if msg.content == '[聊天记录]':
    parse_result = msg.parse()

返回值(List[List[str]])：

返回值为list，list中元素为包含消息详情的list，消息详情有三个：消息发送者昵称、消息内容、时间

获取发送者信息sender_info方法

参数：无

示例：

if msg.type == 'friend':
    info = msg.sender_info()

返回值(Dict[str, str])：

返回值为一个dict，包含了发送人的基本信息，例如：

{'nickname': '张三',
'id': 'abc1234',
'remark': None,
'tags': 'wxauto',
'source': '通过扫一扫添加',
'signature': '个性签名',
'area': '上海',
'same_group': '1个'}

添加发送人为好友add_friend方法

参数：

参数	类型	默认值	说明
addmsg	str	None	添加好友的消息
remark	str	None	备注名
tags	list	None	标签列表
permission	str	'朋友圈'	朋友圈权限, 可选值：'朋友圈', '仅聊天'

示例：

addmsg = '你好，我是xxxx'      # 添加好友的消息
remark = '备注名字'            # 备注名
tags = ['朋友', '同事']        # 标签列表
msg.add_friend(addmsg=addmsg, remark=remark, tags=tags)

返回值(int)：

0 - 添加失败

1 - 发送请求成功

2 - 已经是好友

3 - 对方不允许通过群聊添加好友

拍一拍tickle方法

参数：无

示例：

# 拍一拍发这条消息的好友（群友）
msg.tickle()

返回值：无

点击click方法

参数：无

示例：

# 点击这个消息（图片、链接等）
msg.click()