老司机带你们5分钟实现昵称头像的显示,车要开了,话不多说,快快上车~
一、将简版demo里的cache包(5个java文件)复制到自己项目里。
下载环信android简版Demo:
环信简版DEMO
二、显示昵称头像有两种解决方案:
- 从APP服务器获取;
- 从消息扩展属性中获取。
接下来,我们就以官方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第824行增加代码
// 从本地缓存中获取用户昵称头像
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服务器获取的步骤:
1.配置后端云服务器;
注意:如果开发者有自己的服务器,可以省略这一步。但是必须直接实现调用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.+'
)
}
3.在DemoApplication.java第49行初始化后端云。注意:如果开发者有自己的服务器,可以省略这一步。
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());
}
});
}
82.登录(或注册)成功后,需要缓存当前用户的昵称头像。*
在登录(或注册)服务端回调(不是环信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页面发送消息测试是否设置成功:
duoroux.com/chat
测试账号:
1.环信ID:biaoge 密码:biaoge
2.环信ID:biaomei 密码:biaomei
两种方案的完整代码,大家可以下载环信android简版Demo:
Android简版DEMO
如有任何问题,请咨询**【环信IM互帮互助群】,群号:340452063 **