IMSDK
即时通信 IM 提供全球接入、单聊、群聊、消息推送、资料关系链托管、账号鉴权等全方位解决方案,并提供完备的 App 接入、后台管理接口。
V2TIMManager(Group)

构造函数

(void) - createGroup:memberList:succ:fail:
 
(void) - getJoinedGroupList:fail:
 
(void) - getGroupsInfo:succ:fail:
 
(void) - searchGroups:succ:fail:
 
(void) - setGroupInfo:succ:fail:
 
(void) - initGroupAttributes:attributes:succ:fail:
 
(void) - setGroupAttributes:attributes:succ:fail:
 
(void) - deleteGroupAttributes:keys:succ:fail:
 
(void) - getGroupAttributes:keys:succ:fail:
 
(void) - getGroupOnlineMemberCount:succ:fail:
 
(void) - setGroupCounters:counters:succ:fail:
 
(void) - getGroupCounters:keys:succ:fail:
 
(void) - increaseGroupCounter:key:value:succ:fail:
 
(void) - decreaseGroupCounter:key:value:succ:fail:
 
(void) - getGroupMemberList:filter:nextSeq:succ:fail:
 
(void) - getGroupMembersInfo:memberList:succ:fail:
 
(void) - searchGroupMembers:succ:fail:
 
(void) - setGroupMemberInfo:info:succ:fail:
 
(void) - muteGroupMember:member:muteTime:succ:fail:
 
(void) - muteAllGroupMembers:isMute:succ:fail:
 
(void) - inviteUserToGroup:userList:succ:fail:
 
(void) - kickGroupMember:memberList:reason:duration:succ:fail:
 
(void) - setGroupMemberRole:member:newRole:succ:fail:
 
(void) - markGroupMemberList:memberList:markType:enableMark:succ:fail:
 
(void) - transferGroupOwner:member:succ:fail:
 
(void) - kickGroupMember:memberList:reason:succ:fail:
 
(void) - getGroupApplicationList:fail:
 
(void) - acceptGroupApplication:reason:succ:fail:
 
(void) - refuseGroupApplication:reason:succ:fail:
 
(void) - setGroupApplicationRead:fail:
 

Protected 类型

enum  V2TIMGroupAddOpt : NSInteger
 
enum  V2TIMGroupMemberResult : NSInteger
 
enum  V2TIMGroupMemberFilter : NSInteger
 
enum  V2TIMGroupApplicationType : NSInteger
 
enum  V2TIMGroupApplicationHandleStatus : NSInteger
 
enum  V2TIMGroupApplicationHandleResult : NSInteger
 
typedef void(^ V2TIMGroupInfoListSucc) (NSArray< V2TIMGroupInfo * > *groupList)
 
typedef void(^ V2TIMGroupInfoResultListSucc) (NSArray< V2TIMGroupInfoResult * > *groupResultList)
 
typedef void(^ V2TIMGroupAttributeListSucc) (NSMutableDictionary< NSString *, NSString * > *groupAttributeList)
 
typedef void(^ V2TIMGroupMemberInfoListSucc) (NSArray< V2TIMGroupMemberFullInfo * > *memberList)
 
typedef void(^ V2TIMGroupMemberInfoResultSucc) (uint64_t nextSeq, NSArray< V2TIMGroupMemberFullInfo * > *memberList)
 
typedef void(^ V2TIMGroupMemberInfoListSearchSucc) (NSDictionary< NSString *, NSArray< V2TIMGroupMemberFullInfo * > * > *memberList)
 
typedef void(^ V2TIMGroupMemberOperationResultListSucc) (NSArray< V2TIMGroupMemberOperationResult * > *resultList)
 
typedef void(^ V2TIMGroupApplicationResultSucc) (V2TIMGroupApplicationResult *result)
 
typedef void(^ V2TIMGroupOnlineMemberCountSucc) (NSInteger count)
 
typedef void(^ V2TIMGroupCounterResultSucc) (NSDictionary< NSString *, NSNumber * > *groupCounters)
 

成员类型定义说明

◆ V2TIMGroupInfoListSucc

- (typedef void(^ V2TIMGroupInfoListSucc) (NSArray< V2TIMGroupInfo * > *groupList))
protected

