Android集成环信即时通信

下载SDK新建工程导入SDK添加权限和配置初始化基础功能注册登录 如果自己来写一个类似微信的音视频聊天软件虽然能实现功能，但是实现过程还是比较麻烦，周期也比较长，可能最后出来漏洞也比较多，直接引入第三方的就省事很多，本文简单描述一下将环信SDK继承在Android应用中。

下载SDK

进入到官网： 下载完成后解压出来有如下文件夹：

doc：SDK 相关 API 文档examples：ChatDemoUI3.0（Demo,依赖 EaseUI 库）、EaseUIlibs.av：包含IM和实时音视频功能所需要的 jar 和 so 文件libs.lite：无实时语音、实时视频功能的 SDK 包，如果项目中只用到聊天功能，可以把项目里的 jar 和 so 文件替换成此文件夹里的文件tools：从 SDK2.x 升级到 3.0的工具

本文只需要用libs.av目录里面这两个东西：

新建工程

导入SDK

直接复制到libs目录下：

sourceSets { main { jniLibs.srcDirs = ['libs'] } }

添加权限和配置

<uses-permission android:name="android.permission.VIBRATE" /> <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.RECORD_AUDIO" /> <uses-permission android:name="android.permission.CAMERA" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.ACCESS_MOCK_LOCATION" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" /> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> <uses-permission android:name="android.permission.GET_TASKS" /> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" /> <uses-permission android:name="android.permission.WAKE_LOCK" /> <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" /> <uses-permission android:name="android.permission.READ_PHONE_STATE" /> <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />

如下配置写到application节点中：

<meta-data android:name="EASEMOB_APPKEY" android:value="Appkey" /> <!-- 声明SDK所需的service SDK核心功能 --> <receiver android:name="com.hyphenate.chat.EMMonitorReceiver"> <intent-filter> <action android:name="android.intent.action.PACKAGE_REMOVED" /> <data android:scheme="package" /> </intent-filter> <!-- 可选filter --> <intent-filter> <action android:name="android.intent.action.BOOT_COMPLETED" /> <action android:name="android.intent.action.USER_PRESENT" /> </intent-filter> </receiver> <service android:name="com.hyphenate.chat.EMJobService" android:exported="true" android:permission="android.permission.BIND_JOB_SERVICE" /> <!-- 声明SDK所需的receiver --> <service android:name="com.hyphenate.chat.EMChatService" android:exported="true" />

上面的AppKey需要到官网去获取： 注册账户并登录： 将这个AppKey复制到代码对应位置后基本配置引入完成了。

初始化

ECApplication代码如下：

import android.app.ActivityManager; import android.app.Application; import android.content.pm.PackageManager; import android.util.Log; import com.hyphenate.chat.EMClient; import com.hyphenate.chat.EMOptions; import java.util.Iterator; import java.util.List; public class ECApplication extends Application { @Override public void onCreate() { super.onCreate(); initEasemob(); } private void initEasemob(){ EMOptions options = new EMOptions(); // 默认添加好友时，是不需要验证的，改成需要验证 options.setAcceptInvitationAlways(false); int pid = android.os.Process.myPid(); String processAppName = getAppName(pid); // 如果APP启用了远程的service，此application:onCreate会被调用2次 // 为了防止环信SDK被初始化2次，加此判断会保证SDK被初始化1次 // 默认的APP会在以包名为默认的process name下运行，如果查到的process name不是APP的process name就立即返回 if (processAppName == null ||!processAppName.equalsIgnoreCase(this.getPackageName())) { Log.e("ECApplication", "enter the service process!"); // 则此application::onCreate 是被service 调用的，直接返回 return; } //初始化 EMClient.getInstance().init(this, options); //在做打包混淆时，关闭debug模式，避免消耗不必要的资源 EMClient.getInstance().setDebugMode(true); } private String getAppName(int pID) { String processName = null; ActivityManager am = (ActivityManager) this.getSystemService(ACTIVITY_SERVICE); List l = am.getRunningAppProcesses(); Iterator i = l.iterator(); PackageManager pm = this.getPackageManager(); while (i.hasNext()) { ActivityManager.RunningAppProcessInfo info = (ActivityManager.RunningAppProcessInfo) (i.next()); try { if (info.pid == pID) { processName = info.processName; return processName; } } catch (Exception e) { // Log.d("Process", "Error>> :"+ e.toString()); } } return processName; } }

编译的时候出现类似如下错误： 添加如下即可：

compileOptions { sourceCompatibility JavaVersion.VERSION_1_8 targetCompatibility JavaVersion.VERSION_1_8 }

如果编译运行没错就算集成成功，之后就可以使用API接口了。

基础功能

在官方网站中可以看到基础功能介绍，例如用户注册和登录：

注册

注册模式分两种，开放注册和授权注册。只有开放注册时，才可以客户端注册。 开放注册是为了测试使用，正式环境中不推荐使用该方式注册环信账号； 授权注册的流程应该是您服务器通过环信提供的 REST API 注册，之后保存到您的服务器或返回给客户端。 注册用户名会自动转为小写字母，所以建议用户名均以小写注册。（强烈建议开发者通过后台调用 REST 接口去注册环信 ID，客户端注册方法不提倡使用。）

//注册失败会抛出HyphenateException EMClient.getInstance().createAccount(username, pwd);//同步方法

登录

注意：除了注册监听，其他的 SDK 操作均需在登陆之后才能进行。

EMClient.getInstance().login(userName,password,new EMCallBack() {//回调 @Override public void onSuccess() { Log.d("main", "登录聊天服务器成功！"); } @Override public void onProgress(int progress, String status) { } @Override public void onError(int code, String message) { Log.d("main", "登录聊天服务器失败！"); } });

简单布局一下： 在登录按钮点击事件中调用登录接口即可： demo代码下载地址