准备

熟练objective-c语言

有一台mac电脑,并安装了xcode 和 cocoapods


目标

手把手教大家在iOS应用中集成即时通讯IM 功能

内容篇幅较长,需要内心平和耐心看下去,务必戒躁.阅读本文并按照本文进行对接预计时长2小时



注册Appkey和username

本教程以集成环信IM为例

注册环信账号并登录到console后台:

https://console.easemob.com/user/register


第一步 点击添加应用:




第二步 创建应用


示例:



第三步,找到刚创建的appkey,并点击查看详情




第四步 创建两个user,并相互加好友








加好友:






至此,在console部分操作完成,并得到了一个appkey和两个user

appkey:1168171101115760#abc ,

username1: user1 ,

password1:1 ,

username2: user2 ,

password2: 1




创建一个简单项目simple,整合IM和UI

创建一个简单项目






工程创建成功之后,使用cocoapods进行环信IM集成

示例:







最终效果




第一部分 环信UI库集成方式


环信官方提供了UI库

那么我们有几种方式进行集成呢?


1.利用pod远端拉取集成

2.利用pod集成本地库

3.直接拖入项目



实际上这套UI库并不是最理想的UI库,因为在真正做项目的过程中,我们需要进行大量的改造,以达到符合产品设计的样式.所以这里推荐第二种方式和第三种方式.



第一种方式

参考:https://www.imgeek.net/video/76


第二种方式

参考:https://www.imgeek.org/video/91



我们将会在这里演示第三种方式



第二部分 集成前需要了解

问:集成UI库是否可以直接使用?

答:这里需要注意,实际上UI库仅仅提供了UI功能,并没有提供逻辑部分,所以无法直接拿来使用.



问:那我应该怎么使用?关于逻辑部分在哪里?还需要我自己进行实现吗?

答:不需要,我们可以从官方demo中取出我们需要的UI部分.



问:那么我需要以最快速度集成UI,都需要做什么工作?

答:

1.下载demo<https://www.easemob.com/download/im> 

跑通demo<https://www.imgeek.net/video/76>

2.根据产品设计的情况,从第一部分提到的三种方式中选择合适的集成方式.

3.从demo中取出相关界面逻辑并放入在自己的项目中.



第三部分 上手干

这里将会演示第三种集成方式


1.首先我们已经跑通了demo,所以我们当前demo的路径如下:





其中:

EaseIM是可运行的项目

EaseUI是官方提供的UI库



2.首先将UI部分拖入项目





把其中多出的plist删除

在podfile中加入


pod 'EMVoiceConvert', '0.1.0'


效果如下:





此时UI部分集成完成.



下一步集成逻辑部分,需要从Demo中提取




创建pch文件(如果项目中有则不用创建)


并在podfile中加入




创建pch文件(如果项目中有则不用创建)








最后配置项目权限(这里没有进行配置推送)







到这里,我们完成了将IM整合进项目中。



完善代码及IM的UI使用方式


第一步,我们在项目中创建一个负责做配置项的helper 和一个音视频做回调处理的类

类名分别为


EMAppConfig如下所示




EMAppCallHelper如下所示




第二步 在appdelegate中完善





宏定义appkey(定义已经存在,需要修改定义的值)




(另,声网id添加或修改位置在这里)







使用示例如下





实现收发消息

第一部分 参考现有Demo写法


1.发消息的逻辑参考




2.收消息的回调




第二部分,主动实现


如何主动发消息(这里发消息是直接调用SDK发消息)


//构建一个消息体
    EMTextMessageBody *body = [[EMTextMessageBody alloc] initWithText:@"你好,环信"];
    
    //构建一条消息
    EMChatMessage *message = [[EMChatMessage alloc] initWithConversationID:"user2" body:body ext:@{}];
    
    //设置消息的聊天类型为单聊消息
    message.chatType = EMChatTypeChat;
    
    //将消息发送出去
    [EMClient.sharedClient.chatManager sendMessage:message progress:^(int progress) {
    } completion:^(EMChatMessage * _Nullable message, EMError * _Nullable error) {
        if(error){
            NSLog(@"发送失败(%d):%@",error.code,error.errorDescription);
        }else{
            NSLog(@"发送成功");
        }
    }];



如何收到消息






另:代理可以添加多份,不过如果在不需要代理的情况下一定要移除,否则会被强引用,无法释放



至此，我们已将IM和UI整合至项目中。大功告成！




阅读推荐：深度改造聊天界面的cell：https://www.imgeek.org/video/121