群成员管理
获取群成员列表
获取指定群的群成员信息。必须加入此群才可获取;
- 调用接口:
imsdk->getGrpMemberList("groupID", CRIM_GMF_All, 0, 100);
相关API请参考:
获取群内指定群成员信息
获取群内指定的群成员信息,仅本群成员可调用。
- 调用接口:
QStringList userIDs{"id1", "id2"};
QByteArray byStr = QJsonDocument::fromVariant(QVariant(userIDs)).toJson(QJsonDocument::Compact);
imsdk->getSpecifiedGrpMembersInfo("groupID", byStr.constData(), 0, 100);
相关API请参考:
申请加入群组
申请加入群组,根据进群验证选项确定申请进群结果。
- 调用接口:
imsdk->joinGrp("groupID", "我是xxx", CRIM_JoinType_Search);
相关API请参考:
获取发出的入群申请列表
用户可获取自己发出的入群申请列表来查看申请状态
- 调用接口:
imsdk->getGrpReqListAsApplicant();
相关API请参考:
获取收到的入群申请列表
群主或管理员可获取成员的入群申请列表进行同意入群申请或拒绝入群申请操作
- 调用接口:
imsdk->getGrpReqListAsRecipient();
相关API请参考:
同意入群申请
群主或管理员调用接口可同意成员的入群申请,会触发申请方的notifyGrpReqAccepted回调
- 调用接口:
imsdk->acceptGrpReq("groupID", "reqUserID", "");
相关API请参考:
- acceptGrpReq
- acceptGrpReqSuccess
- acceptGrpReqFailure
- notifyGrpReqAccepted
- notifyGrpMemberAdded
- notifyJoinedGrpAdded
拒绝入群申请
群主或管理员调用接口可拒绝入群申请,会触发申请方的notifyGrpReqRejected回调
- 调用接口:
imsdk->refuseGrpReq("groupID", "reqUserID", "reason");
相关API请参考:
邀请入群
群组成员可邀请其他用户加入群组,无须对方同意,支持批量邀请。
- 调用接口:
QStringList userIDs{"id1", "id2"};
QByteArray byStr = QJsonDocument::fromVariant(QVariant(userIDs)).toJson(QJsonDocument::Compact);
imsdk->inviteUserToGrp("groupID",byStr.constData(),"reason");
相关API请参考:
- inviteUserToGrp
- inviteUserToGrpSuccess
- inviteUserToGrpFailure
- notifyJoinedGrpAdded
- notifyGrpMemberAdded
- notifyGrpReqAdded
踢出群
把群成员从群组中移除。群主和群管理员可移除普通成员,群主可移除管理员和普通成员。
- 调用接口:
QStringList userIDs{"id1", "id2"};
QByteArray byStr = QJsonDocument::fromVariant(QVariant(userIDs)).toJson(QJsonDocument::Compact);
imsdk->kickGrpMember("groupID",byStr.constData(),"reason");
相关API请参考:
- kickGrpMember
- kickGrpMemberSuccess
- kickGrpMemberFailure
- notifyJoinedGrpDeleted
- notifyGrpMemberDeleted
设置群成员本群昵称
群主可以修改管理员和普通成员的本群昵称,管理员可以修改普通成员的本群昵称。
- 调用接口:
imsdk->setGrpMemberNickname("groupID","uID","grpMemberNickname");
相关API请参考:
- setGrpMemberNickname
- setGrpMemberNicknameSuccess
- setGrpMemberNicknameFailure
- notifyGrpMemberInfoChanged
禁言群成员
群主可以禁言管理员和普通成员,管理员可以禁言普通成员。
- 调用接口:
//禁言uerID1 10分钟;(禁言0秒时,代表取消禁言)
imsdk->changeGrpMemberMute("groupID", "uerID1", 600);
相关API请参考:
修改群成员身份
群主可以修改管理员和普通成员的身份,管理员可以修改普通成员的身份。
- 调用接口:
imsdk->setGrpMemberRoleLevel("groupID","userID",2);
相关API请参考:
- setGrpMemberRoleLevel
- setGrpMemberRoleLevelSuccess
- setGrpMemberRoleLevelFailure
- notifyGrpMemberInfoChanged
搜索群成员
通过关键词搜索某个群的群成员。至少指定搜索UserID、搜索昵称中的一个搜索方式。
- 调用接口:
QVariantMap varMap;
varMap["groupID"] = groupID;
varMap["keywordList"] = QVariantList{"xx", "yy"};
varMap["isSearchUserID"] = false;
varMap["isSearchMemberNickname"] = true;
varMap["offset"] = 0;
varMap["count"] = 30;
QByteArray byStr = QJsonDocument::fromVariant(varMap).toJson(QJsonDocument::Compact);
imsdk->searchGroupMembers(byStr.constData());
相关API请参考: