注册

实战:快速实现iOS应用中集成即时通讯IM和UI

准备

熟练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整合至项目中。大功告成!



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

0 个评论

要回复文章请先登录注册