获取已加入群列表成功回调

◆ V2TIMGroupInfoResultListSucc

- (typedef void(^ V2TIMGroupInfoResultListSucc) (NSArray< V2TIMGroupInfoResult * > *groupResultList))
protected

获取指定群列表成功回调

◆ V2TIMGroupAttributeListSucc

- (typedef void(^ V2TIMGroupAttributeListSucc) (NSMutableDictionary< NSString *, NSString * > *groupAttributeList))
protected

获取群属性列表成功回调

◆ V2TIMGroupMemberInfoListSucc

- (typedef void(^ V2TIMGroupMemberInfoListSucc) (NSArray< V2TIMGroupMemberFullInfo * > *memberList))
protected

获取群成员列表成功回调

◆ V2TIMGroupMemberInfoResultSucc

- (typedef void(^ V2TIMGroupMemberInfoResultSucc) (uint64_t nextSeq, NSArray< V2TIMGroupMemberFullInfo * > *memberList))
protected

获取指定群成员列表成功回调

◆ V2TIMGroupMemberInfoListSearchSucc

- (typedef void(^ V2TIMGroupMemberInfoListSearchSucc) (NSDictionary< NSString *, NSArray< V2TIMGroupMemberFullInfo * > * > *memberList))
protected

搜索群成员列表成功回调

◆ V2TIMGroupMemberOperationResultListSucc

- (typedef void(^ V2TIMGroupMemberOperationResultListSucc) (NSArray< V2TIMGroupMemberOperationResult * > *resultList))
protected

群成员操作成功回调

◆ V2TIMGroupApplicationResultSucc

- (typedef void(^ V2TIMGroupApplicationResultSucc) (V2TIMGroupApplicationResult *result))
protected

获取好友申请列表成功回调

◆ V2TIMGroupOnlineMemberCountSucc

- (typedef void(^ V2TIMGroupOnlineMemberCountSucc) (NSInteger count))
protected

获取群在线人数成功回调

◆ V2TIMGroupCounterResultSucc

- (typedef void(^ V2TIMGroupCounterResultSucc) (NSDictionary< NSString *, NSNumber * > *groupCounters))
protected

群计数器操作成功的回调

成员枚举类型说明

◆ V2TIMGroupAddOpt

- (enum V2TIMGroupAddOpt) :
protected

加群选项

枚举值
V2TIM_GROUP_ADD_FORBID 

禁止加群

V2TIM_GROUP_ADD_AUTH 

需要管理员审批

V2TIM_GROUP_ADD_ANY 

任何人可以加入

◆ V2TIMGroupMemberResult

- (enum V2TIMGroupMemberResult) :
protected

群组操作结果

枚举值
V2TIM_GROUP_MEMBER_RESULT_FAIL 

操作失败

V2TIM_GROUP_MEMBER_RESULT_SUCC 

操作成功

V2TIM_GROUP_MEMBER_RESULT_INVALID 

无效操作,加群时已经是群成员,移除群组时不在群内

V2TIM_GROUP_MEMBER_RESULT_PENDING 

等待处理,邀请入群时等待审批

V2TIM_GROUP_MEMBER_RESULT_OVERLIMIT 

操作失败,创建群指定初始群成员列表或邀请入群时,被邀请者加入的群总数超限

◆ V2TIMGroupMemberFilter

- (enum V2TIMGroupMemberFilter) :
protected

群成员角色过滤方式

枚举值
V2TIM_GROUP_MEMBER_FILTER_ALL 

全部成员

V2TIM_GROUP_MEMBER_FILTER_OWNER 

群主

V2TIM_GROUP_MEMBER_FILTER_ADMIN 

管理员

V2TIM_GROUP_MEMBER_FILTER_COMMON 

普通成员

◆ V2TIMGroupApplicationType

- (enum V2TIMGroupApplicationType) :
protected

群组未决请求类型

枚举值
V2TIM_GROUP_JOIN_APPLICATION_NEED_APPROVED_BY_ADMIN 

需要群主或管理员审批的申请加群请求

V2TIM_GROUP_INVITE_APPLICATION_NEED_APPROVED_BY_INVITEE 

