tencent cloud

文档反馈

Android & iOS & Mac

最后更新时间:2023-03-21 10:38:37

    功能描述

    用户可以查询自己、好友、非好友的信息;可以修改自己的昵称、头像、签名等信息;可以修改好友的备注、分组等信息。
    相关方法在核心类 V2TIMManagerV2TIMFriendshipManager(Android) / V2TIMManager(Friendship)(iOS & Mac) 中。

    关系链事件监听器

    您可以调用 addFriendListener (Android / iOS & Mac / Windows) 添加关系链事件监听器。

    当不想再接收关系链事件时,可调用 removeFriendListener (Android / iOS & Mac / Windows) 移除关系链事件监听器。

    注意:

    只有预先设置好关系链事件监听器,才能正常接收到下文中的各种事件通知。

    示例代码如下:

    // 添加关系链监听器
    V2TIMManager.getFriendshipManager().addFriendListener(listener);
    // 移除关系链监听器
    V2TIMManager.getFriendshipManager().removeFriendListener(listener);
    

    用户资料管理

    查询和修改自己的资料

    您可以调用 getUsersInfo (Android / iOS & Mac / Windows) 接口查询个人资料,其中参数 userIDList 需填入自己的 UserID。

    示例代码如下:

    // 获取个人资料
    String loginUser = V2TIMManager.getInstance().getLoginUser();
    List<String> userIDList = new ArrayList<>();
    userIDList.add(loginUser);
    V2TIMManager.getInstance().getUsersInfo(userIDList, new V2TIMValueCallback<List<V2TIMUserFullInfo>>() {
      @Override
      public void onSuccess(List<V2TIMUserFullInfo> profiles) {
          // 获取个人资料成功
      }
      @Override
      public void onError(int code, String desc) {
          // 获取个人资料失败
      }
    });
    

    您可以调用 setSelfInfo (Android / iOS & Mac / Windows) 接口修改个人资料。
    个人资料包括昵称、头像、签名、性别、出生日期、好友验证方式等,详情可参考 V2TIMUserFullInfo(Android / iOS & Mac / Windows) 类定义。
    资料修改成功后,您会收到 onSelfInfoUpdated (Android / iOS & Mac / Windows) 回调。

    示例代码如下:

    // 设置个人资料
    V2TIMUserFullInfo info = new V2TIMUserFullInfo();
    info.setNickname("nickName");
    info.setFaceUrl("faceUrl");
    V2TIMManager.getInstance().setSelfInfo(info, new V2TIMCallback() {
      @Override
      public void onSuccess() {
            // 设置个人资料成功
      }
    
    

    @Override
    public void onError(int code, String desc) {
    // 设置个人资料失败
    }
    });

    // 监听个人资料变更回调
    V2TIMManager.getInstance().addIMSDKListener(new V2TIMSDKListener() {
    @Override
    public void onSelfInfoUpdated(V2TIMUserFullInfo info) {
    // 收到个人资料变更回调
    }
    });

    查询和修改好友资料

    您可以调用 getFriendsInfo (Android / iOS & Mac / Windows) 接口查询指定的好友资料。详情请参考 好友管理

    查询非好友用户资料

    您可以调用 getUsersInfo (Android / iOS & Mac / Windows) 接口查询非好友资料,其中参数 userIDList 填入非好友的 UserID 即可。

    说明:

    1. 不能修改非好友的资料。
    2. 非好友资料更新时,由于没有好友关系,后台无法向 SDK 发送系统通知,因此无法实时更新。为了避免每次获取用户资料都向后台发起网络请求,节省网络资源,SDK 增加了缓存逻辑,对同一个用户主动向后台拉取资料的时间间隔为 10 分钟。

    示例代码如下:

    List<String> userIDList = new ArrayList<>();
    userIDList.add("userA");
    V2TIMManager.getInstance().getUsersInfo(userIDList, new V2TIMValueCallback<List<V2TIMUserFullInfo>>() {
      @Override
      public void onSuccess(List<V2TIMUserFullInfo> profiles) {
          // 获取非好友资料成功
      }
    
    

    @Override
    public void onError(int code, String desc) {
    // 获取非好友资料失败
    }
    });

    联系我们

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

    技术支持

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

    7x24 电话支持