客服IMSDK文档.pdf

《客服IMSDK文档.pdf》由会员分享，可在线阅读，更多相关《客服IMSDK文档.pdf（12页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、精品文档客服客服 IMSDKIMSDK 文档（文档（AndroidAndroid）准备工作准备工作将下列 Jar 包导入到项目中的 libs 目录中，若第三方jar 包与原来项目中有重复，保证项目中有一个即可。上图为第三方 jar 包，还需导入 IM 的核心包 kfimsdk.jar初始化初始化 SDKSDK使用如下代码IMChatManager.getInstance().init(context,userName,accessId);其中参数说明：Context context,应用上下文String username,用户名String userId,用户 idString imServ

2、iceNo,服务号String accessId,接入号可编辑userId,imServiceNo,精品文档完成之后会与服务器建立tcp 的连接，设置设置 SDKSDK 初始化的接口监听初始化的接口监听使用如下代码IMChatManager.getInstance().setOnInitListener(new InitListener()Overridepublic void oninitSuccess()LogUtil.d(MobileApplication,sdk初始化成功);Overridepublic void onInitFailed()LogUtil.d(MobileApplic

3、ation,sdk初始化失败););该回调接口只是用来判断 SDK 是否初始化成功了，只有成功了之后才可以使用 IM 相关功能。消息实体消息实体界面显示时会用到消息的一些属性进行不同的显示，下面将消息中的具体属性展示如下：public class FromToMessage /*消息类型：文本可编辑精品文档*/public static final String MSG_TYPE_TEXT=0;/*消息类型：图片*/public static final String MSG_TYPE_IMAGE=1;/*消息类型：语音*/public static final String MSG_TYPE

4、_AUDIO=2;/*消息的 id,数据库中的主键*/public String _id;/*消息从哪里来的*/public String from;/*消息要通知谁*/可编辑精品文档 public String tonotify;/*用来标示对话的两人*/public String sessionId;/*消息的类型*/public String msgType;/*什么时候发的*/public Long when;/*消息文本内容，若是多媒体消息时为URL*/public String message;/*设备信息*/public String deviceInfo;/*可编辑精品文档*未

5、读标记（0 为已读，1 为未读）*/public String unread;/*发送成功的状态(true 说明成功，false 说明失败，sending 说明正在发送中)*/public String sendState;/*多媒体消息本地的文件路径*/public String filePath;/*录音的时间*/public Float recordTime;/*录音的时间，字符串显示*/public String voiceSecond;/*是发送者还是接收者，发送者为0，接收者为 1*/可编辑精品文档 public String userType;/*消息类型*/public Str

6、ing type;public FromToMessage()拼装一条消息拼装一条消息1.文本消息：使用如下代码FromToMessage fromToMessage=IMMessage.createTxtMessage(txt);参数说明：String txt,消息文本内容2.录音消息:使用如下代码FromToMessage fromToMessage=IMMessage.createAudioMessage(mTime,filePath);参数说明：float mTime,录音时长String filePath,录音在本地的路径可编辑精品文档3.图片消息:使用如下代码FromToMessa

7、gefromToMessage=IMMessage.createImageMessage(picFileFullName);参数说明：String picFileFullName,图片在本地的路径拼装好的消息在发送时用到。发送消息发送消息使用如下代码：IMChat.getInstance().sendMessage(fromToMessage,new ChatListener()可编辑Overridepublic void onSuccess()updateMessage();Overridepublic void onFailed()updateMessage();Overridepubli

8、c void onProcess()精品文档);参数说明：FromToMessage fromToMessage,要发送的消息ChatListener,消息发送的接口监听，发送成功，失败或正在发送，该回调接口中可以直接进行界面的操作。上面代码的 updateMessage()方法为更新界面显示的操作，发送的消息存到了本地数据库中，具体可参看提供的demo。重发消息重发消息当有时候发送失败后，需重新发送该条消息，代码如下：IMChat.getInstance().reSendMessage(fromToMessage,new ChatListener();Overridepublic void

9、onProcess()Overridepublic void onFailed()Overridepublic void onSuccess()可编辑精品文档接收新消息接收新消息需 通 过 注 册 广 播 来 获 取 新 消 息，首 先 需 要 一 个 全 局 注 册 的 广 播，在AndroidManifest.xml中代码为：示例代码：public class NewMsgReceiver extends BroadcastReceiverprivate NotificationManager notificationManager;Overridepublic void onReceiv

10、e(Context context,Intent intent)notificationManager=(NotificationManager)context.getSystemService(Context.NOTIFICATION_SERVICE);if(intent.getAction().equals(com.moor.im.NEW_MSG)/看应用是否在前台可编辑精品文档if(isAppForground(context)context.sendBroadcast(newIntent(com.m7.imkfsdk.msgreceiver);else Notification not

11、ification=new Notification();notification.icon=R.drawable.ic_launcher;notification.defaultsNotification.DEFAULT_LIGHTS|Notification.DEFAULT_SOUND;notification.flags|=Notification.FLAG_AUTO_CANCEL;notification.when=System.currentTimeMillis();notification.tickerText=有新消息来了;Intent it=new Intent(context

12、,ChatActivity.class);it.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);it.setAction(Intent.ACTION_MAIN);it.addCategory(Intent.CATEGORY_LAUNCHER);PendingIntentPendingIntent.getActivity(context,1,it,PendingIntent.FLAG_UPDATE_CURRENT);notification.setLatestEventInfo(context,客服消息,新消息,contentIntent);可编辑=content

13、Intent=精品文档notificationManager.notify(1,notification);public boolean isAppForground(Context mContext)ActivityManageram=(ActivityManager)mContext.getSystemService(Context.ACTIVITY_SERVICE);Listam.getRunningTasks(1);if(!tasks.isEmpty()ComponentName topActivity=tasks.get(0).topActivity;if(!topActivity.

14、getPackageName().equals(mContext.getPackageName()return false;return true;这里对应用是否在前台进行了不同处理，如果在前台则发送一个广播通知聊天界面更新界面，若在后台则弹出通知栏通知用户。注意当接收到该广播后，消息已经保存到了本可编辑tasks=精品文档地的数据库中了。具体请查看demo 中详细代码。获取数据库中的消息获取数据库中的消息在界面上显示消息就得先从数据库中获得消息，代码如下：ListfromToMessages=MessageDao.getInstance().getOneMessage(1);参数中的数字为取第几页的数据，用于下拉加载更多消息时使用,默认是一页 15 条消息数据。这样就获取到了数据库中的消息了，之后就可以在界面进行显示操作了。具体参考 demo 中。更新一条消息数据到数据库中更新一条消息数据到数据库中有时候需要将消息的数据修改后保存到数据库中，代码如下：MessageDao.getInstance().updateMsgToDao(message);参数为 FromToMessage message,修改数据后的消息。其他其他本SDK初始化成功之后会自动进行断线重连操作，用户只需关心聊天界面的实现即可。若无特殊要求直接使用提供的demo 中的界面即可。可编辑