iOS SDK ReleaseNote

Release Version 5.4.1  更新时间：2017-12-06

SDK：
1.【新增】设置免打扰接口
2.【新增】选取摄像头接口增加scale参数
3.【新增】单应用多证书功能
4.【新增】获取会议列表时、支持分页功能
5.【新增】预览视频流上报
6.【新增】支持HTTP和SOCKS5代理
7.【废弃】群组设置免打扰功能接口
8.【修复】bug fixed
DEMO：
1.【新增】机器人聊天
2.【新增】iOS支持PushKit
3.【新增】文件助手
4.【新增】免打扰功能
5.【新增】预览office文件
6.【新增】添加搜索，全网搜索好友
7.【优化】群组设置、群组成员搜索功能
8.【优化】用户头像显示
9.【优化】好友/群组通知显示
10.【优化】适配iPhone X
11.【修复】bug修复与体验完善

Release Version 5.4.0  更新时间：2017-09-22

SDK：
1.【新增】SDK增加发送原图功能
2.【新增】SDK修复跨应用同步消息状态问题
Demo：
全新的“容联快聊”APPS，全新UI，扁平化风格，完全开源，全面助力开发者接入容联IM。

Release Version 5.3.2  更新时间：2017-07-12

媒体库：
1.【优化】会议中音频混音效果，尤其是在会议中有pstn终端时的混音效果
2.【优化】音频弱网效果，在丢包50%时，仍能正常通话，最高可抗80%丢包
3.【优化】视频弱网效果，在丢包10%时，视频仍可清晰流畅，最高可抗30%丢包
SDK：
1.【新增】聊天室功能模块
2.【新增】视频美颜功能
3.【新增】蓝牙耳机支持
4.【新增】发送消息自定义推送内容apsAlert字段
5.【新增】群成员名片修改增加通知消息体ECModifyGroupMemberMsg
6.【新增】发送文件类型增加字段originFileLength(文件消息体的原文件长度)
7.【新增】新增发送消息类型：消息体ECCmdMessageBody
8.【优化】优化SDK静态库的大小,解决第三方冲突
DEMO：
1.【新增】新增小视频功能
2.【新增】点对点视频通话新增美颜功能
3.【新增】新增直播聊天室功能
4.【新增】扫描二维码加入群组
5.【优化】优化代码结构,调整部分逻辑
6.【修复】修复已知bug

Release Version 5.3.1  

SDK:
1、音频啸叫抑制，优化音视频质量
2、下载返回https地址
3、SDK全面支持APPLE ATS规范
4、修复与H5视频互通问题
5、修复会议中speaklistener字段无值问题
Demo：
1、修复视频会议中，第三方加入视频放大缩小问题
2、修复创建会议时，会议背景音默认问题
3、设置里增加选择摄像头分辨率和音视频编解码开关
4、查询已读未读消息接口修改为https请求
5、Demo全面支持APPLE ATS规范

Release Version 5.3.0

sdk新增功能如下：
1.sdk集成红包和表情初始化,应用无需初始化.
2.查询已读未读消息接口修改,更改为http请求,应用已经封装好,并采用AFNetworking 3.0(用户无需担心ipv6的问题),接口如下:
/**
 查询消息已读状态
 @param type       0 未读 1已读
 @param msgId      消息id
 @param pageSize   每页数量
 @param pageNo     页数
 @param completion block返回值
 */
- (void)queryMessageReadStatus:(NSInteger)type
                         msgId:(NSString*)msgId
                      pageSize:(NSInteger)pageSize
                        pageNo:(NSInteger)pageNo
                    completion:(void (^)(NSString *err,NSArray *array,NSInteger totalSize))completion;
3.采用先进的音频编码算法，提高抗丢包能力，增强音质，在差网络下也能正常沟通.
4.优化视频网络自适应算法，使视频更加流程，适应不同网络环境
demo新增功能：
1.聊天页面支持发送红包和抢红包以及零钱功能。
2.支持发送多样化的表情,以及表情商店下载表情.
3.应用界面适配iPhone设备所有机型.
4.新增意见反馈入口(备注:在设置页面).
5.iOS10权限设置和推送设置已经适配.详见应用info.plist和推送开关设置.
6.应用已经上架AppStore,用户无需担心ipv6的问题,或者想要体验iOS应用,请移步AppStore搜索云通讯im下载体验.

