iOS SDK 更新日志

新功能：

• 为满足不同场景需求，3.5.0版本开始将实时音视频会议划分了不同的类型，不同类型对应了不同场景，使你能够轻松地将实时音视频功能集成到你的应用或者网站中。在创建会议时可以传入以下几种类型：

   1. Communication：普通通信会议，最多支持参会者6人，会议里的每个参会者都可以自由说话和发布视频，该会议类型在服务器不做语音的再编码，音质最好，适用于远程医疗，在线客服等场景；
   2. Large Communication：大型通信会议，最多参会者30人，会议里的每个参会者都可以自由说话，最多支持6个人发布视频，该会议模式在服务器做混音处理，支持更多的人说话，适用于大型会议等场景；
   3. Live：互动视频会议，会议里支持最多6个主播和600个观众，观众可以通过连麦与主播互动，该会议类型适用于在线教育，互动直播等场景。

优化：

• 优化实时音视频多人会议功能

新功能：

• 增加'只投递在线用户'消息属性，以节约消息量，目前只支持CMD类型消息。通过EMCmdMessageBody.isDeliverOnlineOnly=YES接口设置该属性

新功能：

• 通过消息邀请参加其他人参加多人实时音视频会议

修复：

• 1v1视频通话，iOS端接收视频后，偶尔会不显示视频画面

请注意：为提供高质量且一致的音视频体验，从3.4.1版本开始，1v1 通话不再与3.1.5及以前版本兼容，请及时升级。

优化:

• 优化WiFi切4G时与服务器重连速度
• 优化实时1对1通话

新功能：

• 新增音视频弱网检测回调
• 新增加群时填写验证消息
• 新增聊天室断线时被踢出聊天室回调

请注意：为提供高质量且一致的音视频体验，从3.4.1版本开始，1v1 通话不再与3.1.5及以前版本兼容，请及时升级。

新功能：

• 实现不同模式的实时语音会议功能 多人音视频会议
• 添加动态更换对方实时视频显示页面的功能[IEMConferenceManager updateConference:streamId:remoteVideoView:completion:]

新功能：

• Demo层实现群组消息已读功能（发送方在EMMessage.ext中自定义字段用以表示是否需要已读回执，接收方用CMD消息实现已读回执）

• SDK新增自定义实时视频传输数据接口（注意1：进行1v1自定义视频之前，必须设置EMCallOptions.enableCustomizeVideoData为YES，在进行默认1v1视频之前，必须确认EMCallOptions.enableCustomizeVideoData=NO；注意2：自定义视频必须设置EMCallSession.localVideoView.previewDirectly = NO; 注意3：Demo中相关代码前都添加了“3.3.9 new 自定义视频数据”）

功能更新：

• 精简Demo的功能，移除Demo中的红包功能，UI上体现在聊天页面底部“更多”去掉了红包相关的操作
• 去掉Demo中的crash收集工具，替换成了Bugly.framework，存放在ChatDemo-UI3.0/3rdparty
• 优化重连逻辑,解决用户迁移和服务器受攻击后部分用户连接服务超时的问题;

新功能：

• 服务诊断接口， demo UI体现在“setting-debug-服务器诊断”

• 设置音频码率, 接口[EMCallOptions maxAudioKbps]

• 添加新的错误码（达到服务器上限），体现在创建用户，创建群组，创建聊天室

功能更新：

• [EMClient isLoggedIn]语义有所改变，原意是是否已经完成登录操作，现在的意思是是否成功登录过

新功能:

• demo支持iPhoneX

功能修复:

• 消息时间戳相同时导致消息不能正确加载；
• 离线消息在某些情况下会导致cmd与普通消息顺序不一致。

新功能:

• 多人音视频功能
• 增加“是否自己实现消息附件上传下载”设置项 [EMOptions isAutoTransferMessageAttachments]
• 增加“是否自动下载图片和视频缩略图及语音消息”设置项 [EMOptions isAutoDownloadThumbnail]

功能修复:

• 1v1实时音视频，接通后，一方静音后，另一方再触发静音操作不起作用；
• 使用SDK下载接口，如果本地已经有同名文件，新的文件名会在原有文件名后边追加数字；
• 断网情况下，自动登录无法获取会话
• 使用SDK上传接口，进度回调第一次会返回100%

新功能:

• 增加了传输安全性
• 增加广告插件，可以收集用户信息

优化:

• 私有部署设置dns的接口
• 优化私有部署重连逻辑
• 限制用户名长度为255
• 需要服务器开通的功能接口返回SERVICE_NOT_ENABLED(505)
• 添加i386库解决模拟器profile时的编译问题

