融云IM（一）-----接入

本文主要是介绍融云IM（一）-----接入，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

前言

1、融云IM应该说是目前最好自定义和易读取文档的即时通讯第三方SDK了，之前有用过阿里百川IM的，可惜阿里百川不再更新和维护了
2、im千万别选QQ的，如果就普通聊天选择qq那没问题，如果业务需要自定义的果断放弃。融云IM一直在快速的更新和维护。选它就没错了

步骤1:创建应用，导入SDK

创建应用:记得开发环境和生产环境是分开的，开发环境可生成的IM账号是有限的，有时im登录不成功是因为没账号.
导入SDK:强烈推荐以导入 Module 方式引入IMKit,IMLib。方便修改

步骤2：初始化

public class App extends Application {@Overridepublic void onCreate() {super.onCreate();RongIM.init(this);}
}

步骤3：登录IM

从app服务器端获取token，然后调用RongIM.connect(token, new RongIMClient.ConnectCallback())即可
一般调用时机是在首页，看业务也可以在启动界面。
注意

1. 调用成功一次就好
2. 服务器获取的token，可以用SP保存下来，因为是长期有效的，不用每次都去获取

示例代码：

public static void connect() {if (Utils.isNetworkConnected(MyApplication.getInstance()))if (!TextUtils.isEmpty(SPUtils.getToken())) {connect(SPUtils.getToken(),null);} else {//正常只有第一次进入应用会为""new BaseIMPresenter().getToken(false, new EmptyTokenListener() {@Overridepublic void getToken(String token) {connect(token, null);}});}
}/*** <p>连接服务器，在整个应用程序全局，只需要调用一次，需在 {@link #init(Context)} 之后调用。</p>* <p>如果调用此接口遇到连接失败，SDK 会自动启动重连机制进行最多10次重连，分别是1, 2, 4, 8, 16, 32, 64, 128, 256, 512秒后。* 在这之后如果仍没有连接成功，还会在当检测到设备网络状态变化时再次进行重连。</p>** @param token 从服务端获取的用户身份令牌（Token）。* @return RongIM  客户端核心类的实例。*/
private static void connect(String token, final ConnectListener cl) {if (BuildConfig.APPLICATION_ID.equals(MyApplication.getCurProcessName(MyApplication.getInstance()))) {RongIM.connect(token, new RongIMClient.ConnectCallback() {/*** Token 错误。可以从下面两点检查* 1.  Token 是否过期，如果过期您需要向 App Server 重新请求一个新的 Token* 2.  token 对应的 appKey 和工程里设置的 appKey 是否一致*/@Overridepublic void onTokenIncorrect() {if (null != cl)cl.onTokenIncorrect();new BaseIMPresenter().getToken(true, null);}/*** 连接融云成功* @param userid 当前 token 对应的用户 id*/@Overridepublic void onSuccess(String userid) {}/*** 连接融云失败* @param errorCode 错误码，可到官网 查看错误码对应的注释*/@Overridepublic void onError(RongIMClient.ErrorCode errorCode) {}});}
}

额外提供IM是否在线的方法

public static boolean isOnline() {return RongIM.getInstance().getCurrentConnectionStatus().equals(RongIMClient.ConnectionStatusListener.ConnectionStatus.CONNECTED);
}

步骤4： 会话列表界面

就是用IMKit中的ConversationListFragment，可以认为就是个fragment。正常用就会显示，后期会介绍在这fragment中新增些自定义的会话
注意点：

它是用uri来设置你要显示的类型
如果本身就是显示会话列表界面需要在清单中配置(可参考融云文档)

示例代码：

public Fragment initConversationList() {if (mListFragment == null) {mListFragment = new ConversationListFragment();uri = Uri.parse("rong://" + BuildConfig.APPLICATION_ID).buildUpon().appendPath("conversationlist").appendQueryParameter(Conversation.ConversationType.PRIVATE.getName(), "false").appendQueryParameter(Conversation.ConversationType.SYSTEM.getName(), "false").build();mListFragment.setUri(uri);}return mListFragment;
}

步骤5：会话界面

用的是IMkit中的ConversationFragment。有targetId就能显示，targetId就是对方的IM账号

示例代码：

private void enterFragment(Conversation.ConversationType mConversationType, String toUserIm) {fragment = new ConversationFragment();uri = Uri.parse("rong://" + BuildConfig.APPLICATION_ID).buildUpon().appendPath("conversation").appendPath(mConversationType.getName().toLowerCase()).appendQueryParameter("targetId", toUserIm).build();fragment.setUri(uri);FragmentTransaction transaction = getSupportFragmentManager().beginTransaction();//xxx 为你要加载的 idtransaction.add(R.id.rong_content, fragment);transaction.commitAllowingStateLoss();showRealView();
}

在 AndroidManifest.xml 中，会话 Activity 下面配置 intent-filter。 注意请修改 android:host 为 App 的 ApplicationId，其他保持不变。

<activityandroid:name="io.rong.fast.activity.ConversationActivity"android:screenOrientation="portrait"android:windowSoftInputMode="stateHidden|adjustResize"><intent-filter><action android:name="android.intent.action.VIEW" /><category android:name="android.intent.category.DEFAULT" /><dataandroid:host="${applicationId}"android:pathPrefix="/conversation/"android:scheme="rong" /></intent-filter></activity>

ApplicationId可以不改，在build.gradle里面配置
manifestPlaceholders = [ APPLICATIONID: applicationId]
启动会话界面
示例代码：

public static void startChattingActivity(Context context, Conversation.ConversationType conversationType, String targetId, String title) {if (context != null && !TextUtils.isEmpty(targetId) && conversationType != null) {Uri uri = Uri.parse("rong://" + BuildConfig.APPLICATION_ID).buildUpon().appendPath("conversation").appendPath(conversationType.getName().toLowerCase(Locale.US)).appendQueryParameter("targetId", targetId).appendQueryParameter("title", title).build();context.startActivity(new Intent("android.intent.action.VIEW", uri));} else {throw new IllegalArgumentException();}
}

title是用来显示标题的，当然会话界面就需要做获取代码了。

还有混淆啥的，可参考官网

好了，到这里接入IM，并且建立聊天就完成了。有问题可加我QQ:893151960或者群142739277
先说明：解决问题可能收费的，讨论问题免费

这篇关于融云IM（一）-----接入的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！

---