自己闲暇没事就想搞搞即使通讯,选了融云去集成一下,操作不是很难,一起来看一下。
首先了解一下融云的组成库都有那些:
1、IMKit 集成了会话界面,并且提供了丰富的自定义功能,我们推荐首次接触融云的客户直接使用 IMKit 来快速集成和开发。
2、IMLib 提供了基础的通信能力,较轻量,适用于对 UI 有较高订制需求的开发者,但您需要自己去实现大量的界面和功能。
3、CallKit 融云音视频通话的界面组件,包含了单人、多人音视频通话的界面的各种场景和功能。您可以通过集成该组件来实现丰富的音视频通话界面,并进行自己的 UI 定制开发。同时我们开源了 CallKit,您可以根据您的需要去使用。
4、CallLib 融云音视频通话核心能力组件。
5、LocationLib 位置相关库文件
6、PushLib 融云支持第三方推送(小米),您可以从这里下载对应的第三方推送 jar 包。
7、RedPacket 融云红包相关组件,通过集成该组件,即可快速实现红包功能。
自己测试demo只集成了IMLib 和IMKit 两个库,完成基本的单聊与群聊。需要其他功能的请按官方文档集成。
-
第一步 注册开发者账号,创建应用。(拿到App Key)
第二步 下载 SDK
下载地址 http://www.rongcloud.cn/downloads第三步 将model导入工程
- IMLib 是基础包必须导入,同样的方式导入IMKit 包(两个包缺一不可,别忘记让app依赖这两个model)
-
将 PushLib 中的 jar 包 和 pushDaemon -> libs 目录下应用所支持平台的 so 拷贝到您应用的 libs 目录下,另外还需要将 pushDaemon -> executable 目录下各平台的可执行文件 push_daemon 拷贝到您应用 Module 的 assets 目录下。如图:
-
注意 : 放置 so 的文件夹位置需要和您 build.gradle 文件中配置的 jni 目录一致。
-
打开 IMLib Module 的 AndroidManifest.xml 文件,把 meta-data RONG_CLOUD_APP_KEY 的值修改为您自己的 AppKey. 如图:
-
在应用的 App Module 的 AndroidManifest.xml 文件中,添加 FileProvider 相关配置,修改 android:authorities 为 “您的应用的包名称.FileProvider”。
- 到此集成完毕,IMKit 集成方式跟IMLib一样(必须集成)
- 第四步 初始化
- 在 application 中调用 RongIM.init(this);
public class App extends Application {
@Override
public void onCreate() {
super.onCreate();
//初始化融云
RongIM.init(this);
}
}
运行程序可能会出现错误 ”初始化 RongIM.init(this) 时报错 Failed resolution of: Lio/rong/push/PushService”
解决办法: http://support.rongcloud.cn/kb/NjY5](http://support.rongcloud.cn/kb/NjY5)
-
获取Token
可以在融云官网获取 Touken 如图:
- 在 activity 中连接融云,RongIM.connect(token,callback)操作。
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// token 就是你刚刚获取的token
RongIM.connect(token, new RongIMClient.ConnectCallback() {
//token1参数报错
@Override
public void onTokenIncorrect() {
Log.e("TAG","参数错误");
Toast.makeText(MainActivity.this, "token1参数报错", Toast.LENGTH_SHORT).show();
}
@Override
public void onSuccess(String s) {
Log.e("TAG","成功");
// 连接成功,说明你已成功连接到融云Server
Toast.makeText(MainActivity.this, "连接成功 ", Toast.LENGTH_SHORT).show();
}
@Override
public void onError(RongIMClient.ErrorCode errorCode) {
Log.e("TAG","失败");
Toast.makeText(MainActivity.this, errorCode.getValue()+"", Toast.LENGTH_SHORT).show();
}
});
- 第五步 集成单聊
1、配置会话列表
配置布局文件
这是您的会话列表 Activity 对应的布局文件:conversationlist.xml。注意 android:name 固定为融云的 ConversationListFragment。
新建Activity
public class ConversationListActivity extends FragmentActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.conversationlist);
}
}
配置 intent-filter:
融云 SDK 是通过隐式调用的方式来实现界面跳转的。因此您需要在 AndroidManifest.xml 中,您的会话列表 Activity 下面配置 intent-filter,其中,android:host 是您应用的包名,需要手动修改,其他请保持不变。
2、配置会话界面
会话 Fragment 跟会话列表是完全一致的,您可以用同样的方式快速的配置好。
配置布局文件
这是您的会话列表 Activity 对应的布局文件:conversationlist.xml。注意 android:name 固定为融云的 ConversationListFragment。
新建Activity
public class ConversationActivity extends FragmentActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.conversation);
}
}
配置 intent-filter:
在 AndroidManifest.xml 中,会话 Activity 下面配置 intent-filter。 注意请修改 android:host 为您应用的包名,其他保持不变。
配置两个界面后就可以进行聊天了。
- 填写代码
//启动会话界面
findViewById(R.id.btn_chat_main).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
connectRongServer(token1);
//启动会话界面
if (RongIM.getInstance() != null)
RongIM.getInstance().startPrivateChat(MainActivity.this, "18673668975", "贝吉塔");
}
});
//启动会话列表
findViewById(R.id.btn_chatlist_main).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
connectRongServer(token1);
//启动会话列表
startActivity(new Intent(MainActivity.this, HomeActivity.class));
}
});
//创建群聊
findViewById(R.id.btn_createGroup_main).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
connectRongServer(token1);
//创建群聊
final List testList = new ArrayList();
testList.add("18673668975");
testList.add("18673668976");
testList.add("18673668977");
RongIM.getInstance().createDiscussion("123", testList, new RongIMClient.CreateDiscussionCallback() {
@Override
public void onSuccess(String s) {
// s 表示的是群组ID
Toast.makeText(MainActivity.this,s,Toast.LENGTH_SHORT).show();
ed = (EditText) findViewById(R.id.ed_id_main);
ed.setText(s);
roomId=s;
}
@Override
public void onError(RongIMClient.ErrorCode errorCode) {
// Toast.makeText(MainActivity.this,errorCode.getValue()+"",Toast.LENGTH_SHORT).show();
}
});
}
});
//进入群聊
findViewById(R.id.btn_joingroup_main).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
RongIM.getInstance().startDiscussionChat(MainActivity.this,群组ID,"123");
}
});
//添加讨论组成员
findViewById(R.id.btn_addgroup_main).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
connectRongServer(token1);
final ArrayList userIds = new ArrayList();
userIds.add("10");//增加 userId。
RongIM.getInstance().addMemberToDiscussion(roomId, userIds, new RongIMClient.OperationCallback() {
@Override
public void onSuccess() {
Toast.makeText(MainActivity.this, "添加成功", Toast.LENGTH_SHORT).show();
}
@Override
public void onError(RongIMClient.ErrorCode errorCode) {
Toast.makeText(MainActivity.this,errorCode.getValue()+"",Toast.LENGTH_SHORT).show();
}
});
}
});
//移除讨论组成员
findViewById(R.id.btn_delgroup_main).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
RongIM.getInstance().getRongIMClient().removeMemberFromDiscussion("bac45e36-3ef3-45b5-9047-dd25054c27ae", "10", new RongIMClient.OperationCallback() {
@Override
public void onSuccess() {
Toast.makeText(MainActivity.this, "移除成功", Toast.LENGTH_SHORT).show();
}
@Override
public void onError(RongIMClient.ErrorCode errorCode) {
Toast.makeText(MainActivity.this, errorCode.getValue()+"", Toast.LENGTH_SHORT).show();
}
});
}
});
//发送消息
findViewById(R.id.btn_sendmessage_main).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
// 构造 TextMessage 实例
TextMessage myTextMessage = TextMessage.obtain("发送消息");
/* 生成 Message 对象。
* "7127" 为目标 Id。根据不同的 conversationType,可能是用户 Id、讨论组 Id、群组 Id 或聊天室 Id。
* Conversation.ConversationType.PRIVATE 为私聊会话类型,根据需要,也可以传入其它会话类型,如群组,讨论组等。
*/
Message myMessage = Message.obtain("18673668975", Conversation.ConversationType.PRIVATE, myTextMessage);
RongIM.getInstance().sendMessage(myMessage, null, null, new IRongCallback.ISendMessageCallback() {
@Override
public void onAttached(Message message) {
//消息本地数据库存储成功的回调
Toast.makeText(MainActivity.this, "本地数据库存储成功", Toast.LENGTH_SHORT).show();
}
@Override
public void onSuccess(Message message) {
//消息通过网络发送成功的回调
Toast.makeText(MainActivity.this, "网络发送成功", Toast.LENGTH_SHORT).show();
}
@Override
public void onError(Message message, RongIMClient.ErrorCode errorCode) {
//消息发送失败的回调
Toast.makeText(MainActivity.this, "发送失败", Toast.LENGTH_SHORT).show();
}
});
}
});
}
以上几个方法,自己琢磨一下就能用了,如何集成到项目中你还需要好好考虑一下
- 六 添加好友
融云没有添加好友这个概念
具体流程思想 看看这个链接你就会懂 http://support.rongcloud.cn/kb/MzQ5
我自己就搞了这么多,需要什么自己下个嗨豹研究一下它的代码,我看了一下不算难。
下载地址:
https://github.com/CatEatFishs/RongYunNew