开源即时通讯IM框架MobileIMSDK的Uniapp端开发快速入门( 三 ) _IM框架

18）IMSDK.callback_onIMShowAlert(alertContent)：

用途：由开发者设置的回调方法：框架层的一些提示信息显示回调（本回调并非MobileIMSDK-Uniapp端核心逻辑，开发者可以不需要实现！）。
说明：开发者不设置的情况下，框架默认将调用wx.showModal()显示提示信息，否则将使用开发者设置的回调——目的主要是给开发者自定义这种信息的UI显示，提升UI体验，别无它用】。
参数1：{String}：必填项，文本类型，表示提示内容。

19）IMSDK.callback_onIMKickout(kickoutInfo)：

用途：由开发者设置的回调方法：收到服务端的“踢出”指令（本回调并非MobileIMSDK-Uniapp端核心逻辑，开发者可以不需要实现！）。
参数1 ：{PKickoutInfo}：非空，详见：PKickoutInfo

20）IMSDK.callback_onMessagesLost(lostMessages)：

用途：由开发者设置的回调方法：消息未送达的回调事件通知。
发生场景：比如用户刚发完消息但网络已经断掉了的情况下，表现形式如：就像手机qq或微信一样消息气泡边上会出现红色图标以示没有发送成功）。
建议用途：应用层可通过回调中的指纹特征码找到原消息并可以UI上将其标记为“发送失败”以便即时告之用户。
参数1：{Array<rotocal>}：由框架的QoS算法判定出来的未送达消息列表。

21）IMSDK.callback_onMessagesBeReceived(theFingerPrint)：

用途：由开发者设置的回调方法：消息已被对方收到的回调事件通知。
说明：目前，判定消息被对方收到是有两种可能：
1) 对方确实是在线并且实时收到了；
2) 对方不在线或者服务端转发过程中出错了，由服务端进行离线存储成功后的反馈（此种情况严格来讲不能算是“已被收到”，但对于应用层来说，离线存储了的消息原则上就是已送达了的消息：因为用户下次登陆时肯定能通过HTTP协议取到）。
建议用途：应用层可通过回调中的指纹特征码找到原消息并可以UI上将其标记为“发送成功”以便即时告之用户。
参数1：{String}：已被收到的消息的指纹特征码（唯一ID），应用层可据此ID找到原先已发的消息并可在UI是将其标记为”已送达“或”已读“以便提升用户体验。

五、如何接入SDK5.1如何引入SDK到您的Uniapp工程中？
很简单：只需要将第2节中提到的SDK所有JS文件复制到您的Uniapp工程下即可。
以下是SDK全部文件在工程中的路径和位置（以自带的Demo工程为例，如下图所示）：

文章插图
5.2如何在代码中调用SDK？
第一步：引用SDK的接口主文件（具体例子详见Demo中的im-manager.js文件）

文章插图

第二步：为SDK设置回调各种函数（具体例子详见Demo中的im-manager.js文件）

文章插图
第三步：初始化SDK（具体例子详见Demo中的main.js文件）

文章插图
注意：上图中登录连接的IP地址请设置为您的MobileIMSDK服务器地址哦。
第四步：在你的主界面或登陆界面中调用IM的登陆方法即可（具体例子详见Demo中的主界面index.vue文件）

文章插图
六、Demo运行效果和功能说明

文章插图
▲ 上图是以IOS真机为例的运行截图（其它设备运行效果请见本文档后面的章节）
七、Demo运行方法（运行到浏览器中）7.1重要说明
特别说明：MobileIMSDK的Uniapp端工程（包括Demo代码），不依赖任何第3方库，也不存在任何Native代码混编，完全使用Uniapp官方标准API实现，所以你在拿到MobileIMSDK的Uniapp端工程后直接开箱即可运行，切莫搞复杂、不要私自加戏！
7.2配置要连接的MobileIMSDK服务器IP
注意：下图中登陆连接的IP地址请设置为您自已的MobileIMSDK服务器地址哦。
友情提示： MobileIMSDK的服务端该怎么部署就不是本手册要讨论的内容了，你可以参见《即时通讯框架MobileIMSDK的Demo使用帮助：Server端》。