Release Version 5.2.2

sdk新增接口如下：
1.置顶（取消置顶）会话接口
-(void)setSession:(NSString*)seesionId IsTop:(BOOL)isTop completion:(void(^)(ECError *error, NSString *seesionId))completion;
2. 获取置顶会话列表接口
- (void)getTopSessionLists:(void(^)(ECError *error, NSArray *topContactLists))completion;
3.消息撤回（撤回只能是2分钟之内的消息）
-(void)revokeMessage:(ECMessage*)message completion:(void(^)(ECError *error, ECMessage* message)) completion;
4.消息回执（已读）
-(void)readedMessage:(ECMessage*)message completion:(void(^)(ECError *error, ECMessage* message)) completion;
5.查询消息的已读和未读人数（只支持群组，且发送的消息）
-(void)queryMessageReadStatus:(ECMessage*)message  completion:(void(^)(ECError *error, NSArray* readArray, NSArray*  unreadArray)) completion;
6.会议禁言禁听接口（注:管理员才有此权限,不支持实时对讲）
-  (void)setMember:(ECVoIPAccount *)memberVoip  speakListen:(NSInteger)speakListen  ofMeetingType:(ECMeetingType)meetingType  andMeetingNumber:(NSString*)meetingNumber completion:(void(^)(ECError  *error, NSString *meetingNumber))completion;
7.取消发送附件（注：只能是附件消息）
-(ECError*)cancelSendMessage:(ECMessage*)message;
sdk接口功能完善如下：
1.发送附件消息成功后，发送消息增加URL。
2.发送图片和视频消息带上图片的size，接收消息端的图片和视频消息会收到size（方便本地做图片占位显示）
3.消息传参userdata支持json字符串格式（5.2.2版本之后支持）
4.voip设置听筒/扬声器sdk调整，权限交由应用层处理，拨打voip前可以设置听筒/扬声器
demo新增功能如下：
1.联系人可以置顶和取消置顶（置顶会话与普通会话会有颜色区分），具体详见demo处理
2.消息撤回功能增加，两分钟之内消息可以撤回
3.消息已读/未读。群组会显示多少人未读，点击未读跳转页面，此页面显示本条消息目前多少人已读和未读。
4.语音群聊和视频会议增加禁言禁听功能（管理员才有此权限）
SDK需增依赖库：VideoToolbox.framework

Release Version 5.2.1

sdk功能增加：
1.转让群主权限，设置管理员和成员角色权限（注：群主权限最高，管理员次之，成员最低，同级别权限之间不具备操作权限）。接口如下：
-  (void)setGroupMemberRole:(NSString*)groupId member:(NSString*)memberId  role:(ECMemberRole)role completion:(void(^)(ECError *error,NSString  *groupId,NSString *memberId))completion;
2.邀请成员加入音频会议、视频会议增加接口
-  (void)inviteMembersJoinMultiMediaMeeting:(NSString *)meetingNumber  andIsLoandingCall:(BOOL)isLoadingCall andMembers:(NSArray *)members  andDisplayNumber:(NSString*)displaynumber  andSDKUserData:(NSString*)sdkUserData  andServiceUserData:(NSString*)serviceUserData completion:(void  (^)(ECError *error ,NSString * meetingNumber))completion;
3.增加发送链接消息（ECPreviewMessageBody）
4.增加用户发送和接收状态消息（ECUserStateMessageBody）。
5.群组增加@消息。
demo增加功能：
1.消息增加可转发到云通讯平台的用户、群组和讨论组中
2.图片和链接消息可分享到微信
3.增加推送消息自定义铃音，文件名称必须为：pushring.caf

Release Version 5.2.0

1.SDK中对群组公告中的标点符号部分做限制（@"^[\\x00-\\x7F\a-zA-Z\u4e00-\u9fa5。；，：“”（）、？《》]+$"）
2.SDK支持查询单人及多人在线状态。
/**
 @brief 获取多个他人状态
 @param userAccs 用户账号数组
 @param completion 执行结果回调block
 */
