用户属性

更新时间：2022-09-07

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

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

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

注意为保证用户信息安全，SDK 仅支持用户设置或更新自己的用户属性。

技术原理

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

updateOwnUserInfo 设置和修改自己的属性信息；
fetchUserInfoById 获取指定用户的属性信息；
fetchOwnInfo 获取自己的属性信息。

前提条件

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

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

实现方法

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

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

设置当前用户的属性

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

try {
  await EMClient.getInstance.userInfoManager.updateUserInfo(
    nickname: "your nickname",
  );
} on EMError catch (e) {}

用户属性包括如下字段：

字段	类型	描述
`nickname`	String	用户昵称。长度在 64 字符内。
`avatarurl`	String	用户头像 URL 地址。长度在 256 字符内。
`phone`	String	用户联系方式。长度在 32 字符内。
`mail`	String	用户邮箱。长度在 64 字符内。
`gender`	Number	用户性别。 - `1`：男； - `2`：女； - （默认）`0`：未知； - 设置为其他值无效。
`sign`	String	用户签名。长度在 256 字符内。
`birth`	String	用户生日。长度在 64 字符内。
`userId`	String	用户 ID。
`ext`	String	扩展字段。

获取用户属性

你可以获取指定一个或多个用户的用户属性，一次调用用户 ID 数量不超过 100。

示例代码如下：

List<String> list = ["tom", "json"];
try {
  Map<String, EMUserInfo> userInfos =
      await EMClient.getInstance.userInfoManager.fetchUserInfoById(list);
} on EMError catch (e) {
}

获取当前用户的属性

try {
  EMUserInfo? userInfo =
      await EMClient.getInstance.userInfoManager.fetchOwnInfo();
} on EMError catch (e) {
}

目录