tencent cloud

文档反馈

Android&iOS&Mac

最后更新时间:2022-11-28 16:40:30

    功能描述

    群成员资料类为 V2TIMGroupMemberFullInfo,内含群成员 userID、自定义信息、角色、禁言等信息。
    相关方法在核心类 V2TIMGroupManager(Android) / V2TIMManager(Group)(iOS & Mac) 中。

    获取群成员资料

    您可以调用 getGroupMembersInfo (Android / iOS & Mac / Windows) 获取群成员资料。该接口支持批量获取,您可以一次传入多个 userID 获取多个群成员的资料,从而提升网络传输效率。

    示例代码如下:

    List<String> userIDList = new ArrayList<>();
    userIDList.add("userA");
    userIDList.add("userB");
    V2TIMManager.getGroupManager().getGroupMembersInfo("groupA", userIDList, new V2TIMValueCallback<List<V2TIMGroupMemberFullInfo>>() {
     @Override
     public void onSuccess(List<V2TIMGroupMemberFullInfo> v2TIMGroupMemberFullInfos) {
        // 获取成功
     }
      @Override
     public void onError(int code, String desc) {
        // 获取失败
     }
    });
    

    修改群成员资料

    群主或管理员可以调用 setGroupMemberInfo (Android / iOS & Mac / Windows) 接口修改群成员的群名片(nameCard)、自定义字段(customInfo)等与群成员相关的资料。

    普通群成员可以调用 setGroupMemberInfo 设置自己的群名片(nameCard)、自定义字段(customInfo)等信息。

    说明:

    直播群(AVChatRoom)不存储群成员信息,设置直播群成员名片不适用于直播群。

    如果要修改群成员自定义字段,您必须提前在 即时通信 IM 控制台 配置好该字段,配置页面如下图所示:

    注意:

    群成员自定义字段最多可设置 5 个。字段创建后,该字段将不可删除,也无法修改字段名与字段类型。

    示例代码如下:

    V2TIMGroupMemberFullInfo memberFullInfo = new V2TIMGroupMemberFullInfo();
    // 指定修改的群成员
    memberFullInfo.setUserID("userA");
    // 设置修改的 nameCard 值
    memberFullInfo.setNameCard("userA_namecard");
    // 设置群成员自定义字段
    Map<String, byte[]> customMap = new HashMap<>();
    customMap.put("member_key1", "value1".getBytes());
    memberFullInfo.setCustomInfo(customMap);
    V2TIMManager.getGroupManager().setGroupMemberInfo("groupA", memberFullInfo, new V2TIMCallback() {
    @Override
    public void onSuccess() {
    // 修改成功
    }
     @Override
    public void onError(int code, String desc) {
    // 修改失败
    }
    });
    

    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持