-(void)getUsersState:(NSArray *)userAccs completion:(void(^)(ECError* error, NSArray* usersState)) completion;
3.管理员修改用户角色权限
-  (void)setGroupMemberRole:(NSString*)groupId member:(NSString*)memberId  role:(ECMemberRole)role completion:(void(^)(ECError *error,NSString  *groupId,NSString *memberId))completion;
4.IM Demo增加官网下载链接及微信分享（在设置界面的“关于”里面）
5.修改免打扰后没有显示未读条数的问题。
6.解决上传小视频第一帧图片偶尔颠倒的问题
7.解决iPhone6s和iPhone6sp设置免提听不到的问题
8.解决语音群聊管理成员界面踢出异常问题
9.解决查看相册和照相机时接到点对点音视频，没有弹出呼叫界面的问题
10.解决录音时候同时切后台无法录音的问题。

 Release Version 5.2.0r8

设置UIView的属性contentMode：
UIViewContentModeScaleToFill //view默认值，图像数据显示，填充view，但不等比例拉伸
UIViewContentModeScaleAspectFit //图像等比例拉伸，完全显示内容
UIViewContentModeScaleAspectFill //图像等比例拉伸，填充view，部分内容可能不显示
参数rotate 生效
- (NSInteger)selectCamera:(NSInteger)cameraIndex  capability:(NSInteger)capabilityIndex fps:(NSInteger)fps  rotate:(ECRotate)rotate;
/**
 @brief 设置角标数
 @param badgeNumber 角标数字
 @param completion 执行结果回调block
 */
-(void)setAppleBadgeNumber:(NSInteger)badgeNumber completion:(void(^)(ECError* error)) completion;

Release Version 5.2.0r15

解决ipv6-only(添加libresolv.9.tbd动态库)
优化收消息逻辑
bug修复 

Release Version 5.1.9

1.变声。接口如下：
-(void)changeVoiceWithSoundConfig:(ECSountTouchConfig*)dstSoundConfig  completion:(void(^)(ECError *error, ECSountTouchConfig*  dstSoundConfig)) completion;
2.增加本地播放回铃音和忙音接口
- (NSString*)onGetRingBackWavPath:(VoIPCall*)voipCall;
- (NSString*)onGetBusyWavPath:(VoIPCall*)voipCall;
3.增加发送地理位置（ECLocationMessageBody）
4.修改视频会议崩溃的bug。
5.修改devicetoken变化时收不到推送的问题。
6.解决IM专版增加-ObjC的问题（IM专版此后不需要添加）
7.删除不必要文件防止和友盟冲突

Release Version 5.1.8

1） IOS设备离线呼叫。
2） IOS SDK增加回铃音。
3） 修复- (NSInteger)releaseCall:(NSString *)callid andReason:(NSInteger) reason时callid为空时，引起的crash。
4） 修复阅后即焚消息图片可以长按保存的bug。
5） 修复  A用户正在会议通话
         B用户呼叫A，得到反馈“ 等待对方接听”，
         B再次呼叫A，A会收到电话
         A拒绝接听该电话后，A再没有办法退出该 语音会议的bug。
6） 修复登录账号邮箱不可以登录的bug。
7） 修复群组详情界面的修改群公告和群昵称时候能输入特殊符号的bug。

Release Version 5.1.7

1） 阅后即焚。
2） 获取用户在线状态。
3） 创建群组增加省份和城市、类型字段及群组成员列表UI优化。另外对群组名字、群组描述、城市、省份、用户账号的合法性验证。
4）@功能。 Demo仅实现输入@后弹出成员列表，用户选择后返回输入框。
5）demo增加讨论组。
6） 视频缩略图预览。视频文件大小显示。
7） 推送增加文件大小字段。
8）修复demo不允许访问照相机权限时，拨打视频崩溃问题。
9）修复切后台几分钟，再次进入前台重连不上的问题
10）修复点对点视频被叫摄像头无法切换的问题
11）修复点对点视频时，被叫原来使用wifi，在视频过程中关闭wifi使用4g网络，无法重连成功，过一段时间崩溃，在非正常挂断情况下都会崩溃

