4. 通讯录相关

4.1 获取通讯录好友

获取粗略信息

wx.GetAllFriends

参数：

参数名	类型	默认值	说明
keywords	str	None	搜索并筛选关键词

示例：

>>> wx.GetAllFriends()
[{'nickname': '张三', 'remark': '张总', 'tags': None},
 {'nickname': '李四', 'remark': None, 'tags': ['同事', '初中同学']},
 {'nickname': '王五', 'remark': None, 'tags': None},
...]

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

返回值是一个list，列表元素为dict，每个dict包含了一个好友的粗略信息

获取详细信息

wx.GetFriendDetails

参数：

参数名	类型	默认值	说明
n	int	None	获取前n个好友详情信息, 默认为None，获取所有好友详情信息
tag	str	'A'	从哪个标签开始获取，A-Z其中一个
timeout	int	0xFFFFF	获取好友详情信息的超时时间，单位为秒

示例：

>>> wx.GetFriendDetails()
[{'微信号：': 'abc123456',
  '地区：': '上海 浦东新区',
  '备注': '',
  '标签': 'wxauto',
  '共同群聊': '1个',
  '来源': '通过扫一扫添加',
  '昵称': '张三'},
{'备注': '',
 '企业': '广州融创文旅城',
 '实名': '**莹',
 '官方商城': '🎫购滑雪票入口🎫',
 '通知': '回复时间为工作日9点-18点',
 '会员商城': '🏂热雪值兑换雪票🏂',
 '冰箱赞滑': '👬申请冰箱主理人👭',
 '全民滑雪': '购票赢黄金会籍',
 '共同群聊': '1个',
 '昵称': '广州大冰箱'},...]

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

返回值是一个list，列表元素为dict，每个dict包含了一个好友的详细信息

4.2 获取群列表

wx.GetAllRecentGroups

参数：

参数	类型	默认值	说明
speed	int	1	动速度，数值越大滚动越快，但是太快可能导致遗漏，建议速度1-3之间
wait	float	0.05	滚动等待时间，建议和speed一起调整，直至适合你电脑配置和微信群数量达到平衡，不遗漏数据

示例：

groups = wx.GetAllRecentGroups()
# [
#     ('工作群', '500')
#     ('街坊群', '456')
#     ('八卦群', '123')
#     ...
# ]

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

返回值格式为list，列表元素为元组，格式为('群聊名', '人数')