需要被邀请者同意的邀请入群请求

V2TIM_GROUP_INVITE_APPLICATION_NEED_APPROVED_BY_ADMIN 

需要群主或管理员审批的邀请入群请求

◆ V2TIMGroupApplicationHandleStatus

- (enum V2TIMGroupApplicationHandleStatus) :
protected

群组已决标志

枚举值
V2TIM_GROUP_APPLICATION_HANDLE_STATUS_UNHANDLED 

未处理

V2TIM_GROUP_APPLICATION_HANDLE_STATUS_HANDLED_BY_OTHER 

被他人处理

V2TIM_GROUP_APPLICATION_HANDLE_STATUS_HANDLED_BY_SELF 

自己已处理

◆ V2TIMGroupApplicationHandleResult

- (enum V2TIMGroupApplicationHandleResult) :
protected

群组已决结果

枚举值
V2TIM_GROUP_APPLICATION_HANDLE_RESULT_REFUSE 

拒绝申请

V2TIM_GROUP_APPLICATION_HANDLE_RESULT_AGREE 

同意申请

函数文档

◆ createGroup:memberList:succ:fail:()

- (void) createGroup: (V2TIMGroupInfo *)  info
memberList: (NSArray< V2TIMCreateGroupMemberInfo * > *)  memberList
succ: (V2TIMCreateGroupSucc)  succ
fail: (V2TIMFail)  fail 

1.1 创建自定义群组(高级版本:可以指定初始的群成员)

参数
info自定义群组信息,可以设置 groupID | groupType | groupName | notification | introduction | faceURL 字段
memberList指定初始的群成员(直播群 AVChatRoom 不支持指定初始群成员,memberList 请传 nil)
注意
  • 后台限制邀请的群成员个数不能超过 20
  • 其他限制请参考 V2TIMManager.h -> createGroup 注释

◆ getJoinedGroupList:fail:()