Release Version 5.1.6

1.编译设置调整
    需要在other link flags 加上-all_load字段 修改为 -ObjC字段
2.增加新的登录环境
     支持沙盒环境登录  
调用登录接口前，调用该接口切换服务器环境；不调用该函数，默认使用的是生产环境；
参数：isSandBox 是否沙河环境
      是否成功 0:成功 非0失败
-(NSInteger)SwitchServerEvn:(BOOL)isSandBox;
3. 新功能------多路视频会议功能接口
New API接口
/**
 @brief 邀请成员加入音频会议、视频会议
 @param meetingNumber 房间号
 @param isLoadingCall 用户登录的是手机号或者VoIP号，YES是VoIP号，NO是手机号
 @param members       加入房间的成员
 @param completion    执行结果回调block
 */
-(void)inviteMembersJoinMultiMediaMeeting:(NSString *)meetingNumber andIsLoandingCall:(BOOL)isLoadingCall andMembers:(NSArray *)members completion:(void(^)(ECError *error ,NSString * meetingNumber))completion;
/**
 @brief 视频会议发布自己的视频
 @param meetingNumber 房间号
 @param completion    执行结果回调block
 */
-(void)publishSelfVideoFrameInVideoMeeting:(NSString *)meetingNumber completion:(void(^)(ECError *error, NSString *meetingNumber))completion;
/**
 @brief 视频会议取消自己的视频
 @param meetingNumber 房间号
 @param completion    执行结果回调block
 */
-(void)cancelPublishSelfVideoFrameInVideoMeeting:(NSString *)meetingNumber completion:(void(^)(ECError *error, NSString *meetingNumber))completion;
/**
 @brief 视频会议请求某一远端视频
 @param username 用户账号
 @param displayView 显示的view
 @param meetingNumber 房间号
 @param meetingPwd 房间密码
 @param port 视频源端口
 @param completion    执行结果回调block
 */
- (void)requestMemberVideoWithAccount:(NSString*)username andDisplayView:(UIView*)displayView andVideoMeeting:(NSString*)meetingNumber andPwd:(NSString*)meetingPwd andPort:(NSInteger)port completion:(void(^)(ECError *error, NSString *meetingNumber,NSString *member))completion;
/**
 @brief 视频会议取消请求某一远端视频
 @param username 用户账号
 @param meetingNumber 房间号
 @param meetingPwd 房间密码
 @param completion    执行结果回调block
 */
- (void)cancelMemberVideoWithAccount:(NSString*)username andVideoMeeting:(NSString*)meetingNumber andPwd:(NSString*)meetingPwd completion:(void(^)(ECError *error, NSString *meetingNumber, NSString *member))completion;
/**
 @brief 设置会议地址
 @param addr 视频会议源地址
 @return 0:成功 非0失败
 */
- (NSInteger)setVideoConferenceAddr:(NSString*)addr;
/**
 @brief 有会议呼叫邀请
 @param callid      会话id
 @param calltype    呼叫类型
 @param meetingData 会议的数据
 */
- (NSString*)onMeetingCallReceived:(NSString*)callid withCallType:(CallType)calltype withMeetingData:(NSDictionary*)meetingData;
/**
 @brief 多路视频通知消息
 @param msg 多路视频消息
 */
-(void)onReceiveMultiVideoMeetingMsg:(ECMultiVideoMeetingMsg *)msg;
改变（change API）的接口
/**
 @brief 邀请成员加入音频会议
 @param meetingNumber 房间号
 @param isLoadingCall 用户登录的是手机号或者VoIP号，YES是VoIP号，NO是手机号
 @param members       加入房间的成员
 @param completion    执行结果回调block
 */
-(void)inviteMembersJoinToVoiceMeeting:(NSString *)meetingNumber andIsLoandingCall:(BOOL)isLoadingCall andMembers:(NSArray *)members completion:(void(^)(ECError  *error ,NSString * meetingNumber))completion EC_DEPRECATED_IOS(5.1.4,  5.1.5, "Use -  inviteMembersJoinMultiMediaMeeting:andIsLoandingCall:andMembers:completion:");