合集
腾讯云IM接入案列(一)
腾讯云IM接入案列(二)
腾讯云IM接入案列(三)
腾讯云IM接入案列(四)
前言
前端时间因为找实习和实习的问题,已经有好一段时间没有在简书上面写文章了,现在辞职了回来简书把工作上学习到的和遇到的问题都总结下来。
腾讯云IM接入我打算写个详细点的案列,毕竟他的使用不像环信有集成的easeUI那么方便,文档上面也没有细说一些实现方式,全靠脑补,而且当初在网上也找不到比较好的教程。
我打算分个章节来写,导入,demo展示,自定义消息,会话列表和聊天界面的头像展示,demo逻辑分析等。
噢,差点忘了说使用的是最新的3.X版本。
最终效果展示
效果展示 | 效果展示 | 效果展示 |
---|---|---|
(ps:不会把图片并排,只能用表格了...尴尬脸)
实战开始
-
SDK的下载
官方文档传送门
(账号的集成方式也请参考官方文档)
下载解压之后是这样的
大家可以先运行samples看看别人的项目,我主要是在这个基础上做修改,他的代码分析会在后续篇章讲解。
-
项目基础搭建
导入samples里面封装好的module,只要导入其中的ui库就行,因为其他的是相互依赖会一同导入
导入之后可能会出现build tools version的错误提示,这里大家自行修改下版本号就行,还有记得在dependencies中添加对ui,presentation的依赖,不然会找不到相应的类
不懂的话百度一下应该能找到结果
接着我们把demo里面一些会用到的类复制到自己的项目中,大致项目结构如下
(因为我主要用到单人聊天功能,其他就没有复制过来了,不过应该也是差不多的,复制的过程可能会出现爆红,慢慢处理就好,还要记得复制资源文件)
打开sdk依赖项目中的Constant类,修改为自己项目对应的id和账号类型
接着是一些比较重要的步骤
//初始化IMSDK
InitBusiness.start(getApplicationContext(), TIMLogLevel.DEBUG.ordinal());
//初始化TLS
TlsBusiness.init(getApplicationContext());
Log.d("tencentim","初始化腾讯云Im");
//用户登录,可以查看官网文档
LoginBusiness.loginIm(account, userSig, new TIMCallBack() {
@Override
public void onError(int i, String s) {
Toast.makeText(LoginActivity.this, s, Toast.LENGTH_SHORT).show();
}
@Override
public void onSuccess() {
startActivity(new Intent(LoginActivity.this, MainActivity.class));
}
});
//会话列表
private void setConversationFragment() {
conversationFragment=new ConversationFragment();
getSupportFragmentManager().beginTransaction().replace(R.id.fragmelayout,conversationFragment,conversationFragment.getTag()).commit();
}
实现之后,就可以进行登录和聊天了,至于如何进行和别人聊天,我demo里是在代码里直接发送一条普通消息到另一个测试账号上,这样列表中就会显示该会话了,点进去就是聊天界面了,真实案例的话肯定要有一个直接进入聊天界面的入口。
//发送消息
private void sendNormalMessage() {
//获取单聊会话
String peer = "admin2"; //获取与用户 "sample_user_1" 的会话
timConversation = TIMManager.getInstance().getConversation(
TIMConversationType.C2C, //会话类型:单聊
peer); //会话对方用户帐号//对方id
//构造一条消息
TIMMessage msg = new TIMMessage();
//添加文本内容
TIMTextElem elem = new TIMTextElem();
elem.setText("a new msg");
//将elem添加到消息
if(msg.addElement(elem) != 0) {
Log.d("tencentim", "addElement failed");
return;
}
//发送消息
timConversation.sendMessage(msg, new TIMValueCallBack<TIMMessage>() {//发送消息回调
@Override
public void onError(int code, String desc) {//发送消息失败
//错误码code和错误描述desc,可用于定位请求失败原因
//错误码code含义请参见错误码表
Log.d("tencentim", "send message failed. code: " + code + " errmsg: " + desc);
}
@Override
public void onSuccess(TIMMessage msg) {//发送消息成功
Log.e("tencentim", "SendMsg ok");
}
});
}
总结
本文主要讲解了如何导入腾讯云Im,和抽取所需要的东西,没有过多的内容,下篇会对腾讯云demo里面的代码做一点分析,然后实现自定义消息和显示头像等.
项目地址
你们最关注的来了
https://github.com/DongDian455/TIMDemo
下篇
腾讯云IM接入案列(二)
(ps:若有不理解或者有错误的地方欢迎留言评论)