. 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里面加入
<string name="app_key">23015524</string> <string name="umeng_appkey">5424dc93fd98c58ec20289da</string>
1.4.2 在AndroidManifest里面加入
<meta-data android:name="UMENG_APPKEY" android:value="@string/umeng_appkey" > </meta-data> <meta-data android:name="APP_KEY" android:value="@string/app_key" > </meta-data>
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的集成。您可能会对如下主题感兴趣: