【环信征文】在android中5分钟实现环信昵称头像的显示

老司机带你们5分钟实现昵称头像的显示,车要开了,话不多说,快快上车~


23.jpg



一、将简版demo里的cache包(5个java文件)复制到自己项目里。
下载环信android简版Demo:
环信Android简版DEMO

昵称头像用到的工具类、model都在这个cache包里。 

1.png


类介绍:

2.png



二、显示昵称头像有两种解决方案:
  1. 从APP服务器获取;
  2. 从消息扩展属性中获取。


接下来,我们就以官方demo为例,一步步教大家实现昵称头像的显示。
无论哪种方案,先要设置3步:
1.更改环信appkey;
在AndroidManifest.xml中更改appkey,改为【xmxx#xmxx】,如下所示。 
<!-- 设置环信应用的appkey -->
<meta-data
android:name="EASEMOB_APPKEY"
android:value=“xmxx#xmxx" />

2.增加第三方依赖库。根目录下的 build.gradle 下:
compile 'com.j256.ormlite:ormlite-android:5.0'
compile 'com.google.code.gson:gson:2.8.0'
ormlite:操作sqlite数据库
gson:json对象转换 

3.设置用户信息提供者:
在DemoHelper.java的getUserInfo函数里(第824行)增加如下代码: 


环信头像昵称显示使用的是提供者模式(EaseUserProfileProvider),只要设置了用户信息提供者(setUserProfileProvider),EaseUI界面里显示用户昵称和头像时,就会调用这个getUserInfo函数。


// 从本地缓存中获取用户昵称头像
EaseUser user = UserCacheManager.getEaseUser(username);

并且注释之前获取昵称头像的方法:
// EaseUser user = null;
// if(username.equals(EMClient.getInstance().getCurrentUser()))
// return getUserProfileManager().getCurrentUserInfo();
// user = getContactList().get(username);
// if(user == null && getRobotList() != null){
// user = getRobotList().get(username);
// }

然后,根据不同的方案,开发者可以选择不同步骤:

三、从开发者自己的APP服务器获取的步骤:
将UserCacheManager.java中第54行-62行代码,换成:通过okhttp(或者retrofit、volley)调用api接口,根据用户环信ID,从开发app服务器获取用户昵称头像。下面两张图是改之前和改之后的效果:
 
改之前(用第三方云存储):

1111.png



改之后(用开发者自己服务器):

2222.png


 

四、从第三方后端云存储获取的步骤:

1.配置后端云服务器;
(注意:用开发者APP服务器存储昵称头像可以忽略这一步):但是必须直接实现调用API从开发者服务器中获取昵称头像。
首先打开根目录下的 build.gradle 进行如下标准配置
buildscript {    
repositories {
jcenter() //这里是 LeanCloud 的包仓库
maven {
url "http://mvn.leancloud.cn/nexus/ ... ot%3B
}
}

dependencies {
classpath 'com.android.tools.build:gradle:1.0.0'
}
}

