用户信息托管
本文档旨在指导开发者如何在融云即时通讯 Android 客户端 SDK 中实现用户信息订阅、查询和监听,同时支持用户信息与权限的修改、查询。 通过本文档, Android 开发者将了解如何获取和跟踪用户信息,以及如何在用户信息变更、订阅状态变更时接收通知。
注意 此功能在 5.10.0 版本开始支持。
开通服务
使用此功能前,您须在控制台开通信息托管服务。
用户信息管理
可以修改或查询自已的用户信息,批量查询指定多个用户的用户信息。
用户信息设置
用户在应用中使用 updateMyUserProfile
可以修改自已的用户信息。
下表描述 UserProfile 类的属性,也可参考 API 文档。
属性名 | 类型 | 描述 |
---|---|---|
name | String | 昵称,长度不超过 32 个字符。 |
portraitUri | String | 头像地址,长度不超过 128 个字符。 |
uniqueId | String | 用户应用号,支持大小写字母、数字,长度不超过 32 个字符。请注意 SDK不支持设置此字段。 |
String | Email,长度不超过 128 个字符。 | |
birthday | String | 生日,长度不超过 32 个字符 |
gender | int | 性别,未知 0 、男 1、女 2。 |
location | String | 所在地,长度不超过 32 个字符。 |
role | int | 角色,支持 0~100 以内数字。 |
level | int | 级别,支持 0~100 以内数字。 |
userExtProfile | long | 自定义扩展信息,默认最多可以设置 20 个用户信息(以 Key、Value 方式设置, 扩展用户信息通过开发者后台进行设置)
|
// 更新自己的用户信息
UserProfile userProfile = new UserProfile();
RongCoreClient.getInstance().updateMyUserProfile(userProfile, new IRongCoreCallback.UpdateUserProfileCallback() {
@Override
public void onSuccess() {
// 更新成功
}
@Override
public void onError(int errorCode, String errorKey) {
// 更新失败
}
});
批量获取用户信息
您可以使用 getUserProfiles
方法查询指定用户的用户信息。一次最多查询20个用户的用户信息。
// 设置查询用户ID列表
List<String> userIdList = new ArrayList<>();
userIdList.add("user1");
userIdList.add("user2");
userIdList.add("user3");
RongCoreClient.getInstance().getUserProfiles(userIdList, new IRongCoreCallback.ResultCallback<List<UserProfile>>() {
@Override
public void onSuccess(List<UserProfile> userProfiles) {
// 查询成功,返回查询用户信息。
}
@Override
public void onError(IRongCoreEnum.CoreErrorCode e) {
// 查询失败
}
});
获取当前用户信息
您可以使用 getMyUserProfile
方法获取当前用户信息。
RongCoreClient.getInstance().getMyUserProfile(new IRongCoreCallback.ResultCallback<UserProfile>() {
@Override
public void onSuccess(UserProfile userProfile) {
// 查询成功,返回自己的用户信息。
}
@Override
public void onError(IRongCoreEnum.CoreErrorCode e) {
// 查询失败
}
});
用户权限
客户端 SDK 提供了用户权限的设置和获取接口,通过 UserProfileVisibility
枚举来表示用户权限,各枚举值代表的含义参考下表:
枚举值 | 用户权限 |
---|---|
UserProfileVisibility.NotSet | 未设置:以 AppKey 权限设置为准,默认是此状态。 |
UserProfileVisibility.Invisible | 都不可见:任何人都不能搜索到我的用户信息,名称、头像除外。 |
UserProfileVisibility.Everyone | 所有人:应用中任何用户都可以查看到我的用户信息。 |