Demo（EaseIM App）介绍

更新日期：2022-07-08

环信即时通讯 iOS 端提供示例应用可供体验。为方便体验，建议使用你自己的 Demo 应用，具体步骤如下：

1. 在 环信即时通讯云 IM 管理后台 通过邮箱注册， 可以看到默认的 Demo 应用（默认应用是全功能开通的应用）；

2. 在上图页面 Demo 应用右侧点击 查看，选择 开放注册；

3. 下载 Demo，点击 服务器配置；

4. 将 Demo 的 App Key 填入，点击 保存配置；

5. 杀死 app；

6. 重启，然后点击 注册用户 进行体验。

注意

注册模式分两种，开放注册和授权注册。只有开放注册时，才可以客户端注册。

• 开放注册是为了测试使用，正式环境中不推荐使用该方式注册环信账号；
• 授权注册的流程应该是你的应用服务器通过环信提供的 REST API 注册，之后保存到你的应用服务器或返回给客户端。

您可以通过以下两种方式获取到源代码：

• 下载代码压缩包：IM SDK 及 Demo 下载
• 下载源代码：github 源码地址

欢迎大家提交 PR 改进和修复 EaseIM 和 EaseIMKit 中的问题。

从IM SDK 及 Demo 下载 下载 iOS SDK 压缩包，然后解压。解压后在 EaseIM 文件夹下，即为 EaseIM 的工程目录。

终端 cd 到 EaseIM 的 podfile 目录下，终端执行 pod install 命令，等待下载完所有的 pod 依赖库，即可打开 EaseIM.xcworkspace，运行 EaseIM demo 进行自定义再次开发。

* 环信 SDK pod 'HyphenateChat', '3.8.0'
* 环信 IM UI 库 pod 'EaseIMKit', '3.8.0.1'
* 环信音视频 UI 库 pod 'EaseCallKit', '3.8.0.3'
* 声网音视频 SDK pod 'AgoraRtcEngine_iOS', '3.3.1'

三方库包含

* pod 'MBProgressHUD',
* pod 'Masonry'
* pod 'MJRefresh'
* pod 'SDWebImage'

demo 中有几大 UI 功能模块，在集成时将对应的模块添加到工程中即可。

• Helper——自定义库和页面，第三方库，全局通用模块

• Chat——聊天模块

• Conversation——会话列表模块

• Communicate——实时音视频模块（包含 1v1 实时通话以及多人实时通话的功能

• Contact——好友列表模块

• Group——群组模块

• Chatroom——聊天室模块

在集成时，必须要先向自己的工程中导入 Helper 模块，然后再根据自己的需求导入其他模块。

• EaseIMHelper：环信（EaseIM）全局帮助类，demo 的单例类，主要是全局监听接收消息，好友，群组，聊天室等相关事件的回调，从而进行对应的处理；
• EMConversationsViewController：demo 的会话列表功能页面，展示了扩展条目侧滑事件及条目点击事件实现等；
• EMChatViewController：demo 的聊天功能页面，展示了扩展条目长按事件，预置条目长按菜单及对重写部分长按事件功能，展示了如何重置及添加更多扩展功能，并展示了实现了头像点击事件及正在输入等事件的相应；
• EMContactsViewController：demo 展示的联系人页面，展示了添加条目长按侧滑及实现条目点击事件等；
• EMGroupInfoViewController：实现了如下功能：添加群成员，修改群公告及群介绍，上传共享文件，进行群组管理，设置消息免打扰及解散或者退出群组等。