.  OpenIM(Android)主体功能集成

1.1  前置准备

如果您单纯是想体验OpenIM的功能，建议直接跳过这一步。直接查看快速集成。

在这个集成教程中，我们使用已创建的Demo应用，向您展示如何快速地集成OpenIMKit(Android)。

您需要入驻开发者并且创建应用后，才能集成OpenIM并且发布您的App。

您需要在完成快速集成后，将一些内容替换为您申请到的特定内容，才能发布您的App。对于这些需要替换的内容，会在教程中以注意点的形式标识出。

如有问题，请加旺旺群：1478679234 ，QQ群：283686989 ，邮箱：msg-support@umeng.com等联系

1.2  Step1 下载SDK包

如果您单纯是想体验OpenIM的功能，建议直接跳过这一步。直接下载Demo。如果您已经有了友盟appkey，请先下载SDK。 SDK下载后解压，得到以下内容：

doc是API说明文档

libs目录包含SDK。(libs中的libinet.so放到lib/armeabi目录)

res存放了集成IMKit所需要资源文件。

AndroidManifest.xml包含了集成SDK所需的权限和Android组件的声明。

proguard.cfg代码混淆配置，开发者需要将这些配置复制到自己APP的混淆配置文件中去。

其它文件夹(文件)用户不用去关注。

注意：res/drawable目录下的yw_1222.jpg不能重命名

在你正式发布应用之前，您务必需要使用自己申请的身份图片，并测试IM功能是否正常。现在，您可以暂时跳过这一步，以便快速的完成集成工作。您可以从以下链接中了解如何申请您自己的身份图片。

1.3  Step2 开发环境配置

将res、libs、assets目录内容复制到自己创建的工程中。

将AndroidManifest.xml内容复制到自己创建的工程中(即与自己工程中的AndroidManifest.xml内容合并)。

proguard.cfg是混淆配置，开发者需要将这些配置复制到自己APP的混淆配置文件中去(也是合并的方式)。

如果自己创建的工程未包含android-support-v4.jar，请从我们的demo工程中复制。demo下载

1.4  Step3 初始化

1.4.1  在res/valuse/strings里面加入

23015524 5424dc93fd98c58ec20289da

1.4.2  在AndroidManifest里面加入

1.4.3  在Application的onCreate()方法中加入一下代码

OpenIMAgent im = OpenIMAgent.getInstance(this);

im.init();

注意:

1、app_key一定要写到res/valuse/strings里面否则会报错

2、初始化方法的调用建议放在Application onCreate方法中；如果您已经有友盟的umeng_appkey和app_key，可以替换成友盟的umeng_appkey和app_key。app_key在im.umeng.com中创建app后获取。

1.5  Step4 获取SDK对象实现

YWIMKit mIMKit = YWAPI.getIMKitInstance();

此对象获取到后，可保存为全局对象，供APP使用。

1.6  Step5 登录

//开始登录 String userid = "testpro1";

String password = "taobao1234";

IYWLoginService loginService = mIMKit.getLoginService();

YWLoginParam loginParam = YWLoginParam.createLoginParam(userid, password);

loginService.login(loginParam, new IWxCallback() { @Override public void onSuccess(Object... arg0) {

} @Override public void onProgress(int arg0) { // TODO Auto-generated method stub } @Override public void onError(int errCode, String description) { //如果登录失败，errCode为错误码,description是错误的具体描述信息 }

});

注意：此demo中登陆账号使用的appkey为5424dc93fd98c58ec20289da，公共帐号：visitor01~visitor100 密码：taobao1234

1.7  Step6 打开会话列表

Intent intent =mIMKit.getConversationActivityIntent();

startActivity(intent);

1.8  Step7 打开单聊窗口

String target = "targetUserId";// 消息接收者ID Intent intent =mIMKit.getChattingActivityIntent(target);

startActivity(intent);

1.9  更多功能

上述的快速集成文档能够让您以最快的速度完成Android OpenIM SDK的集成。您可能会对如下主题感兴趣：