功能修复:

• 修复4G与wifi切换时偶然出现发送消息失败的bug

功能修复:

• 修复在用户名有下划线时发送消息失败的bug；

新功能:

• 新增：PC端和手机端登录同一个账号，两个设备之间互发消息；
• 新增：消息漫游，从服务器分页获取历史消息；
• 新增：消息撤回(增值功能)。

功能修复及优化：

• 优化删除一组会话时，回调只返回一次；
• iOS SDK不再支持i386；
• 修复录制音频文件时，音频权限判断。

新功能:

• 新增：支持在多个设备登录同一个账号，多个设备间可以同步消息，好友及群组的操作(多设备登录属于增值服务，需要联系商务开通)；
• 新增：群共享文件的大小属性；
• 新增：获取同一账号登录的设备列表的接口，并可以选择踢掉某个设备上的登录；

问题修复：

• 移除传输附件大小10M以内的限制；
• 修复邀请群成员时没有附带信息的bug；
• 修复群组操作时必须获取所有已加入群组的问题；
• 修复下载附件路径不存在或者打开错误时仍然下载成功的bug；
• 修复切换账号时某些场景下崩溃的bug；
• 修复获取群成员时最后一页cursor未更新的问题；
• 修复调用异步删除好友接口，参数传“YES”不能删除会话。

新功能：

• 新增：修改获取群公告，上传下载删除群共享文件，修改群扩展信息接口（接口详情请查看文档群组管理）
• 新增：修改获取聊天室公告（接口详情请查看文档聊天室管理）
• 新增：批量设置群组免打扰接口

修复:

• 修复有时调用getAllConversations时返回为空的bug
• 修复获取已加入群组超时的bug

新功能：

• 新增：使用token登录
• 新增：群组群成员进出群组回调

优化:

• 红包改用cocoapods方式集成，支持支付宝和京东支付

修复:

• insertMessage小概率下会崩溃
• [EMMessage setTo:]赋值错误
• 聊天室获取详情接口[IEMChatroomManager fetchChatroomInfo:includeMembersList:error:]第2个参数传入YES时不能获取成员
• 2.x和3.x互通情况下，群组和聊天室的memberlist中出现admin和owner
• 发送消息成功后,对应的EMConversation没有更新最后一条消息

新功能：

• 新增：群组改造,增加一系列新接口，具体查看iOS 3.3.0 api修改
• 新增：获取SDK日志路径接口，将日志文件压缩成.gz文件，返回gz文件路径，[EMClient getLogFilesPath:]
• 更新：使用视频通话录制功能时，必须在开始通话之前调用[EMVideoRecorderPlugin initGlobalConfig]

优化:

• 优化DNS劫持时的处理
• 切换网络时，减小消息重发的等待时间

修复:

• 音视频通话丢包率（以前返回的是丢包数）
• IOS动态库用H264编码在iPhone6s上崩溃
• 实时音视频新旧版互通崩溃

新功能/优化：

• 新增：实时1v1音视频，设置了对方不在线发送离线推送的前提下，当对方不在线时返回回调，以便于用户自定义离线消息推送
• 更新：SDK支持bitcode
• 更新：SDK使用动态库(为了方便集成开发,sdk支持i386,x86_64,armv7,arm64，当使用动态库上传appstore时，需要删除i386,x86_64)，动态库集成方式
• 为了使SDK更简洁易用,过时的API会在后续3~5个版本进行删除

红包相关:
新增:

• 小额随机红包
• 商户后台增加修改密码功能

优化:

• 绑卡后的用户验证四要素改为验证二要素
• iOS和Android两端UI展示一致性
• 支付流程的优化
• SDK注册流程
• 去掉XIB
• 集成过程的参数检查
• 风险策略

修复:

• SDKToken注册失败的问题
• 发红包缺少参数的问题
• 修复Emoji表情显示乱码
• 修复支付密码可能误报出错
• 修复商户自主配置红包最低限额错误
• 修复零钱明细显示顺序错误问题
• 修改抢红包流程为依赖后端数据
• 修复支行信息返回为空时的文案

新功能/优化：

• 修复3.2.2版本设置只使用https，某些情况下无法返回数据的问题

新功能/优化：

• SDK满足apple ATS的要求(EMOptions添加usingHttpsOnly参数,默认使用YES)
• 删除好友逻辑的修改(增加是否删除会话选项)
• 修复呼叫时对方不在线，不能正确显示通话结束原因的问题
• 音视频EMCallOptions中添加了新接口,增加是否固定分辨率,最大视频帧率,最小视频码率接口.详情参考 API Doc
• 音视频EMCallOptions中接口改动 videoKbps → maxVideoKbps

