其他API

除了上面提到的主要API外,wxrobo也提供了一些其他API,因为难以分类,所以集中到此。

建立群聊

(state,errMsg,chatRoomName,deletedList,blockedList) = api.createChatroom(userNames)其中userNames是一个列表,包含初始化群聊的人,注意是用户ID而不是备注名或昵称。自带命令delfriend查找删除好友的功能就是借助与建立群聊的api。

返回值有多个:

  1. state是bool值,为True时说明建立群聊成功,否则失败;
  2. errMsg是失败信息,只有当state为False时才有内容;
  3. chatRoomName是建立的群聊的ID,后续需要加入成员还需要该参数;
  4. 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)