融云提供了非常简单的即时聊天SDK,官网提供了两个包,还有包括一些so文件,集成起来太过繁琐,我发现了一个提别好用的包,这个包把官网的SDK一些文件都集成在这个包上了,所以只需要关联一个包就可以使用融云的即时通讯功能了,我们只需要把这个包跟当前的项目关联就能使用了。下载包点这里
把下载好的包导入进去之后,需要把包里面的清单配置文件
<meta-data
android:name="RONG_CLOUD_APP_KEY"
android:value="你的APPKEY" />
把这个修改成你在官网申请的APPKEY
修改完之后我们要初始化SDK了,创建一个Application类,初始化
public class App extends Application {
@Override
public void onCreate() {
super.onCreate();
//初始化融云
RongIM.init(this);
}
}
不要忘记在清单文件里面配置!还有记得写网络权限啊!
然后去官网申请一个TOKEN,然后这个TOKEN值去实现与SDK的连接
public class MainActivity extends AppCompatActivity implements RongIM.UserInfoProvider{
String token1 = "eQz4I3Vk1/4shgMVModBMojPtE0D5yA8oBdN1AyPQ5Tr0VthohdlzhhrqdTa/Q6xkr45B3FosNzvw49zJ7tR0vYgKn3Q5l77";
private List<Friend> userIdList;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
//链接融云的方法
connectRongServer(token1);
initUserInfo();
}
private void connectRongServer(String token) {
RongIM.connect(token, new RongIMClient.ConnectCallback() {
@Override
public void onSuccess(String userId) {
if (userId.equals("565535360")) {
//生成TOKEN的唯一标识:565535360
startActivity(new Intent(MainActivity.this, HomeActivity.class));//成功跳转
Toast.makeText(MainActivity.this, "连接成功", Toast.LENGTH_SHORT).show();
}
}
@Override
public void onError(RongIMClient.ErrorCode errorCode) {
// Log.e("onError", "onError userid:" + errorCode.getValue());//获取错误的错误码
Log.e("MainActivity", "connect failure errorCode is : " + errorCode.getValue());
}
@Override
public void onTokenIncorrect() {
Log.e("MainActivity", "token is error ,please check token and appkey");
}
});
}
private void initUserInfo() {
userIdList = new ArrayList<Friend>();
userIdList.add(new Friend("123", "联通", "http://www.51zxw.net/bbs/UploadFile/2013-4/201341122335711220.jpg"));
//发送人的ID:123
userIdList.add(new Friend("565535360", "老板", "http://img.ivsky.com/img/bizhi/pre/201710/23/hamicat-003.jpg"));
//接收的ID:565535360
RongIM.setUserInfoProvider(this, true);
//RongIM自带的方法,可以给聊天的人设置备注,头像
}
//实现的方法
@Override
public UserInfo getUserInfo(String s) {
for (Friend i : userIdList) {
if (i.getUserId().equals(s)) {
Log.e("+++++++++++++++++", i.getPortraitUri());
return new UserInfo(i.getUserId(), i.getName(), Uri.parse(i.getPortraitUri()));
}
}
Log.e("MainActivity", "UserId is : " + s);
return null;
}
}
565535360是你申请TOKEN的时候写的ID,用户在App中的唯一标识码,会自己识别你当前的TOKEN里面的ID值,在进行比较,如果一样就代表是这个用户,就可以
执行成功的方法,跳转到HomeActivity。这个标识可以理解为QQ号,微信号。还有就是使用了一个Bean类,用来存放聊天人的ID、名字还有头像
public class Friend {
//存放联系人的头像,ID,名称
private String userId;
private String name;
private String portraitUri;
public String getUserId() {
return userId;
}
public void setUserId(String userId) {
this.userId = userId;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getPortraitUri() {
return portraitUri;
}
public void setPortraitUri(String portraitUri) {
this.portraitUri = portraitUri;
}
public Friend(String userId, String name, String portraitUri) {
this.userId = userId;
this.name = name;
this.portraitUri = portraitUri;
}
}
HomeActivity布局文件
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical"
tools:context="com.example.liaotian3.HomeActivity">
<android.support.v4.view.ViewPager
android:id="@+id/viewpager"
android:layout_width="match_parent"
android:layout_height="0dp"
android:layout_weight="1" />
</LinearLayout>
用到的是viewpager+fragment,官网说的是消息界面的实现是在Fragment的基础之上的,所以就只能用这个方法显示消息列表,我还没找到其他的方式去写这个消息列表的布局
有点菜,所以只能使用Fragment添加到Viewpager中显示消息列表。这里还有一个坑,就是必须要写这个垂直属性,要不然不会出现消息列表的,这个坑成功的坑了我两个小时。HomeActivity:
public class HomeActivity extends FragmentActivity {
private ViewPager mViewPager;
private FragmentPagerAdapter mFragmentPagerAdapter;//将tab页面持久在内存中
private Fragment mConversationList;
private Fragment mConversationFragment = null;
private List<Fragment> mFragment = new ArrayList<>();
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_home);
mConversationList = initConversationList();//获取融云会话列表的对象
mViewPager = (ViewPager) findViewById(R.id.viewpager);
mFragment.add(mConversationList);//加入会话列表
//配置ViewPager的适配器
mFragmentPagerAdapter = new FragmentPagerAdapter(getSupportFragmentManager()) {
@Override
public Fragment getItem(int position) {
return mFragment.get(position);
}
@Override
public int getCount() {
return mFragment.size();
}
};
mViewPager.setAdapter(mFragmentPagerAdapter);
}
private Fragment initConversationList() {
/**
* appendQueryParameter对具体的会话列表做展示
*/
if (mConversationFragment == null) {
ConversationListFragment listFragment = ConversationListFragment.getInstance();
Uri uri = Uri.parse("rong://" + getApplicationInfo().packageName).buildUpon()
.appendPath("conversationList")
.appendQueryParameter(Conversation.ConversationType.PRIVATE.getName(), "false")//设置私聊会话是否聚合显示
.appendQueryParameter(Conversation.ConversationType.GROUP.getName(), "true")
// .appendQueryParameter(Conversation.ConversationType.PUBLIC_SERVICE.getName(), "false")//公共服务号
//.appendQueryParameter(Conversation.ConversationType.APP_PUBLIC_SERVICE.getName(), "false")//公共服务号
.appendQueryParameter(Conversation.ConversationType.DISCUSSION.getName(), "false")//设置私聊会话是否聚合显示
.appendQueryParameter(Conversation.ConversationType.SYSTEM.getName(), "false")//设置私聊会是否聚合显示
.build();
listFragment.setUri(uri);
return listFragment;
} else {
return mConversationFragment;
}
}
}
这只是展示消息列表的功能实现了,还没有实现聊天的界面呢,所以还需要创建一个Activity写聊天的界面,布局就是一个TextView展示对方是的姓名,一个fragment布局,集成的SDK提供了聊天的页面,不需要我们自己动手写布局。
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical">
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:background="#000">
<TextView
android:id="@+id/name"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="center_vertical"
android:layout_margin="15dp"
android:text="rongCloud"
android:textColor="#fff"
android:textSize="18sp" />
</LinearLayout>
<fragment
android:id="@+id/conversation"
android:name="io.rong.imkit.fragment.ConversationFragment"
android:layout_width="match_parent"
android:layout_height="match_parent" />
</LinearLayout>
public class XiaoXiActivity extends FragmentActivity {
private TextView mName;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_xiao_xi);
mName = (TextView) findViewById(R.id.name);
String sId = getIntent().getData().getQueryParameter("targetId");//targetId:单聊即对方ID,群聊即群组ID
String sName = getIntent().getData().getQueryParameter("title");//获取昵称
if (!TextUtils.isEmpty(sName)){
mName.setText(sName);
}else {
// sId
//TODO 拿到id 去请求自己服务端
}
}
}
获得对方的昵称赋值到控件上,这样就实现了聊天的界面了。这个页面写完之后记得要去配置文件里面加上如下代码,要不然你就算收到信息你也点不进去。host填写你的包名。
<activity android:name=".XiaoXiActivity">
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<data
android:host="你的包名"
android:pathPrefix="/conversation/"
android:scheme="rong" />
</intent-filter>
</activity>
有的同志可能第一次集成,集成好了列表可能没有信息,这时候去融云官网找到你创建的项目,点击
API调试,消息服务,发送单聊信息,fromUserID随便填,toUserID必须填自己的ID,然后其他的不用管,点击提交,然后你就会听到叮的一声,你的消息列表就有消息了。
做出来感觉还挺简单,然而路上进了不少坑,还有待提高啊!!!