新功能/优化：

• 聊天室列表支持分页获取
• EMOption中usingHttps默认为YES

bug fix:

• 修复Lite版本SDK编译warning的问题

音视频包含大量升级改进，细节请参考集成文档

• 增强的自适应视频质量算法，根据网络环境动态调整清晰度；
• 优化了语音算法，通话更清晰；
• 支持高清视频，画质更细腻；
• 支持横屏和竖屏自由转换；
• 支持画面fit和fill模式；

红包功能改进：

• 增加个人间转账功能
• 增加拆红包音效

其他改进：

• iOS10进行适配
• cmd消息增加“em_” 和 “easemob::” 开头的action为内部保留字段；
• Fix 个别情况下会话未读消息数显示不准确的bug；
• Fix 个别情况下获取联系人不正确的bug；
• Fix 登录户马上加入聊天室某些情况下会失败的bug；
• 发送语音或者视频时，如果文件内容过小会给出提示；
• 优化读取数据库的性能；

新功能：

1. 提高SDK稳定性
2. 去除依赖库(libcrypto.a,libcurl.a,libssl.a)
3. 提高从2.x版本SDK数据库迁移效率
4. 进一步修改api命名的规范性，建议使用新的api,具体详情可以参考接口文档

bug fix:

1. 修改实时视频显示问题

新功能：

1. 聊天室增加可以获取成员和成员数的接口
2. 会话增加接口- (BOOL)appendMessage:(EMMessage *)aMessage
3. 提高SDK稳定性
4. 支持群消息@功能（在EaseUI和Demo中实现）

• 支持@all， “ext”:{“em_at_list”:“ALL”}支持
• @单个或多个成员， “ext”:{“em_at_list”:[“username1”,“username2”]}
• 如果用户设置了推送显示消息详情，被@的用户会收到推送 “XXX在群中@了我”

红包相关:

1. 支持群内的专属红包，只有指定用户才能抢红包；
2. 支持支付宝；
3. 支持系统发的群红包，用户只能看到自己的领取情况；
4. 支持绑定多张银行卡，支持解绑银行卡；
5. 零钱页支持充值；
6. 改版零钱页；
7. 支持上传身份证照片做第三通道验证；
8. 红包UI细节打磨，包括双title和各个页面细节，安卓和iOS文案统一；
9. 错误信息梳理，关键错误基于对话框引导；
10. 服务端性能数倍的提升；
11. 红包数据平台完善统计项；
12. 其他优化：优化代码结构，剥离第三方库减少和开发者库的冲突；透传消息仅给发红包用户而非群内全部用户；优化token获取和更新机制；修复若干bug。

新功能：

1. SDK增加实时视频通话切换摄像头功能。
2. SDK支持ipv6。
3. 消息支持按照本地时间或者服务器时间排序。
4. Demo支持单聊发送红包和群聊发送红包。

bug fix:

1. 修复自动同意好友请求有延迟的问题。

SDK细节调整:

1. SDK将第三方依赖从SDK静态库分离出来(libssl.a,libcrypto.a,libcurl.a)

新功能：

1. 增加消息搜索功能，可以根据消息类型或者关键字搜索。
2. API 修改，加载消息方法增加方向参数。
3. 优化绑定 deviceToken 逻辑。

bug fix:

1. Fix 修复发送系统表情时对方接到为乱码或空白的问题。

新功能：

1. 音视频增加弱网/断网检测功能。
2. 音视频增加音频、视频流暂停、恢复功能。
3. 音视频增加录制功能。
4. 发送图片默认压缩图片，节约流量。

bug fix:

1. Fix iOS demo 退到后台后某些情况下 crash 的 bug。

新功能：

1. 增加了音视频功能，用户可以建立一对一的音频通话，视频通话。

bug fix:

1. 修复了扩展字段解析的问题。
2. 修复了用户 ID 中有下划线时，会话中 ID 显示不完整的问题。

bug fix:

1. 修复部分设备在网络异常时启动 APP crash 的问题。
2. 修复有时绑定 deviceToken 失败问题。
3. 修复设置群组最大人数问题。
4. 修复Demo添加好友黑名单 crash 的问题。

1. 全新的通信协议：全新的基于消息同步的私有协议，在不稳定网络环境下更稳定更省流量，确保消息投递的可靠、顺序以及实时性，并具有更高的安全性。同时提供了更好的扩展性，将支持更多的对接和设备同步场景。
2. 全新的 SDK：全面重构，将核心通信模块做了更好的封装；简化了接口，结构更清晰，集成更容易；提升了登录速度和弱网络环境下的可靠性编辑。