NIM是网易提供的一个即时通讯服务，实现了一个便捷的即时通讯框架，降低了第三方App在网络通讯模块开发的复杂程度。此篇文章主要学习了NIM的集成和一些基本的功能，进行记录。
参考文档：
NIM安卓开发集成
NIM集成
NIM有两种集成方式，gradle集成和类库集成，使用gradle会更加自动化和灵活。
- 添加gradle依赖
android {
defaultConfig {
ndk {
//设置支持的SO库架构
abiFilters "armeabi-v7a", "x86","arm64-v8a","x86_64"
}
}
}
dependencies {
compile fileTree(dir: 'libs', include: '*.jar')
// 添加依赖。注意，版本号必须一致。
// 基础功能 (必需)
implementation 'com.netease.nimlib:basesdk:6.1.1'
// 音视频和互动白板服务需要
implementation 'com.netease.nimlib:nrtc:6.1.1'
// 音视频需要
implementation 'com.netease.nimlib:avchat:6.1.1'
// 聊天室需要
implementation 'com.netease.nimlib:chatroom:6.1.1'
// 互动白板服务需要
implementation 'com.netease.nimlib:rts:6.1.1'
// 全文检索服务需要
implementation 'com.netease.nimlib:lucene:6.1.1'
// 小米、华为、魅族、fcm 推送
implementation 'com.netease.nimlib:push:6.1.1'
}
在build.gradle中加入上述依赖集成NIM，依赖的版本号必须一致。
- 添加权限与组件
在AndroidManifest.xml中加入如下配置：
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="xxx">
<!-- 权限声明 -->
<!-- 访问网络状态-->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!-- 控制呼吸灯，振动器等，用于新消息提醒 -->
<uses-permission android:name="android.permission.FLASHLIGHT" />
<uses-permission android:name="android.permission.VIBRATE" />
<!-- 外置存储存取权限 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<!-- 8.0 系统需要-->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<!-- 多媒体相关 -->
<uses-permission android:name="android.permission.CAMERA"/>
<uses-permission android:name="android.permission.RECORD_AUDIO"/>
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<!-- 如果需要实时音视频通话模块，下面的权限也是必须的。否则，可以不加 -->
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/>
<uses-permission android:name="android.permission.BROADCAST_STICKY"/>
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-feature android:name="android.hardware.camera" />
<uses-feature android:name="android.hardware.camera.autofocus" />
<uses-feature android:glEsVersion="0x00020000" android:required="true" />
<!-- SDK 权限申明, 第三方 APP 接入时，请将 com.netease.nim.demo 替换为自己的包名 -->
<!-- 和下面的 uses-permission 一起加入到你的 AndroidManifest 文件中。 -->
<permission
android:name="com.netease.nim.demo.permission.RECEIVE_MSG"
android:protectionLevel="signature"/>
<!-- 接收 SDK 消息广播权限， 第三方 APP 接入时，请将 com.netease.nim.demo 替换为自己的包名 -->
<uses-permission android:name="com.netease.nim.demo.permission.RECEIVE_MSG"/>
<application
...>
<!-- APP key, 可以在这里设置，也可以在 SDKOptions 中提供。
如果 SDKOptions 中提供了，取 SDKOptions 中的值。 -->
<meta-data
android:name="com.netease.nim.appKey"
android:value="key_of_your_app" />
<!-- 云信后台服务，请使用独立进程。 -->
<service
android:name="com.netease.nimlib.service.NimService"
android:process=":core"/>
<!-- 云信后台辅助服务 -->
<service
android:name="com.netease.nimlib.service.NimService$Aux"
android:process=":core"/>
<!-- 云信后台辅助服务 -->
<service
android:name="com.netease.nimlib.job.NIMJobService"
android:exported="true"
android:permission="android.permission.BIND_JOB_SERVICE"
android:process=":core"/>
<!-- 云信监视系统启动和网络变化的广播接收器，保持和 NimService 同一进程 -->
<receiver android:name="com.netease.nimlib.service.NimReceiver"
android:process=":core"
android:exported="false">
<intent-filter>
<action android:name="android.intent.action.BOOT_COMPLETED"/>
<action android:name="android.net.conn.CONNECTIVITY_CHANGE"/>
</intent-filter>
</receiver>
<!-- 云信进程间通信 Receiver -->
<receiver android:name="com.netease.nimlib.service.ResponseReceiver"/>
<!-- 云信进程间通信service -->
<service android:name="com.netease.nimlib.service.ResponseService"/>
<!-- 云信进程间通信provider -->
<!-- android:authorities="{包名}.ipc.provider", 请将com.netease.nim.demo替换为自己的包名 -->
<provider
android:name="com.netease.nimlib.ipc.NIMContentProvider"
android:authorities="com.netease.nim.demo.ipc.provider"
android:exported="false"
android:process=":core" />
</application>
</manifest>
appKey需在云信上创建应用之后获取。
- 混淆配置
若apk需要代码混淆，需在 proguard 配置文件中加入以下代码：
-dontwarn com.netease.**
-keep class com.netease.** {*;}
#如果你使用全文检索插件，需要加入
-dontwarn org.apache.lucene.**
-keep class org.apache.lucene.** {*;}
初始化
对于NIM版本在5.0.0以下的初始化，必须在Application中的onCreate函数中进行：
public class NimApplication extends Application {
/**
* 注意：每个进程都会创建自己的Application 然后调用onCreate() 方法，
* 如果用户有自己的逻辑需要写在Application#onCreate()（还有Application的其他方法）中，一定要注意判断进程，不能把业务逻辑写在core进程，
* 理论上，core进程的Application#onCreate()（还有Application的其他方法）只能做与im sdk 相关的工作
*/
public void onCreate() {
// ... your codes
// SDK初始化（启动后台服务，若已经存在用户登录信息， SDK 将完成自动登录）
NIMClient.init(this, loginInfo(), options());
// ... your codes
if (NIMUtil.isMainProcess(this)) {
// 注意：以下操作必须在主进程中进行
// 1、UI相关初始化操作
// 2、相关Service调用
}
}
// 如果返回值为 null，则全部使用默认参数。
private SDKOptions options() {
SDKOptions options = new SDKOptions();
// 如果将新消息通知提醒托管给 SDK 完成，需要添加以下配置。否则无需设置。
StatusBarNotificationConfig config = new StatusBarNotificationConfig();
config.notificationEntrance = WelcomeActivity.class; // 点击通知栏跳转到该Activity
config.notificationSmallIconId = R.drawable.ic_stat_notify_msg;
// 呼吸灯配置
config.ledARGB = Color.GREEN;
config.ledOnMs = 1000;
config.ledOffMs = 1500;
// 通知铃声的uri字符串
config.notificationSound = "android.resource://com.netease.nim.demo/raw/msg";
options.statusBarNotificationConfig = config;
// 配置保存图片，文件，log 等数据的目录
// 如果 options 中没有设置这个值，SDK 会使用采用默认路径作为 SDK 的数据目录。
// 该目录目前包含 log, file, image, audio, video, thumb 这6个目录。
String sdkPath = getAppCacheDir(context) + "/nim"; // 可以不设置，那么将采用默认路径
// 如果第三方 APP 需要缓存清理功能， 清理这个目录下面个子目录的内容即可。
options.sdkStorageRootPath = sdkPath;
// 配置是否需要预下载附件缩略图，默认为 true
options.preloadAttach = true;
// 配置附件缩略图的尺寸大小。表示向服务器请求缩略图文件的大小
// 该值一般应根据屏幕尺寸来确定， 默认值为 Screen.width / 2
options.thumbnailSize = ${Screen.width} / 2;
// 用户资料提供者, 目前主要用于提供用户资料，用于新消息通知栏中显示消息来源的头像和昵称
options.userInfoProvider = new UserInfoProvider() {
@Override
public UserInfo getUserInfo(String account) {
return null;
}
@Override
public int getDefaultIconResId() {
return R.drawable.avatar_def;
}
@Override
public Bitmap getTeamIcon(String tid) {
return null;
}
@Override
public Bitmap getAvatarForMessageNotifier(String account) {
return null;
}
@Override
public String getDisplayNameForMessageNotifier(String account, String sessionId,
SessionTypeEnum sessionType) {
return null;
}
};
return options;
}
// 如果已经存在用户登录信息，返回LoginInfo，否则返回null即可
private LoginInfo loginInfo() {
return null;
}
/**
* 配置 APP 保存图片/语音/文件/log等数据的目录
* 这里示例用SD卡的应用扩展存储目录
*/
static String getAppCacheDir(Context context) {
String storageRootPath = null;
try {
// SD卡应用扩展存储区(APP卸载后，该目录下被清除，用户也可以在设置界面中手动清除)，请根据APP对数据缓存的重要性及生命周期来决定是否采用此缓存目录.
// 该存储区在API 19以上不需要写权限，即可配置 <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="18"/>
if (context.getExternalCacheDir() != null) {
storageRootPath = context.getExternalCacheDir().getCanonicalPath();
}
} catch (IOException e) {
e.printStackTrace();
}
if (TextUtils.isEmpty(storageRootPath)) {
// SD卡应用公共存储区(APP卸载后，该目录不会被清除，下载安装APP后，缓存数据依然可以被加载。SDK默认使用此目录)，该存储区域需要写权限!
storageRootPath = Environment.getExternalStorageDirectory() + "/" + DemoCache.getContext().getPackageName();
}
return storageRootPath;
}
}
5.0.0版本以上可以按需初始化sdk, 在Application的onCreate函数中调用NIMClient.config方法，然后在UI进程的主线程上按需调用initSDK函数，可以加快应用启动初始化时间。
登入登出
初始化sdk之后可以调用云信的api，用户可以主动调用云信api或者创建网络监听，主动调用api一般使用以Service结尾的类，监听则使用以ServiceObserver结尾的类，如调用登陆接口使用AuthService .class ，监听接收消息使用MsgServiceObserver.class。
使用AuthService调用用户认证服务接口，如下调用登陆接口并实现RequestCallback回调：
LoginInfo info = new LoginInfo(); // config...
RequestCallback<LoginInfo> callback =
new RequestCallback<LoginInfo>() {
// 可以在此保存LoginInfo到本地，下次启动APP做自动登录用
@Override
public void onSuccess(LoginInfo param) {
}
@Override
public void onFailed(int code) {
}
@Override
public void onException(Throwable exception) {
}
};
NIMClient.getService(AuthService.class).login(info)
.setCallback(callback);
调用logout函数实现登出
NIMClient.getService(AuthService.class).logout();
消息收发
使用MsgService与MsgServiceObserver中的api实现消息的发送与监听。
-
消息发送
发送的消息对象均为IMMessage类，用MsgTypeEnum区分消息类型，有文本，图片，音频，视频，位置，文件等消息类型，使用getContent方法获取发送的文本内容，若发送的内容不是文本，则将内容放在对应的MsgAttachment当中发送。
IMMessage使用MessageBuilder创建。- 发送文本消息
创建文本消息
发送文本消息// 该帐号为示例，请先注册 String account = "testAccount"; // 以单聊类型为例 SessionTypeEnum sessionType = SessionTypeEnum.P2P; String text = "this is an example"; // 创建一个文本消息 IMMessage textMessage = MessageBuilder.createTextMessage(account, sessionType, text);NIMClient.getService(MsgService.class).sendMessage(textMessage, false); - 发送图片消息
创建图片消息
发送图片消息IMMessage message = MessageBuilder.createImageMessage(account, sessionType, file, file.getName());NIMClient.getService(MsgService.class).sendMessage(message, false); - 发送其他消息
发送其他消息
- 发送文本消息
-
消息监听
调用observeReceiveMessage接口实现消息监听。Observer<List<IMMessage>> incomingMessageObserver = new Observer<List<IMMessage>>() { @Override public void onEvent(List<IMMessage> messages) { // 处理新收到的消息，为了上传处理方便，SDK 保证参数 messages 全部 来自同一个聊天对象。 } } NIMClient.getService(MsgServiceObserve.class) .observeReceiveMessage(incomingMessageObserver, true);若消息中存在附件，如图片，音频，视频等SDK默认会自动下载，若要手动下 载，需设置SDKOptions中的preloadAttach参数为false，再调用downloadAttachment方法下载：
/** * 正常情况收到消息后附件会自动下载。如果下载失败，可调用该接口重新下载 * * @param msg 附件所在的消息体 * @param thumb 下载缩略图还是原文件。为true时，仅下载缩略图。 * 该参数仅对图片和视频类消息有效 * @return AbortableFuture 调用跟踪。可设置回调函数，可中止下载操作 */ public AbortableFuture<Void> downloadAttachment(IMMessage msg, boolean thumb);
网友评论