文档中心

用户属性指实时消息互动用户的信息，如用户昵称、头像、邮箱、电话、性别、签名、生日等。

例如，在招聘场景下，利用用户属性功能可以存储性别、邮箱、用户类型（面试者）、职位类型（web 研发）等。查看用户信息时，可以直接查询服务器存储的用户属性信息。

本文介绍如何通过管理用户属性设置、更新、存储并获取实时消息用户的相关信息。

技术原理

环信即时通讯 IM Android SDK 提供一个 EMUserInfoManager 类，支持获取、设置及修改用户属性信息，其中包含如下方法：

• updateOwnInfo 设置和修改当前用户自己的属性信息；
• updateOwnInfoByAttribute 设置和修改用户信息中的某个属性；
• fetchUserInfoByUserId 获取指定用户的所有用户属性信息；
• fetchUserInfoByAttribute 获取指定环信用户 ID 和指定用户的用户属性。

前提条件

设置用户属性前，请确保满足以下条件：

• 完成 SDK 初始化，详见 快速开始。
• 了解环信即时通讯 IM 的使用限制，详见 使用限制。

实现方法

本节介绍如何在项目中设置及获取用户属性。

实现过程中注意单个用户的所有属性最大不超过 2 KB，单个 app 所有用户属性数据最大不超过 10 GB。

设置当前用户的属性

参考如下示例代码，在你的项目中当前用户设置自己的所有属性或者仅设置某一项属性。

// 设置所有用户属性。 EMUserInfo userInfo = new EMUserInfo(); userInfo.setUserId(EMClient.getInstance().getCurrentUser());

 userInfo.setNickname("easemob"); userInfo.setAvatarUrl("http://www.easemob.com"); userInfo.setBirth("2000.10.10"); 

userInfo.setSignature("hello world"); userInfo.setPhoneNumber("13333333333"); userInfo.setEmail("123456@qq.com"); 

userInfo.setGender(1); EMClient.getInstance().userInfoManager().updateOwnInfo(userInfo, new EMValueCallBack<String>()

 { @Override public void onSuccess(String value) { } @Override public void onError(int error, String errorMsg) 

{ } }); // 以修改用户头像为例，演示如何修改指定用户属性。 String url = "https://download-sdk.oss-cn-beijing.a

liyuncs.com/downloads/IMDemo/avatar/Image1.png"; EMClient.getInstance().userInfoManager().updateOwnInfoByAtt

ribute(EMUserInfoType.AVATAR_URL, url, new EMValueCallBack<String>() { @Override public void onSuccess(String 

value) { } @Override public void onError(int error, String errorMsg) { } }); 

若调用 RESTful 的接口设置或删除用户属性，请求中必须传以下字段各客户端才能获取到。

获取用户属性

用户可以获取指定一个或多个用户的全部用户属性。

示例代码如下：

// 获取一个或多个用户的所有属性，一次调用用户 ID 数量不超过 100。 String[] userId = new String[1]; //username 指用户 ID。

 userId[0] = username; EMClient.getInstance().userInfoManager().fetchUserInfoByUserId(userId, new EMValueCallBack<Map<String,

 EMUserInfo>>() {}); 

获取指定用户的指定用户属性

用户可以获取指定用户的指定用户属性信息。

String[] userId = new String[1]; userId[0] = EMClient.getInstance().getCurrentUser(); EMUserInfo.EMUserInfoType[]

 userInfoTypes = new EMUserInfo.EMUserInfoType[2]; userInfoTypes[0] = EMUserInfo.EMUserInfoType.NICKNAME;

 userInfoTypes[1] = EMUserInfo.EMUserInfoType.AVATAR_URL; EMClient.getInstance().userInfoManager().

fetchUserInfoByAttribute(userId, userInfoTypes, new EMValueCallBack<Map<String, EMUserInfo>>() {}); 

更多功能

用户头像管理

如果你的应用场景中涉及用户头像管理，还可以参考如下步骤进行操作：

1. 开通第三方文件存储服务。详情可以参考文件储存服务商的文档。
2. 将头像文件上传至上述第三方文件存储，并获取存储 URL 地址。
3. 将该 URL 地址传入用户属性的头像字段（avatarUrl）。
4. 调用 fetchUserInfoByUserId 或 fetchUserInfoByAttribute 获取头像 URL，并在本地 UI 中渲染头像。

名片消息

如果使用场景中涉及名片消息，你也可以使用自定义属性功能，并参考如下示例代码实现：

//设置自定义消息的 `event` 为 `"userCard"`，并在 `ext` 中添加展示名片所需要的用户 ID 、昵称和头像等字段。

 EMMessage message = EMMessage.createSendMessage(EMMessage.Type.CUSTOM); EMCustomMessageBody body = new 

EMCustomMessageBody(DemoConstant.USER_CARD_EVENT); Map<String,String> params = new HashMap<>(); params.

put(DemoConstant.USER_CARD_ID,userId); params.put(DemoConstant.USER_CARD_NICK,user.getNickname());

 params.put(DemoConstant.USER_CARD_AVATAR,user.getAvatarUrl()); body.setParams(params); message.setBody(body);

 message.setTo(toUser); EMClient.getInstance().chatManager().sendMessage(message); 

如果需要在名片中展示更丰富的信息，可以在 ext 中增加更多字段。

可参考 示例项目 (opens new window)中的以下类：

• ChatUserCardAdapterDelegate
• ChatUserCardAdapterDelegate
• ChatRowUserCard