allprojects {
repositories {
jcenter() //这里是 LeanCloud 的包仓库
maven { url "http://mvn.leancloud.cn/nexus/ ... ot%3B }
}
}
继续在根目录下的build.gradle增加如下配置:
android {    
//为了解决部分第三方库重复打包了META-INF的问题
packagingOptions{
exclude 'META-INF/LICENSE.txt'
exclude 'META-INF/NOTICE.txt'
}
lintOptions {
abortOnError false
}
}
dependencies {
// LeanCloud 基础包
compile ('cn.leancloud.android:avoscloud-sdk:v3.+'
)
}
注意:以上代码,由于论坛里的编辑器会产生乱码,所以建议去【环信Android简版Demo】里复制。或者直接打开:
https://github.com/mengmakies/ChatDemo-UI3.00-Simple-Android/blob/master/examples/ChatDemoUI3.0/build.gradle​ 


 3.在DemoApplication.java第49行初始化后端云。(注意:用开发者APP服务器存储昵称头像可以忽略这一步)
UserWebManager.config(this,"VBYeQuiVPD9CWS2aINWrwBv0-gzGzoHsz","1LItewi0x6hlkgYHxi8DERNN");
 
4.在环信IM登录成功后,在后端云里新增用户。
参考LoginActivity.java第173行代码。(注意:用开发者APP服务器存储昵称头像可以忽略这一步) 
// 登录成功后,如果后端云没有缓存用户信息,则新增一个用户
UserWebManager.createUser(userId, nickName, avatarUrl);

如果需要看到完整的效果,可以用以下随机用户昵称头像的生成代码:
Random random=new Random();
String userId = EMClient.getInstance().getCurrentUser();// 用户环信ID
String nickName = String.format("小草%d",random.nextInt(10000));// 用户昵称
String avatarUrl = String.format("http://duoroux.com/chat/avatar/%d.jpg",random.nextInt(10));// 用户头像(绝对路

编译运行。这样就可以用方案一从APP服务端获取昵称头像了。

五、从消息扩展属性中获取昵称头像。
1.首先,要注释从APP服务器获取昵称头像的方法。
删除类文件:UserWebInfo.java和UserWebManager.java。
UserCacheManager.java中注释第57-68行,不从APP服务器中获取昵称头像: 
// 如果本地缓存不存在或者过期,则从存储服务器获取
if (notExistedOrExpired(userId)){
UserWebManager.getUserInfoAync(userId, new UserWebManager.UserCallback() {
@Override
public void onCompleted(UserWebInfo info) {
if(info == null) return;

// 缓存到本地
save(userId, info.getNickName(),info.getAvatarUrl());
}
});
}
2.登录(或注册)成功后,需要缓存当前用户的昵称头像。
在登录(或注册)服务端回调(不是环信IM登录回调)里,增加如下代码: 
// 登录成功,将用户的环信ID、昵称和头像缓存在本地
UserCacheManager.save(userId, nickName, avatarUrl);

如果需要看到完整的效果,可以用以下随机用户昵称头像的生成代码:
Random random=new Random();
String userId = EMClient.getInstance().getCurrentUser();// 用户环信ID
String nickName = String.format("小草%d",random.nextInt(10000));// 用户昵称
String avatarUrl = String.format("http://duoroux.com/chat/avatar/%d.jpg",random.nextInt(10));// 用户头像(绝对路径)
3.发送消息时携带昵称头像。
ChatFragment.java里的 onSetMessageAttributes函数。第231行增加代码:
// 设置消息的扩展属性,携带昵称头像
UserCacheManager.setMsgExt(message);

4.接收消息时携带昵称头像。
DemoHelper.java里的 onMessageReceived函数。第856行增加代码:
// 从消息的扩展属性里获取昵称头像
UserCacheManager.save(message.ext());


5.另外。音视频通话里,昵称头像也要进行处理。(不需要音视频通话功能的开发者可以省略后面所有步骤)
发送音视频通话请求时携带昵称头像。
CallActivity.java里第162行代码更改为: 
// 通过扩展属性将昵称头像传给对方
String ext = UserCacheManager.getMyInfoStr();
if (msg.what == MSG_CALL_MAKE_VIDEO) {
EMClient.getInstance().callManager().makeVideoCall(username,ext);
} else {
EMClient.getInstance().callManager().makeVoiceCall(username,ext);
}

6.接收音视频通话时保存昵称头像。
CallReceiver.java第33行增加代码: 
// 缓存用户昵称头像
String ext = EMClient.getInstance().callManager().getCurrentCallSession().getExt();
UserCacheManager.save(ext);

7.音频通话里显示昵称头像。
VoiceCallActivity.java第114行代码改为: 
// 显示昵称头像
UserCacheInfo user = UserCacheManager.get(username);
if (user != null){
nickTextView.setText(user.getNickName());
//Glide.with(VoiceCallActivity.this).load(user.getAvatarUrl()).placeholder(R.drawable.em_default_avatar).into(avatarImage);
}else {
nickTextView.setText(username);
}


8.视频通话里显示昵称头像。
VideoCallActivity.java第171行代码改为: 
// 显示昵称头像
UserCacheInfo user = UserCacheManager.get(username);
if (user != null){
nickTextView.setText(user.getNickName());
}else {
nickTextView.setText(username);
}

编译运行即可使用扩展消息的方式实现昵称头像显示了!
可以通过这个web页面发送消息测试是否设置成功:
http://duoroux.com/chat 

测试账号:
1.环信ID:biaoge  密码:biaoge
2.环信ID:biaomei  密码:biaomei

两种方案的完整代码,大家可以下载环信android简版Demo:
https://github.com/mengmakies/ChatDemo-UI3.00-Simple-Android 

IOS版简版demo下载地址:
https://github.com/mengmakies/ChatDemo-UI3.00-Simple 


如有任何问题,请咨询【环信IM互帮互助群】,群号:340452063 


注意事项


将此方案集成到自己项目时,要把SqliteHelper构造函数里的“DemoApplication.getInstance()”换成自己项目的应用程序类实例!




 

15 个评论

测试成功,感谢大神
没看懂、。。demohelper类里操作的是什么。。
看名字很容易猜出这个类的作用,这是环信官方提供的工程辅助类。建议你不必要深究里面的代码,等集成成功后再慢慢研究。
会话列表中头像和昵称怎么显示啊,需要考demo中的哪些类啊
请仔细看文章第一段:【昵称头像用到的工具类、model都在这个项目里。】
你这个Demo是不是只能显示当前的用户的头像呀
可以请教下你怎么实现的吗,我实在不会了
测试成功 大概就是存储下来调用 百度了很多方法 因为需求的不同导致试了很多方法都不行 感激
userWebInfo这个类一直报错
为什么我只能显示自己的头像,显示不了别人的头像
为什么按着这个方法通讯录列表无法按字母排序排序呢
请问楼主这个方法一定需要自己有服务器吗?有没有不需要服务器也能显示头像的方法
求教从服务器获取到头像昵称后怎么通知页面更新
我也是,你是怎么解决的?
测试成功,感谢大神~!

要回复文章请先登录注册