- (void) getJoinedGroupList: (V2TIMGroupInfoListSucc succ
fail: (V2TIMFail)  fail 

1.2 获取当前用户已经加入的群列表

注意
  • 直播群(AVChatRoom)不支持该 API
  • 该接口有频限检测,SDK 限制调用频率为 1 秒 10 次,超过限制后会报 ERR_SDK_COMM_API_CALL_FREQUENCY_LIMIT (7008)错误

◆ getGroupsInfo:succ:fail:()

- (void) getGroupsInfo: (NSArray< NSString * > *)  groupIDList
succ: (V2TIMGroupInfoResultListSucc succ
fail: (V2TIMFail)  fail 

2.1 拉取群资料

参数
groupIDList群组 ID 列表

◆ searchGroups:succ:fail:()

- (void) searchGroups: (V2TIMGroupSearchParam *)  searchParam
succ: (V2TIMGroupInfoListSucc succ
fail: (V2TIMFail)  fail 

2.2 搜索群列表(5.4.666 及以上版本支持)

注意
该功能为 IM 旗舰版功能,购买旗舰版套餐包后可使用,详见价格说明

◆ setGroupInfo:succ:fail:()

- (void) setGroupInfo: (V2TIMGroupInfo *)  info
succ: (V2TIMSucc)  succ
fail: (V2TIMFail)  fail 

2.3 修改群资料

◆ initGroupAttributes:attributes:succ:fail:()

- (void) initGroupAttributes: (NSString *)  groupID
attributes: (NSDictionary< NSString *, NSString * > *)  attributes
succ: (V2TIMSucc)  succ
fail: (V2TIMFail)  fail 

2.4 初始化群属性,会清空原有的群属性列表

注意
attributes 的使用限制如下:
  • 6.7 及其以前版本,只支持 AVChatRoom 直播群;
  • 从 6.8 版本开始,同时支持 AVChatRoom、Public、Meeting、Work 四种群类型;
  • 从 7.0 版本开始,除了话题外,群属性支持所有的群类型;
  • key 最多支持 16 个,长度限制为 32 字节;
  • value 长度限制为 4k;
  • 总的 attributes(包括 key 和 value)限制为 16k;
  • initGroupAttributes、setGroupAttributes、deleteGroupAttributes 接口合并计算, SDK 限制为 5 秒 10 次,超过后回调 8511 错误码;后台限制 1 秒 5 次,超过后返回 10049 错误码;
  • getGroupAttributes 接口 SDK 限制 5 秒 20 次;
  • 从 5.6 版本开始,当每次APP启动后初次修改群属性时,请您先调用 getGroupAttributes 拉取到最新的群属性之后,再发起修改操作;
  • 从 5.6 版本开始,当多个用户同时修改同一个群属性时,只有第一个用户可以执行成功,其它用户会收到 10056 错误码;收到这个错误码之后,请您调用 getGroupAttributes 把本地保存的群属性更新到最新之后,再发起修改操作。

◆ setGroupAttributes:attributes:succ:fail:()

- (void) setGroupAttributes: (NSString *)  groupID
attributes: (NSDictionary< NSString *, NSString * > *)  attributes
succ: (V2TIMSucc)  succ
fail: (V2TIMFail)  fail 

2.5 设置群属性,已有该群属性则更新其 value 值,没有该群属性则添加该群属性。

注意
  • 6.7 及其以前版本,只支持 AVChatRoom 直播群;
  • 从 6.8 版本开始,同时支持 AVChatRoom、Public、Meeting、Work 四种群类型;
  • 从 7.0 版本开始,除了话题外,群属性支持所有的群类型。

◆ deleteGroupAttributes:keys:succ:fail:()

- (void) deleteGroupAttributes: (NSString *)  groupID
keys: (NSArray< NSString * > *)  keys
succ: (V2TIMSucc)  succ
fail: (V2TIMFail)  fail 

2.6 删除群指定属性,keys 传 nil 则清空所有群属性。

注意
  • 6.7 及其以前版本,只支持 AVChatRoom 直播群;
  • 从 6.8 版本开始,同时支持 AVChatRoom、Public、Meeting、Work 四种群类型;
  • 从 7.0 版本开始,除了话题外,群属性支持所有的群类型。

◆ getGroupAttributes:keys:succ:fail:()

- (void) getGroupAttributes: (NSString *)  groupID
keys: (NSArray< NSString * > *)  keys
succ: (V2TIMGroupAttributeListSucc succ
fail: (V2TIMFail)  fail 

2.7 获取群指定属性,keys 传 nil 则获取所有群属性。

注意
  • 6.7 及其以前版本,只支持 AVChatRoom 直播群;
  • 从 6.8 版本开始,同时支持 AVChatRoom、Public、Meeting、Work 四种群类型;
  • 从 7.0 版本开始,除了话题外,群属性支持所有的群类型。

◆ getGroupOnlineMemberCount:succ:fail:()

- (void) getGroupOnlineMemberCount: (NSString *)  groupID
succ: (V2TIMGroupOnlineMemberCountSucc succ
fail: (V2TIMFail)  fail 

2.8 获取指定群在线人数

参数
groupID群id
succ成功回调
fail失败回调
注意
请注意
  • IMSDK 7.3 以前的版本仅支持直播群( AVChatRoom);
  • IMSDK 7.3 及其以后的版本支持所有群类型。

◆ setGroupCounters:counters:succ:fail:()

- (void) setGroupCounters: (NSString *)  groupID
counters: (NSDictionary< NSString *, NSNumber * > *)  counters
succ: (V2TIMGroupCounterResultSucc succ
fail: (V2TIMFail)  fail 

2.9 设置群计数器(7.0 及其以上版本支持)

注意
  • 该计数器的 key 如果存在,则直接更新计数器的 value 值;如果不存在,则添加该计数器的 key-value;
  • 当群计数器设置成功后,在 succ 回调中会返回最终成功设置的群计数器信息;
  • 除了社群和话题,群计数器支持所有的群组类型。

◆ getGroupCounters:keys:succ:fail:()

- (void) getGroupCounters: (NSString *)  groupID
keys: (NSArray< NSString * > *)  keys
succ: (V2TIMGroupCounterResultSucc succ
fail: (V2TIMFail)  fail 

2.10 获取群计数器(7.0 及其以上版本支持)

注意
  • 如果 keys 为空,则表示获取群内的所有计数器;
  • 除了社群和话题,群计数器支持所有的群组类型。

◆ increaseGroupCounter:key:value:succ:fail:()

- (void) increaseGroupCounter: (NSString *)  groupID
key: (NSString *)  key
value: (NSInteger)  value
succ: (V2TIMGroupCounterResultSucc succ
fail: (V2TIMFail)  fail 

2.11 递增群计数器(7.0 及其以上版本支持)

参数
groupID群 ID
key群计数器的 key
value群计数器的递增的变化量,计数器 key 对应的 value 变更方式为: new_value = old_value + value
succ成功后的回调,会返回当前计数器做完递增操作后的 value
fail失败的回调
注意
  • 该计数器的 key 如果存在,则直接在当前值的基础上根据传入的 value 作递增操作;反之,添加 key,并在默认值为 0 的基础上根据传入的 value 作递增操作;
  • 除了社群和话题,群计数器支持所有的群组类型。

◆ decreaseGroupCounter:key:value:succ:fail:()

- (void) decreaseGroupCounter: (NSString *)  groupID
key: (NSString *)  key
value: (NSInteger)  value
succ: (V2TIMGroupCounterResultSucc succ
fail: (V2TIMFail)  fail 

2.12 递减群计数器(7.0 及其以上版本支持)

参数
groupID群 ID
key群计数器的 key
value群计数器的递减的变化量,计数器 key 对应的 value 变更方式为: new_value = old_value - value
succ成功后的回调,会返回当前计数器做完递减操作后的 value
fail失败的回调
注意
  • 该计数器的 key 如果存在,则直接在当前值的基础上根据传入的 value 作递减操作;反之,添加 key,并在默认值为 0 的基础上根据传入的 value 作递减操作
  • 除了社群和话题,群计数器支持所有的群组类型。

◆ getGroupMemberList:filter:nextSeq:succ:fail:()

- (void) getGroupMemberList: (NSString *)  groupID
filter: (uint32_t)  filter
nextSeq: (uint64_t)  nextSeq
succ: (V2TIMGroupMemberInfoResultSucc succ
fail: (V2TIMFail)  fail 

3.1 获取群成员列表

参数
filter指定群成员类型。
nextSeq分页拉取标志,第一次拉取填 0,回调成功如果 nextSeq 不为零,需要分页,传入再次拉取,直至为 0。
注意
  • 普通群(工作群、会议群、公开群)的限制:
  1. filter 只能设置为 V2TIMGroupMemberFilter 定义的数值,SDK 会返回指定角色的成员。
  • 直播群(AVChatRoom)的限制:
  1. 如果设置 filter 为 V2TIMGroupMemberFilter 定义的数值,SDK 返回全部成员。返回的人数规则为:拉取最近入群群成员最多 1000 人,新进来的成员排在前面,需要升级旗舰版,并且在 控制台 开启“直播群在线成员列表”开关(6.3 及以上版本支持)。
  2. 如果设置 filter 为群成员自定义标记,旗舰版支持拉取指定标记的成员列表。标记群成员的设置请参考 markGroupMemberList:memberList:markType:enableMark:succ:fail: API。
  3. 程序重启后,请重新加入群组,否则拉取群成员会报 10007 错误码。
  4. 群成员资料信息仅支持 userID | nickName | faceURL | role 字段。
  • 社群(Community)的限制:
  1. 如果设置 filter 为 V2TIMGroupMemberFilter 定义的数值,SDK 返回指定角色的成员。
  2. 如果设置 filter 为群成员自定义标记,旗舰版支持拉取指定标记的成员列表(7.5 及以上版本支持)。标记群成员的设置请参考 markGroupMemberList:memberList:markType:enableMark:succ:fail: API。

◆ getGroupMembersInfo:memberList:succ:fail:()

- (void) getGroupMembersInfo: (NSString *)  groupID
memberList: (NSArray< NSString * > *)  memberList
succ: (V2TIMGroupMemberInfoListSucc succ
fail: (V2TIMFail)  fail 

3.2 指定的群成员资料

◆ searchGroupMembers:succ:fail:()

- (void) searchGroupMembers: (V2TIMGroupMemberSearchParam *)  searchParam
succ: (V2TIMGroupMemberInfoListSearchSucc succ
fail: (V2TIMFail)  fail 

3.3 搜索指定的群成员资料(5.4.666 及以上版本支持)

参数
searchParam搜索参数
注意
该功能为 IM 旗舰版功能,购买旗舰版套餐包后可使用,详见价格说明

◆ setGroupMemberInfo:info:succ:fail:()

- (void) setGroupMemberInfo: (NSString *)  groupID
info: (V2TIMGroupMemberFullInfo *)  info
succ: (V2TIMSucc)  succ
fail: (V2TIMFail)  fail 

3.4 修改指定的群成员资料

◆ muteGroupMember:member:muteTime:succ:fail:()

- (void) muteGroupMember: (NSString *)  groupID
member: (NSString *)  userID
muteTime: (uint32_t)  seconds
succ: (V2TIMSucc)  succ
fail: (V2TIMFail)  fail 

3.5 禁言群成员(只有管理员或群主能够调用)

参数
seconds禁言时间长度,单位秒,表示调用该接口成功后多少秒内不允许被禁言用户再发言。

◆ muteAllGroupMembers:isMute:succ:fail:()

- (void) muteAllGroupMembers: (NSString *)  groupID
isMute: (BOOL)  isMute
succ: (V2TIMSucc)  succ
fail: (V2TIMFail)  fail 

3.6 禁言全体群成员,只有管理员或群主能够调用(7.5 及以上版本支持)

参数
groupID群组 ID
isMuteYES 表示禁言,NO 表示解除禁言
注意
  • 禁言全体群成员没有时间限制,设置 isMute 为 NO 则解除禁言。
  • 禁言或解除禁言后,会触发 V2TIMGroupListener 中的 onAllGroupMembersMuted:isMute: 回调。
  • 群主和管理员可以禁言普通成员。普通成员不能操作禁言/解除禁言。

◆ inviteUserToGroup:userList:succ:fail:()

- (void) inviteUserToGroup: (NSString *)  groupID
userList: (NSArray< NSString * > *)  userList
succ: (V2TIMGroupMemberOperationResultListSucc succ
fail: (V2TIMFail)  fail 

3.7 邀请他人入群

注意
请注意不同类型的群有如下限制:
  • 工作群(Work):群里的任何人都可以邀请其他人进群。
  • 会议群(Meeting)和公开群(Public):默认不允许邀请加入群,您可以修改群资料 V2TIMGroupInfo 的 groupApproveOpt 字段打开邀请入群方式。打开该选项之后,群里的任何人都可以邀请其他人进群。
  • 直播群(AVChatRoom):不支持此功能。
  • 后台限制单次邀请的群成员个数不能超过 20。

◆ kickGroupMember:memberList:reason:duration:succ:fail:()

- (void) kickGroupMember: (NSString *)  groupID
memberList: (NSArray< NSString * > *)  memberList
reason: (NSString *)  reason
duration: (uint32_t)  duration
succ: (V2TIMGroupMemberOperationResultListSucc succ
fail: (V2TIMFail)  fail 

3.8 踢人

参数
groupID群 id
memberList被踢用户的 userID 列表
reason被踢的原因
duration指定自被踢出群组开始算起,禁止被踢用户重新申请加群的时长,单位:秒
succ成功后的回调
fail失败后的回调
注意
  • 从 7.2 版本开始,支持设置一个时长参数,用于指定用户从被踢出群组开始算起,禁止重新申请加群的时长;
  • 工作群(Work):只有群主或 APP 管理员可以踢人;
  • 公开群(Public)、会议群(Meeting):群主、管理员和 APP 管理员可以踢人;
  • 直播群(AVChatRoom):6.6 之前版本只支持禁言(muteGroupMember),不支持踢人。6.6 及以上版本支持禁言和踢人。需要您购买旗舰版套餐;
  • 该接口其他使用限制请查阅:https://cloud.tencent.com/document/product/269/75400#.E8.B8.A2.E4.BA.BA。

◆ setGroupMemberRole:member:newRole:succ:fail:()

- (void) setGroupMemberRole: (NSString *)  groupID
member: (NSString *)  userID
newRole: (uint32_t)  role
succ: (V2TIMSucc)  succ
fail: (V2TIMFail)  fail 

3.9 切换群成员的角色

注意
请注意不同类型的群有如下限制:
  • 公开群(Public)和会议群(Meeting):只有群主才能对群成员进行普通成员和管理员之间的角色切换。
  • 其他群不支持设置群成员角色。
  • 转让群组请调用 transferGroupOwner 接口。
  • 会议群(Meeting)切换群成员角色之后,不会有 onGrantAdministrator 和 onRevokeAdministrator 通知回调
  • 切换的角色支持普通群成员( V2TIM_GROUP_MEMBER_ROLE_MEMBER) 和管理员(V2TIM_GROUP_MEMBER_ROLE_ADMIN

◆ markGroupMemberList:memberList:markType:enableMark:succ:fail:()

- (void) markGroupMemberList: (NSString *)  groupID
memberList: (NSArray< NSString * > *)  memberList
markType: (uint32_t)  markType
enableMark: (BOOL)  enableMark
succ: (V2TIMSucc)  succ
fail: (V2TIMFail)  fail 

3.10 标记群成员(需要您购买旗舰版套餐)

参数
groupID群 ID。
memberList群成员 ID 列表。
markType标记类型。数字类型,大于等于 1000,您可以自定义,一个群组里最多允许定义 10 个标记。
enableMarkYES 表示添加标记,NO 表示移除标记。
注意
请注意
  • 直播群从 6.6 版本开始支持。
  • 社群从 7.5 版本开始支持。
  • 只有群主才有权限标记群组中其他人。

◆ transferGroupOwner:member:succ:fail:()

- (void) transferGroupOwner: (NSString *)  groupID
member: (NSString *)  userID
succ: (V2TIMSucc)  succ
fail: (V2TIMFail)  fail 

3.11 转让群主

注意
请注意不同类型的群有如下限制:
  • 普通类型的群(Work、Public、Meeting):只有群主才有权限进行群转让操作。
  • 直播群(AVChatRoom):不支持转让群主。

◆ kickGroupMember:memberList:reason:succ:fail:()

- (void) kickGroupMember: (NSString *)  groupID
memberList: (NSArray< NSString * > *)  memberList
reason: (NSString *)  reason
succ: (V2TIMGroupMemberOperationResultListSucc succ
fail: (V2TIMFail)  fail 

3.12 踢人(直播群踢人从 6.6 版本开始支持,需要您购买旗舰版套餐)

注意
使用限制如下:
  • 待废弃接口,请使用 kickGroupMember:memberList:reason:duration:succ:fail: 接口;
  • 工作群(Work):只有群主或 APP 管理员可以踢人;
  • 公开群(Public)、会议群(Meeting):群主、管理员和 APP 管理员可以踢人;
  • 直播群(AVChatRoom):6.6 之前版本只支持禁言(muteGroupMember),不支持踢人。6.6 及以上版本支持禁言和踢人;
  • 该接口其他使用限制请查阅:https://cloud.tencent.com/document/product/269/75400#.E8.B8.A2.E4.BA.BA。

◆ getGroupApplicationList:fail:()

- (void) getGroupApplicationList: (V2TIMGroupApplicationResultSucc succ
fail: (V2TIMFail)  fail 

4.1 获取加群申请列表

注意
最多支持50个

◆ acceptGroupApplication:reason:succ:fail:()

- (void) acceptGroupApplication: (V2TIMGroupApplication *)  application
reason: (NSString *)  reason
succ: (V2TIMSucc)  succ
fail: (V2TIMFail)  fail 

4.2 同意某一条加群申请

◆ refuseGroupApplication:reason:succ:fail:()

- (void) refuseGroupApplication: (V2TIMGroupApplication *)  application
reason: (NSString *)  reason
succ: (V2TIMSucc)  succ
fail: (V2TIMFail)  fail 

4.3 拒绝某一条加群申请

◆ setGroupApplicationRead:fail:()

- (void) setGroupApplicationRead: (V2TIMSucc)  succ
fail: (V2TIMFail)  fail 

4.4 标记申请列表为已读