帮助与文档

> >

一、到Mob官网申请MobIM所需的APPKey

 

1.打开Mob官网,在官网首页选择登录或注册,新用户先注册,老用户直接登录。

mob

注册页面如下图:

mob_reg

 

2.注册或登录完成后,会返回至首页,点击右上角的“进入后台”,会跳转至管理后台,点击左上方添加应用。如下图:

Snip20171219_13

输入应用名称后点击“保存”,如下图:

Snip20171219_14

应用创建后在左边导航栏点击“添加产品”,如下图:

Snip20171219_15

在弹出的窗口中点击“确定添加”,如下图:

Snip20171219_16

 

此时左边导航栏就能看到您添加的产品了,点击“概况”即可看到您接下来需要的AppKey和AppSecret了,如下图:

Snip20171219_17

 

二、下载客户端SDK

 

请从官网下载客户端SDK,解压后可得到如下文件夹目录:

Snip20171211_10

说明:

  • Sample文件夹里存放MobIMDemo – MobIM的演示demo(供使用参考)
  • SDK文件夹下的MobIM文件夹里存放MobIM.framework和MobIM.bundle – 核心功能库(必要)
  • SDK文件夹下的Required文件夹里存放MOBFoundation.framework和MOBFoundationEx.framework – 基础功能框架(必要)

三、快速集成SDK

一、iOS 项目配置

1.在项目中添加SDK

i.将MobIM.framework,MobIM.bundle,MOBFoundation.framework,MOBFoundationEx.framework添加到项目中,如下图:

802B55CA-DDD0-41AF-ACE2-3E4E6B363DF2

ii. 选择将文件夹复制到项目中,如下图:

Snip20170525_4

iii. 添加依赖库

Snip20170525_7

选择项目Target – Build Phases – Link Binary With Libraries,然后选择“+”进行添加系统库:

  • libsqlite3
  • libz1.2.5
  • libstdc++6.0.9
  • JavaScriptCore.framework

2.在Info.plist文件中右键空白处,选择“Add Row”,添加“MOBAppKey”和“MOBAppSecret”对应值为上述在管理后台中获得的AppKey和AppSecret(点击“显示App Secret”查看),如下图所示:Snip20170526_12

无需代码即可完成MobIM的初始化工作。

二、基础功能接入

1.用户系统映射代码

用户有自己的用户系统时,需要在登录后,与MOBFUser进行关系映射,示例代码如下:

先引入头文件

2.请求会话列表

用户在搭建好自己的“会话”界面UI后,一般情况下需要先请求一次历史会话记录,示例代码如下:

先引入头文件

 

注意:以上方法一般仅在应用首次启动的时候调用,调用后会话记录会被MobIM自动缓存,下次启动时只需要从本地读取即可。

本地读取会话列表示例代码如下:

 

会话列表读取并展示完毕后即需要监听会话列表的变更,此监听主要是为了及时收到与会话列表相关的变化,从而及时刷新会话列表界面相关数据展示,示例代码如下:

3.消息发送

(1).发送文本消息代码

先引入头文件

(2).发送图片消息代码

先引入头文件

(3).发送语音消息代码

先引入头文件

(4).发送视频消息代码

先引入头文件

(5).发送文件消息代码

4.消息接收

MobIM中设计的回调基本采用block形式处理,接收消息也是同样的方式,接收消息示例代码如下:

先引入头文件

设置了消息接收的监听后,如果不是要作为全局监听来使用的,那么就一定要在不需要的时候移除相应的监听,移除监听代码示例如下:

三、群组功能接入

1. 创建群组

声明:所有群组相关的操作都由MobIM内部维护,用户无需关心群组id等相关内容从何而来,只需要使用自己的用户系统接入对应群组即可。

创建群组示例代码如下:

先引入头文件

注意:调用该方法创建群组成功后同时会收到创建群组成功的消息推送,此消息的目的是为了告知创建群组是添加的群成员,以便即使刷新会话列表。

2. 查找群组

根据群组id查找某个群组,用于某用户想要主动加入某个群组时可通过该群组的id搜索到该群组后加入。

3. 群组消息发送、接收

群组消息的发送与接收和单聊步骤基本一致,只是构建消息对象是 “to” 传的是群组id,而不再是个人用户id。详细情况请参考前面的 “消息发送” ,此处不再赘述。

相关文档