集成阶段
这一阶段我们不必详细说明,因为融云官网给我们的SDK文档相当详细顺着他的步骤即可。
使用阶段
融云初始化
public class App extends Application{
@Override
public void onCreate() {
super.onCreate();
//初始化融云
RongIM.init(this);
}
}
在mainactivity中连接融云,注意测试阶段可以简单的使用融云的测试token连接
//kris 这个token为融云调试token 真正项目中一般会在登录接口中给你返回token 替换即可
String token = "/J0eHW43mJdYDJg+0gKKZPRTe2GHWU4uO8Hvo+MUDHW6IduhjEa5yInXxsWDUOk5GH9WTfGOBnqoqulyj8HViQ==";
RongIM.connect(token, new RongIMClient.ConnectCallback() {
@Override
public void onSuccess(String userId) {
Log.e("MainActivity", "——onSuccess—-" + userId);
Toast.makeText(MainActivity.this,"用户id"+userId,Toast.LENGTH_SHORT).show();
}
@Override
public void onError(RongIMClient.ErrorCode errorCode) {
Log.e("MainActivity", "——onError—-" + errorCode);
}
@Override
public void onTokenIncorrect() {
//Connect Token 失效的状态处理,需要重新获取 Token
}
});
/**
* 启动单聊
* context - 应用上下文。
* targetUserId - 要与之聊天的用户 Id。
* title - 聊天的标题,如果传入空值,则默认显示与之聊天的用户名称。
*/
if (RongIM.getInstance() != null) {
RongIM.getInstance().startPrivateChat(MainActivity.this, "1234", "");
}
/**
* 启动群组聊天界面。
*
* @param context 应用上下文。
* @param targetGroupId 要聊天的群组 Id。
* @param title 聊天的标题。开发者需要在聊天界面通过intent.getData().getQueryParameter("title")获取该值, 再手动设置为聊天界面的标题。
*/
// if ( RongIM.getInstance()!=null) {
// //发起群聊天
// RongIM.getInstance().startGroupChat(mActivity, groupID, groupName);
// }else{
// Tip.tipshort(mActivity,"群聊内容为空");
// }
此时,我们就开始运行程序检测token是否连接融云成功,如果你使用的是Android7.0手机的话你会发现怎么都不能发送消息。然后,在顺着SDK文档找上一遍发现还是没有问题呀,为什么会出现这个问题呢,然后详细看了日志会提示这样一个错误
java.lang.UnsatisfiedLinkError: dlopen failed: library "libsqlite.so" not found
at java.lang.Runtime.load0(Runtime.java:897)
at java.lang.System.load(System.java:1505)
at com.getkeepsafe.relinker.SystemLibraryLoader.loadPath(SystemLibraryLoader.java:29)
at com.getkeepsafe.relinker.ReLinkerInstance.loadLibraryInternal(ReLinkerInstance.java:200)
at com.getkeepsafe.relinker.ReLinkerInstance.loadLibrary(ReLinkerInstance.java:140)
at com.getkeepsafe.relinker.ReLinker.loadLibrary(ReLinker.java:70)
at com.getkeepsafe.relinker.ReLinker.loadLibrary(ReLinker.java:51)
at io.rong.imlib.NativeObject.<clinit>(NativeObject.java:13)
at io.rong.imlib.NativeClient.init(NativeClient.java:157)
at io.rong.imlib.LibHandlerStub.init(LibHandlerStub.java:50)
at io.rong.imlib.IHandler$Stub.onTransact(IHandler.java:52)
at android.os.Binder.execTransact(Binder.java:565)
libsqlite.so文件找不见了,好勒,差啥我们就干啥,libsqlite.so下载
放置位置好了接下来你可能觉得可以了,那到未必。如果你的buildToolsVersion低于26的话问题就是如下了,为啥会报这样的错呢?(已经更新到26的话可以忽略这一步)
Process: com.zontonec.ztteacher, PID: 26682
java.lang.NoClassDefFoundError: Failed resolution of: Lio/rong/push/PushService;
at io.rong.push.RongPushClient.init(RongPushClient.java:146)
at io.rong.imlib.RongIMClient.initSDK(RongIMClient.java:451)
at io.rong.imlib.RongIMClient.init(RongIMClient.java:481)
at io.rong.imkit.RongIM.initSDK(RongIM.java:155)
at io.rong.imkit.RongIM.init(RongIM.java:209)
at com.zontonec.ztteacher.App.onCreate(App.java:66)
at android.app.Instrumentation.callApplicationOnCreate(Instrumentation.java:1028)
at android.app.ActivityThread.handleBindApplication(ActivityThread.java:5720)
at android.app.ActivityThread.-wrap2(ActivityThread.java)
at android.app.ActivityThread$H.handleMessage(ActivityThread.java:1637)
at android.os.Handler.dispatchMessage(Handler.java:105)
at android.os.Looper.loop(Looper.java:156)
at android.app.ActivityThread.main(ActivityThread.java:6585)
at java.lang.reflect.Method.invoke(Native Method)
融云 Android SDK 在 2.8.25-Dev 这个版本就对对 Android 8.0 做了适配。
所有项目出错了,因此,对于IMKIT下面的依赖版本一定要大于26以上才能保证正常使用
在升级到 2.8.25-Dev 版本以上时,
需要注意:SDK 中用到了 Support Library 中的比较新的 API,因此在升级 SDK 的时候,需要将工程
项目的 gradle 文件中的 Support Library 依赖升级到 26.0.0 以后,在 IMKit 中 gradle 文件中添加以下代码:
dependencies {
compile 'com.android.support:support-v4:26.1.0'
}
如果工程中其他的module也用到了 Support Library 相关的库,也需要同步升级到 26.0.0 版本以上;
相应的,compileSdkVersion 和 buildToolsVersion 也需要同步升级到 26.0.0 以上的版本:
compileSdkVersion 26
buildToolsVersion '26.0.2'
另外,如果您工程的 build.gradle 里没有配置对谷歌 marven 仓库的依赖,也需要添加上。如下图所示:
repositories {
jcenter()
mavenCentral()
maven {
url 'https://maven.google.com/'
name 'Google'
}
}
避免出现编译错误。
所有都能正常使用了我们再来看看如何开启会话列表,会话列表页面,以及会话页面的动态静态使用方法
会话页面可以手动开启也可以清单文件加意图过滤器自动开启,
//会话界面
public class ConversationActivity extends FragmentActivity {
private static final String TAG = ConversationActivity.class.getSimpleName();
private TextView mName;
@TargetApi(Build.VERSION_CODES.LOLLIPOP)
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_conversation);
String sId = getIntent().getData().getQueryParameter("targetId");//targetId:单聊即对方ID,群聊即群组ID
String title = getIntent().getData().getQueryParameter("title");//获取标题
mName = (TextView) findViewById(R.id.name);
mName.setText("王大锤");
}
}
布局文件,可以自定义需要什么功能
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
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_id"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:name="io.rong.imkit.fragment.ConversationFragment"/>
</LinearLayout>
会话列表界面动态方法加载只需要写在你需要加载的fragment或者activity中
//会话列表
ConversationListFragment conversationListFragment = new ConversationListFragment();
Uri uri = Uri.parse("rong://" + getActivity().getApplicationInfo().packageName).buildUpon()
.appendPath("conversationlist") .appendQueryParameter(Conversation.ConversationType.PRIVATE.getName(), "false") //设置私聊会话,该会话聚合显示
// .appendQueryParameter(Conversation.ConversationType.SYSTEM.getName(), "true")//设置系统会话,该会话非聚合显示
.appendQueryParameter(Conversation.ConversationType.PRIVATE.getName(), "false")//设置私聊会话是否聚合显示
.appendQueryParameter(Conversation.ConversationType.GROUP.getName(), "false")
// .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();
conversationListFragment.setUri(uri);
FragmentManager fragmentManager = getChildFragmentManager();
FragmentTransaction transaction = fragmentManager.beginTransaction();
transaction.add(R.id.rong_container,conversationListFragment);
transaction.commit();
布局文件如下
<fragment
android:id="@+id/rong_container"
android:name="io.rong.imkit.fragment.ConversationListFragment"
android:layout_width="match_parent"
android:layout_height="match_parent" />
原生效果图如下
会话列表,当然你也可也使用公司给你的接口自己设计那么,静态的如何实现呢?
清单文件中配置,host配置为自己的包名
<!-- 会话列表 -->
<activity
android:name=".rongcloude.ConversationListActivity"
android:launchMode="singleTask"
android:screenOrientation="portrait"
android:windowSoftInputMode="stateHidden|adjustResize">
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<data
android:host="com.zontonec.ztteacher"
android:path="/conversationlist"
android:scheme="rong" />
</intent-filter>
</activity>
布局文件,你只需要用<fragment就行,前面的根据需求定义
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:fitsSystemWindows="true"
android:background="@color/white"
android:orientation="vertical">
<RelativeLayout
android:id="@+id/rl_title_bg"
android:layout_width="fill_parent"
android:layout_height="45dp"
android:layout_alignParentBottom="true">
<ImageButton
android:id="@+id/title_bar_back"
android:layout_width="40dp"
android:layout_height="40dp"
android:layout_alignParentLeft="true"
android:layout_centerVertical="true"
android:background="@color/white"
android:src="@mipmap/nav_btn_back" />
<LinearLayout
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_centerHorizontal="true"
android:layout_centerVertical="true"
android:gravity="center_vertical"
android:orientation="horizontal">
<TextView
android:id="@+id/tv_class_name"
style="@style/one_text_style"
android:text="" />
</LinearLayout>
<ImageButton
android:id="@+id/title_bar_right"
android:layout_width="40dp"
android:layout_height="40dp"
android:layout_alignParentRight="true"
android:layout_centerVertical="true"
android:layout_marginRight="10dp"
android:background="@color/white"
android:src="@mipmap/nav_btn_member" />
</RelativeLayout>
<fragment
android:id="@+id/conversationlist"
android:name="io.rong.imkit.fragment.ConversationListFragment"
android:layout_width="match_parent"
android:layout_height="match_parent" />
</LinearLayout>
会话列表类
public class ConversationListActivity extends FragmentActivity {
private static final String TAG = ConversationListActivity.class.getSimpleName();
private LoadingDialog mDialog;
private SharedPreferences sp;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.conversationlist);
}
}
自此,关于启动单聊,群聊只需要传入id和title即可启动,已经会话,会话列表功能的实现和可能会遇到的一些不起眼的问题。
会话页面群组
群组类如果使用的是动态加载消息列表的话,有消息他才显示,没消息就不显示,你可以选择接口返回数据比如用listview,recycleview等加载,然后通过
if (RongIM.getInstance() != null) {
// //发起留言群聊天
// RongIM.getInstance().startGroupChat(mActivity, groupID, groupName);
// } else {
// Tip.tipshort(mActivity, "群聊内容为空");
// }
开启群聊会话界面。
下面是接着上面的内容完善一下内容,加入了群组列表头像,用户信息头像等。我们可见上图的头像和群列表的标题等都是没有头像和标题的;下面我们先来看看加上头像等后的效果图是怎么样?
这是加入群头像等的动态加载类的消息列表融云给我们提供了各种需求满足你们的项目实现这类功能,那么我们如何开始呢,首先讲解群组类的,我们可以在fragment或者activity中动态加载消息列表
在onCreat()初始化;
//初始化群组信息提供者
private void initGroupListener() {
RongIM.setGroupInfoProvider(this, true);
}
然后实现接口重写getGroupInfo()方法
public class NewsFragment extends BaseFragment implements RongIM.GroupInfoProvider
下面是重写的方法
//重新群组信息提供者
@Override
public Group getGroupInfo(String s) {
//首先对群组非空判断 然后增强for循环遍历数据
if(groupIdList!=null){
for (Friend f:groupIdList){
if(f.getGroupId().equals(s)){
return new Group(f.getGroupId(), f.getName(),Uri.parse(f.getPortraitUri()));//从bean中获取参数返回给融云
}
}
}
return null;
}
Friend是我们自己的bean类 groupIdlist是我们服务器返回的包含头像,昵称等的集合,我们拿到参数后返回给融云SDK就OK了。
private List<Friend> groupIdList;
//方法二使用融云动态加载群组头像 昵称等信息
groupIdList = new ArrayList<>();
for (int i = 0; i < list.size(); i++) {
String groupName = MapUtil.getValueStr(list.get(i), "groupName");
String groupType = MapUtil.getValueStr(list.get(i), "groupType");
String groupPhoto = MapUtil.getValueStr(list.get(i), "groupPhoto");
String groupID = MapUtil.getValueStr(list.get(i), "groupID");
Friend friend = null;
friend = new Friend(groupID,groupName,groupPhoto);
groupIdList.add(friend);
if (i > 0) {
break;
}
}
Friend
public class Friend {
private String groupId;
private String name;
private String portraitUri;
public String getGroupId() {
return groupId;
}
public void setGroupId(String userId) {
this.groupId = 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 groupId, String name, String portraitUri) {
this.groupId = groupId;
this.name = name;
this.portraitUri = portraitUri;
}
}
群组类列表实现就这样就OK了。
下面再看另一张效果图:
这个是会话页面头像效果图会话页面
那我们是如何实现这个效果的呢,其实,原理和群组是大同小异的;我们来看看代码怎么开始的。
同样,我们需要在onCreat()初始化另一个userinfo
RongIM.setUserInfoProvider(this, true);
然后实现接口RongIM.UserInfoProvider重写getUserInfo()方法
implements RongIM.UserInfoProvider
//关系列表
relationList = MapUtil
.getSafeMapWhenInteger((List) data
.get("relationList"));
String groupType = MapUtil.getValueStr(data, "groupType");//群类型
userInfoIdList = new ArrayList<>();
for (int j = 0; j < data.size(); j++) {
String photoUrl = MapUtil.getValueStr(data, "photoUrl");//头像
String userID = MapUtil.getValueStr(data, "userID");//用户
String userName = MapUtil.getValueStr(relationList.get(j), "userName");
Friends friends = null;
friends = new Friends(userID, userName, photoUrl);
userInfoIdList.add(friends);
if (j > 0) {
break;
}
}
然后,在重写方法中将参数返回给融云SDK,Friends同样是bean类,根据你的需要选择参数传入就行了,getUserInfo(String s) s为用户id和你服务器返回的useid判断,为同一个用户就能够返回给融云然后实现头像等信息的显示。
//获取用户信息
@Override
public UserInfo getUserInfo(String s) {
//首先对群组非空判断 然后增强for循环遍历数据
if (userInfoIdList != null) {
for (Friends i : userInfoIdList) {
if (i.getUserId().equals(s)) {
Tip.tipshort(ConversationActivity.this,"用户id2"+s);
Log.e(TAG, i.getPortraitUri());
return new UserInfo(i.getUserId(), i.getName(), Uri.parse(i.getPortraitUri()));
}
}
}
Log.e("ConversationActivity", "UserId is : " + s);
return null;
}
同样,当我们单聊等也是以此类推既能够实现用户信息。
如果有哪不对或者有更好意见的欢迎各路大神留个意见,一定改善
demo源码
网友评论