融云IM（一）—–接入

大家好，欢迎来到IT知识分享网。

前言

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

步骤2：初始化

public class App extends Application { @Override public 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() { @Override public 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 是否一致 */ @Override public void onTokenIncorrect() { if (null != cl) cl.onTokenIncorrect(); new BaseIMPresenter().getToken(true, null); } / * 连接融云成功 * @param userid 当前 token 对应的用户 id */ @Override public void onSuccess(String userid) { } / * 连接融云失败 * @param errorCode 错误码，可到官网 查看错误码对应的注释 */ @Override public void onError(RongIMClient.ErrorCode errorCode) { } }); } } 

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

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

步骤4： 会话列表界面

示例代码：

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 为你要加载的 id transaction.add(R.id.rong_content, fragment); transaction.commitAllowingStateLoss(); showRealView(); } 

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

<activity android: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" /> <data android: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是用来显示标题的，当然会话界面就需要做获取代码了。

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