其他API
除了上面提到的主要API外,wxrobo也提供了一些其他API,因为难以分类,所以集中到此。
建立群聊
(state,errMsg,chatRoomName,deletedList,blockedList) = api.createChatroom(userNames)
其中userNames是一个列表,包含初始化群聊的人,注意是用户ID而不是备注名或昵称。自带命令delfriend
查找删除好友的功能就是借助与建立群聊的api。
返回值有多个:
- state是bool值,为True时说明建立群聊成功,否则失败;
- errMsg是失败信息,只有当state为False时才有内容;
- chatRoomName是建立的群聊的ID,后续需要加入成员还需要该参数;
- deletedList和blockedList是不能拉入群的成员列表,第一个是因为对方删除了你,第二个是因为对方将你加入黑名单;
拉成员进群聊
(state,errMsg,deletedList,blockedList) = api.addChatroomMember(chatRoomName,userNames)
参数和返回参数参考上一个API。
将成员拉出群聊
state = api.delChatroomMember(chatRoomName,userNames)
state是执行的状态,为True说明成功,反之则失败。
获取群成员的备注名或昵称
name = api.getBatchMemberRemarkName(groupid,memberid)
groupid是上文提到的chatRoomName,memberid则是群成员的id,最后返回备注名或昵称。
得到用户的备注名或昵称
name = api.getUserRemarkName(id)
得到用户的id
id = api.getUserId(name)