sdk upgrade

@@ -9,7 +9,6 @@
 #ifndef IMGroupExt_h
 #ifndef IMGroupExt_h
 #define IMGroupExt_h
 #define IMGroupExt_h
 
 
-#import "ImSDK.h"
 #import "TIMComm+Group.h"
 #import "TIMComm+Group.h"
 #import "TIMGroupManager+Ext.h"
 #import "TIMGroupManager+Ext.h"
 
 

@@ -9,7 +9,6 @@
 #ifndef ImSDK_h
 #ifndef ImSDK_h
 #define ImSDK_h
 #define ImSDK_h
 
 
-#import "ImSDK.h"
 #import "TIMConversation+MsgExt.h"
 #import "TIMConversation+MsgExt.h"
 #import "TIMMessage+MsgExt.h"
 #import "TIMMessage+MsgExt.h"
 #import "TIMComm+MsgExt.h"
 #import "TIMComm+MsgExt.h"

-//
-//  IMSdkComm.h
-//  ImSDK
-//
-//  Created by bodeng on 10/12/14.
-//  Copyright (c) 2014 tencent. All rights reserved.
-//
-
-#ifndef ImSDK_IMSdkComm_h
-#define ImSDK_IMSdkComm_h
-
-@interface OMErrResp : NSObject
-{
-    NSString*   cmd;                // 返回的命令字
-    int         seq;                // 请求包的seq
-    NSString*   uin;                // uin
-    int         errCode;          // 错误码
-    NSString*   errTips;            // error tips
-}
-
-@property(nonatomic,strong) NSString* cmd;
-@property(nonatomic,strong) NSString* uin;
-@property(nonatomic,assign) int seq;
-@property(nonatomic,assign) int errCode;
-@property(nonatomic,strong) NSString* errTips;
-
-@end
-
-
-/// 业务相关回调
-
-/**
- *  userid和tinyid 转换回包
- *  userList 存储IMUserId结构
- */
-@interface OMUserIdResp : NSObject{
-    NSArray*   userList;         // 用户的登录的open id
-}
-
-
-@property(nonatomic,strong) NSArray* userList;
-
-@end
-
-/**
- *  userid转换tinyid回调
- *
- *  @param resp 回包结构
- *
- *  @return 0 处理成功
- */
-typedef int (^OMUserIdSucc)(OMUserIdResp *resp);
-
-//请求回调
-typedef int (^OMErr)(OMErrResp *resp);
-
-
-/**
- *  音视频回调
- */
-@interface OMCommandResp : NSObject{
-    NSData*   rspbody;
-}
-
-
-@property(nonatomic,strong) NSData* rspbody;
-
-@end
-
-// relay 回调
-typedef int (^OMCommandSucc)(OMCommandResp *resp);
-
-// request 回调
-typedef void (^OMRequestSucc)(NSData * data);
-typedef void (^OMRequsetFail)(int code, NSString* msg);
-
-/**
- *  UserId 结构，表示一个用户的账号信息
- */
-@interface IMUserId : NSObject{
-    NSString*       uidtype;            // uid 类型
-    unsigned int    userappid;
-    NSString*       userid;             // 用户id
-    unsigned long long   tinyid;
-    unsigned long long   uin;
-}
-
-@property(nonatomic,strong) NSString* uidtype;
-@property(nonatomic,assign) unsigned int userappid;
-@property(nonatomic,strong) NSString* userid;
-@property(nonatomic,assign) unsigned long long tinyid;
-@property(nonatomic,assign) unsigned long long uin;
-
-@end
-
-/**
- *  一般多人音视频操作成功回调
- */
-typedef void (^OMMultiSucc)();
-
-/**
- *  一般多人音视频操作失败回调
- *
- *  @param code     错误码
- *  @param err      错误描述
- */
-typedef void (^OMMultiFail)(int code, NSString * err);
-
-#endif

@@ -15,8 +15,9 @@
 #import "TIMConversation.h"
 #import "TIMConversation.h"
 #import "TIMGroupManager.h"
 #import "TIMGroupManager.h"
 #import "TIMCallback.h"
 #import "TIMCallback.h"
-//#import "TIMFriendshipManager.h"
-
-//#import "IMSdkInt.h"
+#import "TIMFriendshipManager.h"
+#import "TIMErrorCode.h"
+#import "IMGroupExt.h"
+#import "IMMessageExt.h"
 
 
 #endif
 #endif

@@ -14,6 +14,8 @@
 @class TIMMessage;
 @class TIMMessage;
 @class TIMGroupTipsElem;
 @class TIMGroupTipsElem;
 @class TIMGroupInfo;
 @class TIMGroupInfo;
+@class TIMSNSChangeInfo;
+@class TIMFriendPendencyInfo;
 
 
 /**
 /**
  *  连接通知回调
  *  连接通知回调
@@ -35,7 +37,7 @@
 - (void)onConnFailed:(int)code err:(NSString*)err;
 - (void)onConnFailed:(int)code err:(NSString*)err;
 
 
 /**
 /**
- *  网络连接断开（断线只是通知用户，不需要重新登陆，重连以后会自动上线）
+ *  网络连接断开（断线只是通知用户，不需要重新登录，重连以后会自动上线）
  *
  *
  *  @param code 错误码
  *  @param code 错误码
  *  @param err  错误描述
  *  @param err  错误描述
@@ -83,11 +85,12 @@
 - (void)onRefresh;
 - (void)onRefresh;
 
 
 /**
 /**
- *  刷新部分会话（包括多终端已读上报同步）
+ *  刷新部分会话
  *
  *
  *  @param conversations 会话（TIMConversation*）列表
  *  @param conversations 会话（TIMConversation*）列表
  */
  */
-- (void)onRefreshConversations:(NSArray*)conversations;
+- (void)onRefreshConversations:(NSArray<TIMConversation *>*)conversations;
+
 @end
 @end
 
 
 /**
 /**
@@ -139,7 +142,7 @@
 @end
 @end
 
 
 /**
 /**
- *  图片上传进度回调
+ *  上传进度回调
  */
  */
 @protocol TIMUploadProgressListener <NSObject>
 @protocol TIMUploadProgressListener <NSObject>
 @optional
 @optional
@@ -167,90 +170,40 @@
 - (void)onGroupTipsEvent:(TIMGroupTipsElem*)elem;
 - (void)onGroupTipsEvent:(TIMGroupTipsElem*)elem;
 @end
 @end
 
 
-///**
-// *  好友代理事件回调
-// */
-//@protocol TIMFriendshipListener <NSObject>
-//@optional
-//
-///**
-// *  添加好友通知
-// *
-// *  @param users 好友列表（TIMUserProfile*）
-// */
-//- (void)onAddFriends:(NSArray*)users;
-//
-///**
-// *  删除好友通知
-// *
-// *  @param identifiers 用户id列表（NSString*）
-// */
-//- (void)onDelFriends:(NSArray*)identifiers;
-//
-///**
-// *  好友资料更新通知
-// *
-// *  @param profiles 资料列表（TIMUserProfile*）
-// */
-//- (void)onFriendProfileUpdate:(NSArray*)profiles;
-//
-///**
-// *  好友申请通知
-// *
-// *  @param reqs 好友申请者id列表（TIMSNSChangeInfo*）
-// */
-//- (void)onAddFriendReqs:(NSArray*)reqs;
-//
-//@end
+/**
+ *  好友代理事件回调
+ */
+@protocol TIMFriendshipListener <NSObject>
+@optional
 
 
-//@protocol TIMGroupListener <NSObject>
-//@optional
-//
-///**
-// *  有新用户加入群时的通知回调
-// *
-// *  @param groupId     群ID
-// *  @param membersInfo 加群用户的群资料（TIMGroupMemberInfo*）列表
-// */
-//- (void)onMemberJoin:(NSString*)groupId membersInfo:(NSArray*)membersInfo;
-//
-///**
-// *  有群成员退群时的通知回调
-// *
-// *  @param groupId 群ID
-// *  @param members 退群成员的identifier（NSString*）列表
-// */
-//- (void)onMemberQuit:(NSString*)groupId members:(NSArray*)members;
-//
-///**
-// *  群成员信息更新的通知回调
-// *
-// *  @param groupId     群ID
-// *  @param membersInfo 更新后的群成员资料（TIMGroupMemberInfo*）列表
-// */
-//- (void)onMemberUpdate:(NSString*)groupId membersInfo:(NSArray*)membersInfo;
-//
-///**
-// *  加入群的通知回调
-// *
-// *  @param groupInfo 加入群的群组资料
-// */
-//- (void)onGroupAdd:(TIMGroupInfo*)groupInfo;
-//
-///**
-// * 本地群组资料被删除的通知回调，包括主动退群，被踢，群被解散，群被回收
-// *
-// * @param groupId 对应的群ID
-// */
-//- (void)onGroupDelete:(NSString*)groupId;
-//
-///**
-// *  群资料更新的通知回调
-// *
-// *  @param groupInfo 更新后的群资料信息
-// */
-//- (void)onGroupUpdate:(TIMGroupInfo*)groupInfo;
-//
-//@end
+/**
+ *  添加好友通知
+ *
+ *  @param users 好友列表（NSString*）
+ */
+- (void)onAddFriends:(NSArray*)users;
+
+/**
+ *  删除好友通知
+ *
+ *  @param identifiers 用户id列表（NSString*）
+ */
+- (void)onDelFriends:(NSArray*)identifiers;
+
+/**
+ *  好友资料更新通知
+ *
+ *  @param profiles 资料列表（TIMSNSChangeInfo *）
+ */
+- (void)onFriendProfileUpdate:(NSArray<TIMSNSChangeInfo *> *)profiles;
+
+/**
+ *  好友申请通知
+ *
+ *  @param reqs 好友申请者id列表（TIMFriendPendencyInfo *）
+ */
+- (void)onAddFriendReqs:(NSArray<TIMFriendPendencyInfo *> *)reqs;
+
+@end
 
 
 #endif
 #endif

@@ -9,481 +9,7 @@
 #ifndef TIMComm_Group_h
 #ifndef TIMComm_Group_h
 #define TIMComm_Group_h
 #define TIMComm_Group_h
 
 
-#import "ImSDK.h"
-
-@class TIMGroupPendencyMeta;
-
-#pragma mark - 枚举类型
-
-/**
- * 群基本获取资料标志
- */
-typedef NS_ENUM(NSInteger, TIMGetGroupBaseInfoFlag) {
-    /**
-     *  不获取群组资料
-     */
-    TIM_GET_GROUP_BASE_INFO_FLAG_NONE                           = 0x00,
-    /**
-     *  获取群组名
-     */
-    TIM_GET_GROUP_BASE_INFO_FLAG_NAME                           = 0x01,
-    /**
-     *  获取创建时间
-     */
-    TIM_GET_GROUP_BASE_INFO_FLAG_CREATE_TIME                    = 0x01 << 1,
-    /**
-     *  获取群主id
-     */
-    TIM_GET_GROUP_BASE_INFO_FLAG_OWNER_UIN                      = 0x01 << 2,
-    /**
-     *  （不可用）
-     */
-    TIM_GET_GROUP_BASE_INFO_FLAG_SEQ                            = 0x01 << 3,
-    /**
-     *  获取最近一次修改群信息时间
-     */
-    TIM_GET_GROUP_BASE_INFO_FLAG_TIME                           = 0x01 << 4,
-    /**
-     *  （不可用）
-     */
-    TIM_GET_GROUP_BASE_INFO_FLAG_NEXT_MSG_SEQ                   = 0x01 << 5,
-    /**
-     *  获取最近一次发消息时间
-     */
-    TIM_GET_GROUP_BASE_INFO_FLAG_LAST_MSG_TIME                  = 0x01 << 6,
-    /**
-     *  （不可用）
-     */
-    TIM_GET_GROUP_BASE_INFO_FLAG_APP_ID                         = 0x01 << 7,
-    /**
-     *  获取群成员数量
-     */
-    TIM_GET_GROUP_BASE_INFO_FLAG_MEMBER_NUM                     = 0x01 << 8,
-    /**
-     *  获取最大群成员数量
-     */
-    TIM_GET_GROUP_BASE_INFO_FLAG_MAX_MEMBER_NUM                 = 0x01 << 9,
-    /**
-     *  获取群公告
-     */
-    TIM_GET_GROUP_BASE_INFO_FLAG_NOTIFICATION                   = 0x01 << 10,
-    /**
-     *  获取群简介
-     */
-    TIM_GET_GROUP_BASE_INFO_FLAG_INTRODUCTION                   = 0x01 << 11,
-    /**
-     *  获取群头像
-     */
-    TIM_GET_GROUP_BASE_INFO_FLAG_FACE_URL                       = 0x01 << 12,
-    /**
-     *  获取入群类型
-     */
-    TIM_GET_GROUP_BASE_INFO_FLAG_ADD_OPTION                     = 0x01 << 13,
-    /**
-     *  获取群组类型
-     */
-    TIM_GET_GROUP_BASE_INFO_FLAG_GROUP_TYPE                     = 0x01 << 14,
-    /**
-     *  获取最后一条群消息
-     */
-    TIM_GET_GROUP_BASE_INFO_FLAG_LAST_MSG                       = 0x01 << 15,
-    /**
-     *  获取在线人数
-     */
-    TIM_GET_GROUP_BASE_INFO_FLAG_ONLINE_NUM                     = 0x01 << 16,
-    /**
-     *  获取群成员是否可见标志
-     */
-    TIM_GET_GROUP_BASE_INFO_VISIBLE                             = 0x01 << 17,
-    /**
-     *  获取群是否能被搜到标志
-     */
-    TIM_GET_GROUP_BASE_INFO_SEARCHABLE                          = 0x01 << 18,
-    /**
-     *  获取群全员禁言时间
-     */
-    TIM_GET_GROUP_BASE_INFO_ALL_SHUTUP                          = 0x01 << 19
-};
-
-/**
- *  群成员角色过滤方式
- */
-typedef NS_ENUM(NSInteger, TIMGroupMemberFilter) {
-    /**
-     *  全部成员
-     */
-    TIM_GROUP_MEMBER_FILTER_ALL            = 0x00,
-    /**
-     *  群主
-     */
-    TIM_GROUP_MEMBER_FILTER_SUPER          = 0x01,
-    /**
-     *  管理员
-     */
-    TIM_GROUP_MEMBER_FILTER_ADMIN          = 0x02,
-    /**
-     *  普通成员
-     */
-    TIM_GROUP_MEMBER_FILTER_COMMON         = 0x04,
-};
-
-/**
- * 群成员获取资料标志
- */
-typedef NS_ENUM(NSInteger, TIMGetGroupMemInfoFlag) {
-    
-    /**
-     * 入群时间
-     */
-    TIM_GET_GROUP_MEM_INFO_FLAG_JOIN_TIME                    = 0x01,
-    /**
-     * 消息标志
-     */
-    TIM_GET_GROUP_MEM_INFO_FLAG_MSG_FLAG                     = 0x01 << 1,
-    /**
-     * 角色
-     */
-    TIM_GET_GROUP_MEM_INFO_FLAG_ROLE_INFO                    = 0x01 << 3,
-    /**
-     * 禁言时间
-     */
-    TIM_GET_GROUP_MEM_INFO_FLAG_SHUTUP_TIME                  = 0x01 << 4,
-    /**
-     * 群名片
-     */
-    TIM_GET_GROUP_MEM_INFO_FLAG_NAME_CARD                    = 0x01 << 5,
-};
-
-/**
- *  群组操作结果
- */
-typedef NS_ENUM(NSInteger, TIMGroupMemberStatus) {
-    /**
-     *  操作失败
-     */
-    TIM_GROUP_MEMBER_STATUS_FAIL              = 0,
-    
-    /**
-     *  操作成功
-     */
-    TIM_GROUP_MEMBER_STATUS_SUCC              = 1,
-    
-    /**
-     *  无效操作，加群时已经是群成员，移除群组时不在群内
-     */
-    TIM_GROUP_MEMBER_STATUS_INVALID           = 2,
-    
-    /**
-     *  等待处理，邀请入群时等待对方处理
-     */
-    TIM_GROUP_MEMBER_STATUS_PENDING           = 3,
-};
-
-typedef NS_ENUM(NSInteger, TIMGroupPendencyGetType) {
-    /**
-     *  申请入群
-     */
-    TIM_GROUP_PENDENCY_GET_TYPE_JOIN            = 0x0,
-    /**
-     *  邀请入群
-     */
-    TIM_GROUP_PENDENCY_GET_TYPE_INVITE          = 0x1,
-};
-
-typedef NS_ENUM(NSInteger, TIMGroupPendencyHandleStatus) {
-    /**
-     *  未处理
-     */
-    TIM_GROUP_PENDENCY_HANDLE_STATUS_UNHANDLED            = 0,
-    /**
-     *  被他人处理
-     */
-    TIM_GROUP_PENDENCY_HANDLE_STATUS_OTHER_HANDLED        = 1,
-    /**
-     *  被用户处理
-     */
-    TIM_GROUP_PENDENCY_HANDLE_STATUS_OPERATOR_HANDLED     = 2,
-};
-
-typedef NS_ENUM(NSInteger, TIMGroupPendencyHandleResult) {
-    /**
-     *  拒绝申请
-     */
-    TIM_GROUP_PENDENCY_HANDLE_RESULT_REFUSE       = 0,
-    /**
-     *  同意申请
-     */
-    TIM_GROUP_PENDENCY_HANDLE_RESULT_AGREE        = 1,
-};
-
-#pragma mark - block回调
-
-/**
- *  群成员列表回调
- *
- *  @param members 群成员列表
- */
-typedef void (^TIMGroupMemberSucc)(NSArray * members);
-
-/**
- *  群列表回调
- *
- *  @param arr 群列表
- */
-typedef void (^TIMGroupListSucc)(NSArray * arr);
-
-/**
- *  本人群组内成员信息回调
- *
- *  @param selfInfo 本人成员信息
- */
-typedef void (^TIMGroupSelfSucc)(TIMGroupMemberInfo * selfInfo);
-
-/**
- *  群接受消息选项回调
- *
- *  @param opt 群接受消息选项
- */
-typedef void (^TIMGroupReciveMessageOptSucc)(TIMGroupReceiveMessageOpt opt);
-
-/**
- *  群成员列表回调（分页使用）
- *
- *  @param members 群成员（TIMGroupMemberInfo*）列表
- */
-typedef void (^TIMGroupMemberSuccV2)(uint64_t nextSeq, NSArray * members);
-
-/**
- *  群搜索回调
- *
- *  @param totalNum 搜索结果的总数
- *  @param groups  请求的群列表片段
- */
-typedef void (^TIMGroupSearchSucc)(uint64_t totalNum, NSArray * groups);
-
-/**
- *  获取群组未决请求列表成功
- *
- *  @param meta       未决请求元信息
- *  @param pendencies 未决请求列表（TIMGroupPendencyItem）数组
- */
-typedef void (^TIMGetGroupPendencyListSucc)(TIMGroupPendencyMeta * meta, NSArray * pendencies);
-
-#pragma mark - 基本类型
-
-/**
- *  创建群参数
- */
-@interface TIMCreateGroupInfo : TIMCodingModel
-
-/**
- *  群组Id,nil则使用系统默认Id
- */
-@property(nonatomic,strong) NSString* group;
-
-/**
- *  群名
- */
-@property(nonatomic,strong) NSString* groupName;
-
-/**
- *  群类型：Private,Public,ChatRoom,AVChatRoom,BChatRoom
- */
-@property(nonatomic,strong) NSString* groupType;
-
-/**
- *  是否设置入群选项，Private类型群组请设置为false
- */
-@property(nonatomic,assign) BOOL setAddOpt;
-
-/**
- *  入群选项
- */
-@property(nonatomic,assign) TIMGroupAddOpt addOpt;
-
-/**
- *  最大成员数，填0则系统使用默认值
- */
-@property(nonatomic,assign) uint32_t maxMemberNum;
-
-/**
- *  群公告
- */
-@property(nonatomic,strong) NSString* notification;
-
-/**
- *  群简介
- */
-@property(nonatomic,strong) NSString* introduction;
-
-/**
- *  群头像
- */
-@property(nonatomic,strong) NSString* faceURL;
-
-/**
- *  自定义字段集合,key是NSString*类型,value是NSData*类型
- */
-@property(nonatomic,strong) NSDictionary* customInfo;
-
-/**
- *  创建成员（TIMCreateGroupMemberInfo*）列表
- */
-@property(nonatomic,strong) NSArray* membersInfo;
-
-@end
-
-/**
- * 未决请求选项
- */
-@interface TIMGroupPendencyOption : TIMCodingModel
-
-/**
- *  拉取的起始时间 0：拉取最新的
- */
-@property(nonatomic,assign) uint64_t timestamp;
-
-/**
- *  每页的数量
- */
-@property(nonatomic,assign) uint32_t numPerPage;
-@end
-
-/**
- *  未决请求元信息
- */
-@interface TIMGroupPendencyMeta : TIMCodingModel
-
-/**
- *  下一次拉取的起始时间戳
- */
-@property(nonatomic,assign) uint64_t nextStartTime;
-
-/**
- *  已读时间戳大小
- */
-@property(nonatomic,assign) uint64_t readTimeSeq;
-
-/**
- *  未决未读数
- */
-@property(nonatomic,assign) uint32_t unReadCnt;
-
-@end
-
-/**
- *  创建群组时的成员信息
- */
-@interface TIMCreateGroupMemberInfo : TIMCodingModel
-
-/**
- *  被操作成员
- */
-@property(nonatomic,strong) NSString* member;
-
-/**
- *  成员类型
- */
-@property(nonatomic,assign) TIMGroupMemberRole role;
-
-/**
- *  自定义字段集合,key是NSString*类型,value是NSData*类型
- */
-@property(nonatomic,strong) NSDictionary* customInfo;
-
-@end
-
-/**
- *  成员操作返回值
- */
-@interface TIMGroupMemberResult : NSObject
-
-/**
- *  被操作成员
- */
-@property(nonatomic,strong) NSString* member;
-/**
- *  返回状态
- */
-@property(nonatomic,assign) TIMGroupMemberStatus status;
-
-@end
-
-/**
- *  未决申请
- */
-@interface TIMGroupPendencyItem : TIMCodingModel
-
-/**
- *  相关群组id
- */
-@property(nonatomic,strong) NSString* groupId;
-
-/**
- *  请求者id，请求加群:请求者，邀请加群:邀请人
- */
-@property(nonatomic,strong) NSString* fromUser;
-
-/**
- *  判决者id，请求加群:0，邀请加群:被邀请人
- */
-@property(nonatomic,strong) NSString* toUser;
-
-/**
- *  未决添加时间
- */
-@property(nonatomic,assign) uint64_t addTime;
-
-/**
- *  未决请求类型
- */
-@property(nonatomic,assign) TIMGroupPendencyGetType getType;
-
-/**
- *  已决标志
- */
-@property(nonatomic,assign) TIMGroupPendencyHandleStatus handleStatus;
-
-/**
- *  已决结果
- */
-@property(nonatomic,assign) TIMGroupPendencyHandleResult handleResult;
-
-/**
- *  申请或邀请附加信息
- */
-@property(nonatomic,strong) NSString* requestMsg;
-
-/**
- *  审批信息：同意或拒绝信息
- */
-@property(nonatomic,strong) NSString* handledMsg;
-
-
-/**
- *  同意申请
- *
- *  @param msg      同意理由，选填
- *  @param succ     成功回调
- *  @param fail     失败回调，返回错误码和错误描述
- */
--(void) accept:(NSString*)msg succ:(TIMSucc)succ fail:(TIMFail)fail;
-
-/**
- *  拒绝申请
- *
- *  @param msg      拒绝理由，选填
- *  @param succ     成功回调
- *  @param fail     失败回调，返回错误码和错误描述
- */
--(void) refuse:(NSString*)msg succ:(TIMSucc)succ fail:(TIMFail)fail;
-
-
-/**
- *  用户自己的id
- */
-@property(nonatomic,strong) NSString* selfIdentifier;
-
-@end
+//消息扩展类待废弃，请直接使用 TIMComm.h 调用相关方法
+#import "TIMComm.h"
 
 
 #endif /* TIMComm_Group_h */
 #endif /* TIMComm_Group_h */

@@ -9,157 +9,7 @@
 #ifndef TIMComm_MsgExt_h
 #ifndef TIMComm_MsgExt_h
 #define TIMComm_MsgExt_h
 #define TIMComm_MsgExt_h
 
 
-#import <Foundation/Foundation.h>
-#import "ImSDK.h"
-
-@class TIMSendToUsersDetailInfo;
-
-#pragma mark - 枚举类型
-
-typedef NS_ENUM(NSInteger, TIM_SNS_SYSTEM_TYPE){
-    /**
-     *  增加好友消息
-     */
-    TIM_SNS_SYSTEM_ADD_FRIEND                           = 0x01,
-    /**
-     *  删除好友消息
-     */
-    TIM_SNS_SYSTEM_DEL_FRIEND                           = 0x02,
-    /**
-     *  增加好友申请
-     */
-    TIM_SNS_SYSTEM_ADD_FRIEND_REQ                       = 0x03,
-    /**
-     *  删除未决申请
-     */
-    TIM_SNS_SYSTEM_DEL_FRIEND_REQ                       = 0x04,
-    /**
-     *  黑名单添加
-     */
-    TIM_SNS_SYSTEM_ADD_BLACKLIST                        = 0x05,
-    /**
-     *  黑名单删除
-     */
-    TIM_SNS_SYSTEM_DEL_BLACKLIST                        = 0x06,
-    /**
-     *  未决已读上报
-     */
-    TIM_SNS_SYSTEM_PENDENCY_REPORT                      = 0x07,
-    /**
-     *  关系链资料变更
-     */
-    TIM_SNS_SYSTEM_SNS_PROFILE_CHANGE                   = 0x08,
-    /**
-     *  推荐数据增加
-     */
-    TIM_SNS_SYSTEM_ADD_RECOMMEND                        = 0x09,
-    /**
-     *  推荐数据删除
-     */
-    TIM_SNS_SYSTEM_DEL_RECOMMEND                        = 0x0a,
-    /**
-     *  已决增加
-     */
-    TIM_SNS_SYSTEM_ADD_DECIDE                           = 0x0b,
-    /**
-     *  已决删除
-     */
-    TIM_SNS_SYSTEM_DEL_DECIDE                           = 0x0c,
-    /**
-     *  推荐已读上报
-     */
-    TIM_SNS_SYSTEM_RECOMMEND_REPORT                     = 0x0d,
-    /**
-     *  已决已读上报
-     */
-    TIM_SNS_SYSTEM_DECIDE_REPORT                        = 0x0e,
-    
-    
-};
-
-/**
- *  资料变更
- */
-typedef NS_ENUM(NSInteger, TIM_PROFILE_SYSTEM_TYPE){
-    /**
-     好友资料变更
-     */
-    TIM_PROFILE_SYSTEM_FRIEND_PROFILE_CHANGE        = 0x01,
-};
-
-#pragma mark - block回调
-
-typedef void (^TIMSendToUsersFail)(int code, NSString *err, TIMSendToUsersDetailInfo *detailInfo);
-
-#pragma mark - 基本类型
-
-/**
- *  发送消息给多用户的失败回调信息
- */
-@interface TIMSendToUsersDetailInfo : NSObject
-/**
- *  发送消息成功的目标用户数
- */
-@property(nonatomic,assign) uint32_t succCnt;
-/**
- *  发送消息失败的目标用户数
- */
-@property(nonatomic,assign) uint32_t failCnt;
-/**
- *  失败信息（TIMSendToUsersErrInfo*）列表
- */
-@property(nonatomic,strong) NSArray *errInofs;
-@end
-
-/**
- *  发送消息给多用户的失败信息
- */
-@interface TIMSendToUsersErrInfo : NSObject
-/**
- *  发送消息失败的目标用户id
- */
-@property(nonatomic,strong) NSString *identifier;
-/**
- *  错误码
- */
-@property(nonatomic,assign) int code;
-/**
- *  错误描述
- */
-@property(nonatomic,strong) NSString *err;
-@end
-
-/**
- *  关系链变更详细信息
- */
-@interface TIMSNSChangeInfo : NSObject
-
-/**
- *  用户 identifier
- */
-@property(nonatomic,strong) NSString * identifier;
-
-/**
- *  用户昵称
- */
-@property(nonatomic,strong) NSString * nickname;
-
-/**
- *  申请添加时有效，添加理由
- */
-@property(nonatomic,strong) NSString * wording;
-
-/**
- *  申请时填写，添加来源
- */
-@property(nonatomic,strong) NSString * source;
-
-
-/**
- *  备注 type=TIM_SNS_SYSTEM_SNS_PROFILE_CHANGE 有效
- */
-@property(nonatomic,strong) NSString * remark;
-
-@end
+//消息扩展类待废弃，请直接使用 TIMComm.h 调用相关方法
+#import "TIMComm.h"
 
 
 #endif /* TIMComm_MsgExt_h */
 #endif /* TIMComm_MsgExt_h */

@@ -21,16 +21,25 @@
 @protocol TIMMessageRevokeListener;
 @protocol TIMMessageRevokeListener;
 @protocol TIMUploadProgressListener;
 @protocol TIMUploadProgressListener;
 @protocol TIMGroupEventListener;
 @protocol TIMGroupEventListener;
-//@protocol TIMFriendshipListener;
+@protocol TIMFriendshipListener;
 //@protocol TIMGroupListener;
 //@protocol TIMGroupListener;
 @class TIMMessage;
 @class TIMMessage;
 @class TIMImageElem;
 @class TIMImageElem;
 @class TIMConversation;
 @class TIMConversation;
 @class TIMAPNSConfig;
 @class TIMAPNSConfig;
 @class TIMUserProfile;
 @class TIMUserProfile;
+@class TIMFriend;
 @class TIMGroupInfoOption;
 @class TIMGroupInfoOption;
 @class TIMGroupMemberInfoOption;
 @class TIMGroupMemberInfoOption;
 @class TIMFriendProfileOption;
 @class TIMFriendProfileOption;
+@class TIMFriendResult;
+@class TIMCheckFriendResult;
+@class TIMGroupPendencyMeta;
+@class TIMCreateGroupMemberInfo;
+@class TIMSendToUsersDetailInfo;
+@class TIMGroupInfo;
+@class TIMGroupMemberInfo;
+@class TIMGroupPendencyItem;
 
 
 #pragma mark - 枚举类型
 #pragma mark - 枚举类型
 
 
@@ -53,10 +62,25 @@ typedef NS_ENUM(NSInteger, TIMNetworkStatus) {
  * 日志级别
  * 日志级别
  */
  */
 typedef NS_ENUM(NSInteger, TIMLogLevel) {
 typedef NS_ENUM(NSInteger, TIMLogLevel) {
+    /**
+     *  不输出任何 sdk log
+     */
     TIM_LOG_NONE                = 0,
     TIM_LOG_NONE                = 0,
+    /**
+     *  输出 DEBUG，INFO，WARNING，ERROR 级别的 log
+     */
     TIM_LOG_DEBUG               = 3,
     TIM_LOG_DEBUG               = 3,
+    /**
+     *  输出 INFO，WARNING，ERROR 级别的 log
+     */
     TIM_LOG_INFO                = 4,
     TIM_LOG_INFO                = 4,
+    /**
+     *  输出 WARNING，ERROR 级别的 log
+     */
     TIM_LOG_WARN                = 5,
     TIM_LOG_WARN                = 5,
+    /**
+     *  输出 ERROR 级别的 log
+     */
     TIM_LOG_ERROR               = 6,
     TIM_LOG_ERROR               = 6,
 };
 };
 
 
@@ -175,19 +199,19 @@ typedef NS_ENUM(NSInteger, TIM_IMAGE_TYPE){
  */
  */
 typedef NS_ENUM(NSInteger, TIM_IMAGE_FORMAT){
 typedef NS_ENUM(NSInteger, TIM_IMAGE_FORMAT){
     /**
     /**
-     *  JPG格式
+     *  JPG 格式
      */
      */
     TIM_IMAGE_FORMAT_JPG            = 0x1,
     TIM_IMAGE_FORMAT_JPG            = 0x1,
     /**
     /**
-     *  GIF格式
+     *  GIF 格式
      */
      */
     TIM_IMAGE_FORMAT_GIF            = 0x2,
     TIM_IMAGE_FORMAT_GIF            = 0x2,
     /**
     /**
-     *  PNG格式
+     *  PNG 格式
      */
      */
     TIM_IMAGE_FORMAT_PNG            = 0x3,
     TIM_IMAGE_FORMAT_PNG            = 0x3,
     /**
     /**
-     *  BMP格式
+     *  BMP 格式
      */
      */
     TIM_IMAGE_FORMAT_BMP            = 0x4,
     TIM_IMAGE_FORMAT_BMP            = 0x4,
     /**
     /**
@@ -196,23 +220,57 @@ typedef NS_ENUM(NSInteger, TIM_IMAGE_FORMAT){
     TIM_IMAGE_FORMAT_UNKNOWN        = 0xff,
     TIM_IMAGE_FORMAT_UNKNOWN        = 0xff,
 };
 };
 
 
+/**
+ *  登录状态
+ */
 typedef NS_ENUM(NSInteger, TIMLoginStatus) {
 typedef NS_ENUM(NSInteger, TIMLoginStatus) {
     /**
     /**
-     *  已登陆
+     *  已登录
      */
      */
     TIM_STATUS_LOGINED             = 1,
     TIM_STATUS_LOGINED             = 1,
     
     
     /**
     /**
-     *  登陆中
+     *  登录中
      */
      */
     TIM_STATUS_LOGINING            = 2,
     TIM_STATUS_LOGINING            = 2,
     
     
     /**
     /**
-     *  无登陆
+     *  无登录
      */
      */
     TIM_STATUS_LOGOUT              = 3,
     TIM_STATUS_LOGOUT              = 3,
 };
 };
 
 
+/**
+ *  推送规则
+ */
+typedef NS_ENUM(NSInteger, TIMOfflinePushFlag) {
+    /**
+     *  按照默认规则进行推送
+     */
+    TIM_OFFLINE_PUSH_DEFAULT    = 0,
+    /**
+     *  不进行推送
+     */
+    TIM_OFFLINE_PUSH_NO_PUSH    = 1,
+};
+
+/**
+ *  安卓离线推送模式
+ */
+typedef NS_ENUM(NSInteger, TIMAndroidOfflinePushNotifyMode) {
+    /**
+     *  通知栏消息
+     */
+    TIM_ANDROID_OFFLINE_PUSH_NOTIFY_MODE_NOTIFICATION = 0x00,
+    /**
+     *  不弹窗，由应用自行处理
+     */
+    TIM_ANDROID_OFFLINE_PUSH_NOTIFY_MODE_CUSTOM = 0x01,
+};
+
+/**
+ *  群组成员是否可见
+ */
 typedef NS_ENUM(NSInteger, TIMGroupMemberVisibleType) {
 typedef NS_ENUM(NSInteger, TIMGroupMemberVisibleType) {
     /**
     /**
      *  未知
      *  未知
@@ -228,6 +286,9 @@ typedef NS_ENUM(NSInteger, TIMGroupMemberVisibleType) {
     TIM_GROUP_MEMBER_VISIBLE_YES              = 0x02,
     TIM_GROUP_MEMBER_VISIBLE_YES              = 0x02,
 };
 };
 
 
+/**
+ *  群组是否能被搜到
+ */
 typedef NS_ENUM(NSInteger, TIMGroupSearchableType) {
 typedef NS_ENUM(NSInteger, TIMGroupSearchableType) {
     /**
     /**
      *  未知
      *  未知
@@ -302,13 +363,13 @@ typedef NS_ENUM(NSInteger, TIMGroupReceiveMessageOpt) {
      */
      */
     TIM_GROUP_NOT_RECEIVE_MESSAGE                   = 1,
     TIM_GROUP_NOT_RECEIVE_MESSAGE                   = 1,
     /**
     /**
-     *  接受消息，不进行iOS APNs 推送
+     *  接受消息，不进行 iOS APNs 推送
      */
      */
     TIM_GROUP_RECEIVE_NOT_NOTIFY_MESSAGE            = 2,
     TIM_GROUP_RECEIVE_NOT_NOTIFY_MESSAGE            = 2,
 };
 };
 
 
 /**
 /**
- *  群Tips类型
+ *  群 Tips 类型
  */
  */
 typedef NS_ENUM(NSInteger, TIM_GROUP_TIPS_TYPE){
 typedef NS_ENUM(NSInteger, TIM_GROUP_TIPS_TYPE){
     /**
     /**
@@ -342,7 +403,7 @@ typedef NS_ENUM(NSInteger, TIM_GROUP_TIPS_TYPE){
 };
 };
 
 
 /**
 /**
- *  群Tips类型
+ *  群变更信息 Tips 类型
  */
  */
 typedef NS_ENUM(NSInteger, TIM_GROUP_INFO_CHANGE_TYPE){
 typedef NS_ENUM(NSInteger, TIM_GROUP_INFO_CHANGE_TYPE){
     /**
     /**
@@ -433,53 +494,244 @@ typedef NS_ENUM(NSInteger, TIM_GROUP_SYSTEM_TYPE){
     TIM_GROUP_SYSTEM_CUSTOM_INFO                         = 0xff,
     TIM_GROUP_SYSTEM_CUSTOM_INFO                         = 0xff,
 };
 };
 
 
-typedef NS_ENUM(NSInteger, TIMOfflinePushFlag) {
+/**
+ * 群成员角色
+ */
+typedef NS_ENUM(NSInteger, TIMGroupMemberRole) {
     /**
     /**
-     *  按照默认规则进行推送
+     *  未定义（没有获取该字段）
      */
      */
-    TIM_OFFLINE_PUSH_DEFAULT    = 0,
+    TIM_GROUP_MEMBER_UNDEFINED              = 0,
+    
     /**
     /**
-     *  不进行推送
+     *  群成员
      */
      */
-    TIM_OFFLINE_PUSH_NO_PUSH    = 1,
+    TIM_GROUP_MEMBER_ROLE_MEMBER              = 200,
+    
+    /**
+     *  群管理员
+     */
+    TIM_GROUP_MEMBER_ROLE_ADMIN               = 300,
+    
+    /**
+     *  群主
+     */
+    TIM_GROUP_MEMBER_ROLE_SUPER               = 400,
 };
 };
 
 
-typedef NS_ENUM(NSInteger, TIMAndroidOfflinePushNotifyMode) {
+/**
+ * 群基本获取资料标志
+ */
+typedef NS_ENUM(NSInteger, TIMGetGroupBaseInfoFlag) {
     /**
     /**
-     *  通知栏消息
+     *  不获取群组资料
      */
      */
-    TIM_ANDROID_OFFLINE_PUSH_NOTIFY_MODE_NOTIFICATION = 0x00,
+    TIM_GET_GROUP_BASE_INFO_FLAG_NONE                           = 0x00,
     /**
     /**
-     *  不弹窗，由应用自行处理
+     *  获取群组名
      */
      */
-    TIM_ANDROID_OFFLINE_PUSH_NOTIFY_MODE_CUSTOM = 0x01,
+    TIM_GET_GROUP_BASE_INFO_FLAG_NAME                           = 0x01,
+    /**
+     *  获取创建时间
+     */
+    TIM_GET_GROUP_BASE_INFO_FLAG_CREATE_TIME                    = 0x01 << 1,
+    /**
+     *  获取群主id
+     */
+    TIM_GET_GROUP_BASE_INFO_FLAG_OWNER_UIN                      = 0x01 << 2,
+    /**
+     *  （不可用）
+     */
+    TIM_GET_GROUP_BASE_INFO_FLAG_SEQ                            = 0x01 << 3,
+    /**
+     *  获取最近一次修改群信息时间
+     */
+    TIM_GET_GROUP_BASE_INFO_FLAG_TIME                           = 0x01 << 4,
+    /**
+     *  （不可用）
+     */
+    TIM_GET_GROUP_BASE_INFO_FLAG_NEXT_MSG_SEQ                   = 0x01 << 5,
+    /**
+     *  获取最近一次发消息时间
+     */
+    TIM_GET_GROUP_BASE_INFO_FLAG_LAST_MSG_TIME                  = 0x01 << 6,
+    /**
+     *  （不可用）
+     */
+    TIM_GET_GROUP_BASE_INFO_FLAG_APP_ID                         = 0x01 << 7,
+    /**
+     *  获取群成员数量
+     */
+    TIM_GET_GROUP_BASE_INFO_FLAG_MEMBER_NUM                     = 0x01 << 8,
+    /**
+     *  获取最大群成员数量
+     */
+    TIM_GET_GROUP_BASE_INFO_FLAG_MAX_MEMBER_NUM                 = 0x01 << 9,
+    /**
+     *  获取群公告
+     */
+    TIM_GET_GROUP_BASE_INFO_FLAG_NOTIFICATION                   = 0x01 << 10,
+    /**
+     *  获取群简介
+     */
+    TIM_GET_GROUP_BASE_INFO_FLAG_INTRODUCTION                   = 0x01 << 11,
+    /**
+     *  获取群头像
+     */
+    TIM_GET_GROUP_BASE_INFO_FLAG_FACE_URL                       = 0x01 << 12,
+    /**
+     *  获取入群类型
+     */
+    TIM_GET_GROUP_BASE_INFO_FLAG_ADD_OPTION                     = 0x01 << 13,
+    /**
+     *  获取群组类型
+     */
+    TIM_GET_GROUP_BASE_INFO_FLAG_GROUP_TYPE                     = 0x01 << 14,
+    /**
+     *  获取最后一条群消息
+     */
+    TIM_GET_GROUP_BASE_INFO_FLAG_LAST_MSG                       = 0x01 << 15,
+    /**
+     *  获取在线人数
+     */
+    TIM_GET_GROUP_BASE_INFO_FLAG_ONLINE_NUM                     = 0x01 << 16,
+    /**
+     *  获取群成员是否可见标志
+     */
+    TIM_GET_GROUP_BASE_INFO_VISIBLE                             = 0x01 << 17,
+    /**
+     *  获取群是否能被搜到标志
+     */
+    TIM_GET_GROUP_BASE_INFO_SEARCHABLE                          = 0x01 << 18,
+    /**
+     *  获取群全员禁言时间
+     */
+    TIM_GET_GROUP_BASE_INFO_ALL_SHUTUP                          = 0x01 << 19
 };
 };
 
 
 /**
 /**
- * 群成员角色
+ *  群成员角色过滤方式
  */
  */
-typedef NS_ENUM(NSInteger, TIMGroupMemberRole) {
+typedef NS_ENUM(NSInteger, TIMGroupMemberFilter) {
     /**
     /**
-     *  未定义（没有获取该字段）
+     *  全部成员
      */
      */
-    TIM_GROUP_MEMBER_UNDEFINED              = 0,
+    TIM_GROUP_MEMBER_FILTER_ALL            = 0x00,
+    /**
+     *  群主
+     */
+    TIM_GROUP_MEMBER_FILTER_SUPER          = 0x01,
+    /**
+     *  管理员
+     */
+    TIM_GROUP_MEMBER_FILTER_ADMIN          = 0x02,
+    /**
+     *  普通成员
+     */
+    TIM_GROUP_MEMBER_FILTER_COMMON         = 0x04,
+};
+
+/**
+ * 群成员获取资料标志
+ */
+typedef NS_ENUM(NSInteger, TIMGetGroupMemInfoFlag) {
     
     
     /**
     /**
-     *  群成员
+     * 入群时间
      */
      */
-    TIM_GROUP_MEMBER_ROLE_MEMBER              = 200,
+    TIM_GET_GROUP_MEM_INFO_FLAG_JOIN_TIME                    = 0x01,
+    /**
+     * 消息标志
+     */
+    TIM_GET_GROUP_MEM_INFO_FLAG_MSG_FLAG                     = 0x01 << 1,
+    /**
+     * 角色
+     */
+    TIM_GET_GROUP_MEM_INFO_FLAG_ROLE_INFO                    = 0x01 << 3,
+    /**
+     * 禁言时间
+     */
+    TIM_GET_GROUP_MEM_INFO_FLAG_SHUTUP_TIME                  = 0x01 << 4,
+    /**
+     * 群名片
+     */
+    TIM_GET_GROUP_MEM_INFO_FLAG_NAME_CARD                    = 0x01 << 5,
+};
+
+/**
+ *  群组操作结果
+ */
+typedef NS_ENUM(NSInteger, TIMGroupMemberStatus) {
+    /**
+     *  操作失败
+     */
+    TIM_GROUP_MEMBER_STATUS_FAIL              = 0,
     
     
     /**
     /**
-     *  群管理员
+     *  操作成功
      */
      */
-    TIM_GROUP_MEMBER_ROLE_ADMIN               = 300,
+    TIM_GROUP_MEMBER_STATUS_SUCC              = 1,
     
     
     /**
     /**
-     *  群主
+     *  无效操作，加群时已经是群成员，移除群组时不在群内
      */
      */
-    TIM_GROUP_MEMBER_ROLE_SUPER               = 400,
+    TIM_GROUP_MEMBER_STATUS_INVALID           = 2,
+    
+    /**
+     *  等待处理，邀请入群时等待对方处理
+     */
+    TIM_GROUP_MEMBER_STATUS_PENDING           = 3,
+};
+
+/**
+ *  群组未决请求类型
+ */
+typedef NS_ENUM(NSInteger, TIMGroupPendencyGetType) {
+    /**
+     *  申请入群
+     */
+    TIM_GROUP_PENDENCY_GET_TYPE_JOIN            = 0x0,
+    /**
+     *  邀请入群
+     */
+    TIM_GROUP_PENDENCY_GET_TYPE_INVITE          = 0x1,
+};
+
+/**
+ *  群组已决标志
+ */
+typedef NS_ENUM(NSInteger, TIMGroupPendencyHandleStatus) {
+    /**
+     *  未处理
+     */
+    TIM_GROUP_PENDENCY_HANDLE_STATUS_UNHANDLED            = 0,
+    /**
+     *  被他人处理
+     */
+    TIM_GROUP_PENDENCY_HANDLE_STATUS_OTHER_HANDLED        = 1,
+    /**
+     *  被用户处理
+     */
+    TIM_GROUP_PENDENCY_HANDLE_STATUS_OPERATOR_HANDLED     = 2,
+};
+
+/**
+ *  群组已决结果
+ */
+typedef NS_ENUM(NSInteger, TIMGroupPendencyHandleResult) {
+    /**
+     *  拒绝申请
+     */
+    TIM_GROUP_PENDENCY_HANDLE_RESULT_REFUSE       = 0,
+    /**
+     *  同意申请
+     */
+    TIM_GROUP_PENDENCY_HANDLE_RESULT_AGREE        = 1,
 };
 };
 
 
+/**
+ * 好友验证方式
+ */
 typedef NS_ENUM(NSInteger, TIMFriendAllowType) {
 typedef NS_ENUM(NSInteger, TIMFriendAllowType) {
     /**
     /**
      *  同意任何用户加好友
      *  同意任何用户加好友
@@ -497,6 +749,9 @@ typedef NS_ENUM(NSInteger, TIMFriendAllowType) {
     TIM_FRIEND_DENY_ANY                     = 2,
     TIM_FRIEND_DENY_ANY                     = 2,
 };
 };
 
 
+/**
+ * 性别
+ */
 typedef NS_ENUM(NSInteger, TIMGender) {
 typedef NS_ENUM(NSInteger, TIMGender) {
     /**
     /**
      *  未知性别
      *  未知性别
@@ -514,60 +769,80 @@ typedef NS_ENUM(NSInteger, TIMGender) {
 };
 };
 
 
 /**
 /**
- * 基本资料标志位
+ * 操作类型
  */
  */
-typedef NS_ENUM(NSInteger, TIMProfileFlag) {
+typedef NS_ENUM(NSInteger, TIM_SNS_SYSTEM_TYPE){
+    /**
+     *  增加好友消息
+     */
+    TIM_SNS_SYSTEM_ADD_FRIEND                           = 0x01,
+    /**
+     *  删除好友消息
+     */
+    TIM_SNS_SYSTEM_DEL_FRIEND                           = 0x02,
+    /**
+     *  增加好友申请
+     */
+    TIM_SNS_SYSTEM_ADD_FRIEND_REQ                       = 0x03,
     /**
     /**
-     * 昵称
+     *  删除未决申请
      */
      */
-    TIM_PROFILE_FLAG_NICK                = 0x01,
+    TIM_SNS_SYSTEM_DEL_FRIEND_REQ                       = 0x04,
     /**
     /**
-     * 好友验证方式
+     *  黑名单添加
      */
      */
-    TIM_PROFILE_FLAG_ALLOW_TYPE          = (0x01 << 1),
+    TIM_SNS_SYSTEM_ADD_BLACKLIST                        = 0x05,
     /**
     /**
-     * 头像
+     *  黑名单删除
      */
      */
-    TIM_PROFILE_FLAG_FACE_URL            = (0x01 << 2),
+    TIM_SNS_SYSTEM_DEL_BLACKLIST                        = 0x06,
     /**
     /**
-     * 好友备注
+     *  未决已读上报
      */
      */
-    TIM_PROFILE_FLAG_REMARK              = (0x01 << 3),
+    TIM_SNS_SYSTEM_PENDENCY_REPORT                      = 0x07,
     /**
     /**
-     * 好友分组
+     *  关系链资料变更
      */
      */
-    TIM_PROFILE_FLAG_GROUP               = (0x01 << 4),
+    TIM_SNS_SYSTEM_SNS_PROFILE_CHANGE                   = 0x08,
     /**
     /**
-     * 用户签名
+     *  推荐数据增加
      */
      */
-    TIM_PROFILE_FLAG_SELFSIGNATURE       = (0x01 << 5),
+    TIM_SNS_SYSTEM_ADD_RECOMMEND                        = 0x09,
     /**
     /**
-     * 用户性别
+     *  推荐数据删除
      */
      */
-    TIM_PROFILE_FLAG_GENDER              = (0x01 << 6),
+    TIM_SNS_SYSTEM_DEL_RECOMMEND                        = 0x0a,
     /**
     /**
-     * 用户生日
+     *  已决增加
      */
      */
-    TIM_PROFILE_FLAG_BIRTHDAY            = (0x01 << 7),
+    TIM_SNS_SYSTEM_ADD_DECIDE                           = 0x0b,
     /**
     /**
-     * 用户区域
+     *  已决删除
      */
      */
-    TIM_PROFILE_FLAG_LOCATION            = (0x01 << 8),
+    TIM_SNS_SYSTEM_DEL_DECIDE                           = 0x0c,
     /**
     /**
-     * 用户语言
+     *  推荐已读上报
      */
      */
-    TIM_PROFILE_FLAG_LANGUAGE            = (0x01 << 9),
+    TIM_SNS_SYSTEM_RECOMMEND_REPORT                     = 0x0d,
     /**
     /**
-     * 用户等级
+     *  已决已读上报
      */
      */
-    TIM_PROFILE_FLAG_LEVEL               = (0x01 << 10),
+    TIM_SNS_SYSTEM_DECIDE_REPORT                        = 0x0e,
+    
+    
+};
+
+/**
+ *  资料变更
+ */
+typedef NS_ENUM(NSInteger, TIM_PROFILE_SYSTEM_TYPE){
     /**
     /**
-     * 用户角色
+     好友资料变更
      */
      */
-    TIM_PROFILE_FLAG_ROLE                = (0x01 << 11),
+    TIM_PROFILE_SYSTEM_FRIEND_PROFILE_CHANGE        = 0x01,
 };
 };
 
 
-#pragma mark - block回调
+#pragma mark - block 回调
 
 
 /**
 /**
  *  获取消息回调
  *  获取消息回调
@@ -598,7 +873,7 @@ typedef void (^TIMFail)(int code, NSString * msg);
 typedef void (^TIMProgress)(NSInteger curSize, NSInteger totalSize);
 typedef void (^TIMProgress)(NSInteger curSize, NSInteger totalSize);
 
 
 /**
 /**
- *  登陆成功回调
+ *  登录成功回调
  */
  */
 typedef void (^TIMLoginSucc)(void);
 typedef void (^TIMLoginSucc)(void);
 
 
@@ -620,12 +895,12 @@ typedef void (^TIMLogFunc)(TIMLogLevel lvl, NSString * msg);
 /**
 /**
  *  上传图片成功回调
  *  上传图片成功回调
  *
  *
- *  @param elem 上传图片成功后elem
+ *  @param elem 上传图片成功后 elem
  */
  */
 typedef void (^TIMUploadImageSucc)(TIMImageElem * elem);
 typedef void (^TIMUploadImageSucc)(TIMImageElem * elem);
 
 
 /**
 /**
- *  APNs推送配置更新成功回调
+ *  APNs 推送配置更新成功回调
  *
  *
  *  @param config 配置
  *  @param config 配置
  */
  */
@@ -634,7 +909,7 @@ typedef void (^TIMAPNSConfigSucc)(TIMAPNSConfig* config);
 /**
 /**
  *  群创建成功
  *  群创建成功
  *
  *
- *  @param groupId 群组Id
+ *  @param groupId 群组 Id
  */
  */
 typedef void (^TIMCreateGroupSucc)(NSString * groupId);
 typedef void (^TIMCreateGroupSucc)(NSString * groupId);
 
 
@@ -643,7 +918,7 @@ typedef void (^TIMCreateGroupSucc)(NSString * groupId);
  *
  *
  *  @param friends 好友列表
  *  @param friends 好友列表
  */
  */
-typedef void (^TIMFriendSucc)(NSArray * friends);
+typedef void (^TIMFriendArraySucc)(NSArray<TIMFriend *> *friends);
 
 
 /**
 /**
  *  获取资料回调
  *  获取资料回调
@@ -652,507 +927,696 @@ typedef void (^TIMFriendSucc)(NSArray * friends);
  */
  */
 typedef void (^TIMGetProfileSucc)(TIMUserProfile * profile);
 typedef void (^TIMGetProfileSucc)(TIMUserProfile * profile);
 
 
-#pragma mark - 基本类型
-
-@interface TIMCodingModel : NSObject <NSCoding>
-
-- (void)encodeWithCoder:(NSCoder *)encoder;
-- (id)initWithCoder:(NSCoder *)decoder;
-
-@end
-
-@interface TIMSdkConfig : NSObject
-
 /**
 /**
- *  用户标识接入SDK的应用ID，必填
+ *  获取资料回调
+ *
+ *  @param profiles 资料
  */
  */
-@property(nonatomic,assign) int sdkAppId;
+typedef void (^TIMUserProfileArraySucc)(NSArray<TIMUserProfile *> *profiles);
 
 
 /**
 /**
- *  用户的账号类型，必填
+ *  好友操作回调
+ *
+ *  @param result 资料
  */
  */
-@property(nonatomic,strong) NSString * accountType;
+typedef void (^TIMFriendResultSucc)(TIMFriendResult *result);
 
 
 /**
 /**
- *  禁用crash上报，默认上报
+ *  好友操作回调
+ *
+ *  @param results 资料
  */
  */
-@property(nonatomic,assign) BOOL disableCrashReport;
+typedef void (^TIMFriendResultArraySucc)(NSArray<TIMFriendResult *> *results);
 
 
 /**
 /**
- *  禁止在控制台打印log
+ *  检查好友操作回调
+ *
+ *  @param results 检查结果
  */
  */
-@property(nonatomic,assign) BOOL disableLogPrint;
+typedef void (^TIMCheckFriendResultArraySucc)(NSArray<TIMCheckFriendResult *> *results);
 
 
-/**
- *  本地写log文件的等级，默认DEBUG等级
- */
-@property(nonatomic,assign) TIMLogLevel logLevel;
 
 
 /**
 /**
- *  log文件路径，不设置时为默认路径
+ *  群成员列表回调
+ *
+ *  @param members 群成员列表
  */
  */
-@property(nonatomic,strong) NSString * logPath;
+typedef void (^TIMGroupMemberSucc)(NSArray * members);
 
 
 /**
 /**
- *  回调给log函数的log等级，默认DEBUG等级
+ *  群列表回调
+ *
+ *  @param arr 群列表，成员类型 TIMGroupInfo
  */
  */
-@property(nonatomic,assign) TIMLogLevel logFuncLevel;
+typedef void (^TIMGroupListSucc)(NSArray<TIMGroupInfo *> * arr);
 
 
 /**
 /**
- *  log监听函数
+ *  本人群组内成员信息回调
+ *
+ *  @param selfInfo 本人成员信息
  */
  */
-@property(nonatomic,copy) TIMLogFunc logFunc;
+typedef void (^TIMGroupSelfSucc)(TIMGroupMemberInfo * selfInfo);
 
 
 /**
 /**
- *  消息数据库路径，不设置时为默认路径
+ *  群接受消息选项回调
+ *
+ *  @param opt 群接受消息选项
  */
  */
-@property(nonatomic,strong) NSString * dbPath;
+typedef void (^TIMGroupReciveMessageOptSucc)(TIMGroupReceiveMessageOpt opt);
 
 
 /**
 /**
- *  网络监听器
+ *  群成员列表回调（分页使用）
+ *
+ *  @param members 群成员（TIMGroupMemberInfo*）列表
  */
  */
-@property(nonatomic,strong) id<TIMConnListener> connListener;
-
-@end
-
-
-@interface TIMUserConfig : NSObject
+typedef void (^TIMGroupMemberSuccV2)(uint64_t nextSeq, NSArray * members);
 
 
 /**
 /**
- *  禁用本地存储（加载消息扩展包有效）
+ *  群搜索回调
+ *
+ *  @param totalNum 搜索结果的总数
+ *  @param groups  请求的群列表片段
  */
  */
-@property(nonatomic,assign) BOOL disableStorage;
+typedef void (^TIMGroupSearchSucc)(uint64_t totalNum, NSArray * groups);
 
 
 /**
 /**
- *  禁止自动上报（加载消息扩展包有效）
+ *  获取群组未决请求列表成功
+ *
+ *  @param meta       未决请求元信息
+ *  @param pendencies 未决请求列表（TIMGroupPendencyItem）数组
  */
  */
-@property(nonatomic,assign) BOOL disableAutoReport;
+typedef void (^TIMGetGroupPendencyListSucc)(TIMGroupPendencyMeta * meta, NSArray<TIMGroupPendencyItem *> * pendencies);
 
 
 /**
 /**
- *  开启C2C已读回执（加载消息扩展包有效）
+ *  发送消息给多个用户失败
+ *
+ *  @param code 错误码
+ *  @param err  错误信息
+ *  @param detailInfo 错误详情
  */
  */
-@property(nonatomic,assign) BOOL enableReadReceipt;
+typedef void (^TIMSendToUsersFail)(int code, NSString *err, TIMSendToUsersDetailInfo *detailInfo);
 
 
-/**
- *  不开启最近联系人（加载消息扩展包有效）
- */
-@property(nonatomic,assign) BOOL disableRecnetContact;
+#pragma mark - 基本类型
 
 
-/**
- *  不通过onNewMessage:抛出最近联系人的最后一条消息（加载消息扩展包有效）
- */
-@property(nonatomic,assign) BOOL disableRecentContactNotify;
+/// 实现 NSCoding 协议
+@interface TIMCodingModel : NSObject <NSCoding>
 
 
-///**
-// *  开启关系链数据本地缓存功能（加载好友扩展包有效）
-// */
-//@property(nonatomic,assign) BOOL enableFriendshipProxy;
+///读取实例变量，并把这些数据写到 coder 中去，序列化数据
+- (void)encodeWithCoder:(NSCoder *)encoder;
 
 
-///**
-// *  开启群组数据本地缓存功能（加载群组扩展包有效）
-// */
-//@property(nonatomic,assign) BOOL enableGroupAssistant;
+///从 coder 中读取数据，保存到相应的变量中，即反序列化数据
+- (id)initWithCoder:(NSCoder *)decoder;
 
 
-/**
- *  设置默认拉取的群组资料
- */
-@property(nonatomic,strong) TIMGroupInfoOption * groupInfoOpt;
+@end
 
 
-/**
- *  设置默认拉取的群成员资料
- */
-@property(nonatomic,strong) TIMGroupMemberInfoOption * groupMemberInfoOpt;
+/// 初始化 SDK 配置信息
+@interface TIMSdkConfig : NSObject
 
 
-/**
- *  设置默认拉取的好友资料
- */
-@property(nonatomic,strong) TIMFriendProfileOption * friendProfileOpt;
+///用户标识接入 SDK 的应用 ID，必填
+@property(nonatomic,assign) int sdkAppId;
 
 
-/**
- *  用户登录状态监听器
- */
-@property(nonatomic,strong) id<TIMUserStatusListener> userStatusListener;
+///用户的账号类型，新版本不需要再填写
+//@property(nonatomic,strong) NSString * accountType;
 
 
-/**
- *  会话刷新监听器（未读计数、已读同步）（加载消息扩展包有效）
- */
-@property(nonatomic,strong) id<TIMRefreshListener> refreshListener;
-
-/**
- *  消息已读回执监听器（加载消息扩展包有效）
- */
-@property(nonatomic,strong) id<TIMMessageReceiptListener> messageReceiptListener;
+///禁止在控制台打印 log
+@property(nonatomic,assign) BOOL disableLogPrint;
 
 
-/**
- *  消息svr重写监听器（加载消息扩展包有效）
- */
-@property(nonatomic,strong) id<TIMMessageUpdateListener> messageUpdateListener;
+///本地写 log 文件的等级，默认 DEBUG 等级
+@property(nonatomic,assign) TIMLogLevel logLevel;
 
 
-/**
- *  消息撤回监听器（加载消息扩展包有效）
- */
-@property(nonatomic,strong) id<TIMMessageRevokeListener> messageRevokeListener;
+///log 文件路径，不设置时为默认路径，可以通过 TIMManager -> getLogPath 获取 log 路径
+@property(nonatomic,strong) NSString * logPath;
 
 
-/**
- *  文件上传进度监听器
- */
-@property(nonatomic,strong) id<TIMUploadProgressListener> uploadProgressListener;
+///回调给 logFunc 函数的 log 等级，默认 DEBUG 等级
+@property(nonatomic,assign) TIMLogLevel logFuncLevel;
 
 
-/**
- *  群组事件通知监听器
- */
-@property(nonatomic,strong) id<TIMGroupEventListener> groupEventListener;
+///log 监听函数
+@property(nonatomic,copy) TIMLogFunc logFunc;
 
 
-///**
-// *  关系链数据本地缓存监听器（加载好友扩展包、enableFriendshipProxy有效）
-// */
-//@property(nonatomic,strong) id<TIMFriendshipListener> friendshipListener;
+///消息数据库路径，不设置时为默认路径
+@property(nonatomic,strong) NSString * dbPath;
 
 
-///**
-// *  群组据本地缓存监听器（加载群组扩展包、enableGroupAssistant有效）
-// */
-//@property(nonatomic,strong) id<TIMGroupListener> groupListener;
+///网络监听器,监听网络连接成功失败的状态
+@property(nonatomic,strong) id<TIMConnListener> connListener;
 
 
 @end
 @end
 
 
-/**
- *  登陆信息
- */
+/// 设置用户配置信息
+@interface TIMUserConfig : NSObject
+
+///禁用本地存储
+@property(nonatomic,assign) BOOL disableStorage;
+
+///默认情况下，出于性能考虑，当用户在终端 A 收到未读消息后，Server 默认会删除未读消息，但如果用户切换到终端 B 后，IM SDK 无法再同步到未读消息，未读计数也不会增加，如果需要在终端 B 下也有未读，请设置 disableAutoReport 为 YES，这个时候 Server 不会再主动删除未读消息。注意一旦这这样设置，开发者需要主动调用 TIMConversation.h -> setReadMessage ，否则未读消息会一直存在 Server，IM SDK 每次登录或则断网重连都会再次同步到未读消息，详情请参考官方文档 [自动已读上报](https://cloud.tencent.com/document/product/269/9151)。
+@property(nonatomic,assign) BOOL disableAutoReport;
 
 
+///已读回执是自己发出去的消息，对方设置为已读后，自己能收到已读的回调，只针对单聊（C2C）会话生效，默认是关闭的，如果需要开启，请设置 enableReadReceipt 为 YES，收到消息的用户需要显式调用 TIMConversation.h -> setReadMessage，发消息的用户才能通过 TIMMessageReceiptListener 监听到消息的已读回执。
+@property(nonatomic,assign) BOOL enableReadReceipt;
+
+///设置默认拉取的群组资料,当您获取群资料的时候，默认只能拉取内置字段，如果想要拉取自定义字段，首先要通过 [IM 控制台](https://console.cloud.tencent.com/avc) -> 功能配置 -> 群维度自定义字段 配置对应的 "自定义字段" 和用户操作权限，然后设置 IMGroupInfoOption -> groupCustom = @[@"自定义字段名称",...]。
+@property(nonatomic,strong) TIMGroupInfoOption * groupInfoOpt;
+
+///设置默认拉取的群成员资料,当您获取群成员资料的时候，默认只能拉取内置字段，如果想要拉取自定义字段，首先要通过 [IM 控制台](https://console.cloud.tencent.com/avc) -> 功能配置 -> 群成员维度自定义字段配置对应的 "自定义字段" 和用户操作权限，后设置 TIMGroupMemberInfoOption -> memberCustom = @[@"自定义字段名称",...]。
+@property(nonatomic,strong) TIMGroupMemberInfoOption * groupMemberInfoOpt;
+
+///关系链参数
+@property(nonatomic,strong) TIMFriendProfileOption * friendProfileOpt;
+
+///用户登录状态监听器,用于监听用户被踢，断网重连失败，userSig 过期的通知
+@property(nonatomic,weak) id<TIMUserStatusListener> userStatusListener;
+
+///会话刷新监听器，用于监听会话的刷新
+@property(nonatomic,weak) id<TIMRefreshListener> refreshListener;
+
+///消息已读回执监听器，用于监听消息已读回执，enableReadReceipt 字段需要设置为 YES
+@property(nonatomic,weak) id<TIMMessageReceiptListener> messageReceiptListener;
+
+///消息修改监听器，用于监听消息状态的变化
+@property(nonatomic,weak) id<TIMMessageUpdateListener> messageUpdateListener;
+
+///消息撤回监听器，用于监听会话中的消息撤回通知
+@property(nonatomic,weak) id<TIMMessageRevokeListener> messageRevokeListener;
+
+///文件上传进度监听器，发送语音，图片，视频，文件消息的时候需要先上传对应文件到服务器，这里可以监听上传进度
+@property(nonatomic,weak) id<TIMUploadProgressListener> uploadProgressListener;
+
+///群组事件通知监听器
+@property(nonatomic,weak) id<TIMGroupEventListener> groupEventListener;
+
+///关系链数据本地缓存监听器
+@property(nonatomic,weak) id<TIMFriendshipListener> friendshipListener;
+
+@end
+
+/// 登录参数
 @interface TIMLoginParam : NSObject
 @interface TIMLoginParam : NSObject
 
 
-/**
- * 用户名
- */
+///用户名
 @property(nonatomic,strong) NSString* identifier;
 @property(nonatomic,strong) NSString* identifier;
 
 
-/**
- *  鉴权Token
- */
+///鉴权 Token
 @property(nonatomic,strong) NSString* userSig;
 @property(nonatomic,strong) NSString* userSig;
 
 
-/**
- *  App用户使用OAuth授权体系分配的Appid
- */
+///App 用户使用 OAuth 授权体系分配的 Appid
 @property(nonatomic,strong) NSString* appidAt3rd;
 @property(nonatomic,strong) NSString* appidAt3rd;
 
 
 
 
 @end
 @end
 
 
-/**
- *  APNs 配置
- */
+/// APNs 配置
 @interface TIMAPNSConfig : NSObject
 @interface TIMAPNSConfig : NSObject
-/**
- *  是否开启推送：0-不进行设置 1-开启推送 2-关闭推送
- */
+
+///是否开启推送：0-不进行设置 1-开启推送 2-关闭推送
 @property(nonatomic,assign) uint32_t openPush;
 @property(nonatomic,assign) uint32_t openPush;
-/**
- *  C2C消息声音,不设置传入nil
- */
+
+///C2C 消息声音,不设置传入 nil
 @property(nonatomic,strong) NSString * c2cSound;
 @property(nonatomic,strong) NSString * c2cSound;
 
 
-/**
- *  Group消息声音,不设置传入nil
- */
+///Group 消息声音,不设置传入 nil
 @property(nonatomic,strong) NSString * groupSound;
 @property(nonatomic,strong) NSString * groupSound;
 
 
-/**
- *  Video声音,不设置传入nil
- */
+///Video 音视频邀请声音,不设置传入 nil (暂不支持)
 @property(nonatomic,strong) NSString * videoSound;
 @property(nonatomic,strong) NSString * videoSound;
 
 
 @end
 @end
 
 
-/**
- *  SetToken 参数
- */
+/// SetToken 参数
 @interface TIMTokenParam : NSObject
 @interface TIMTokenParam : NSObject
-/**
- *  获取的客户端Token信息
- */
+
+///token 是苹果后台对客户端的唯一标识，需要主动调用系统 API 向苹果请求获取
 @property(nonatomic,strong) NSData* token;
 @property(nonatomic,strong) NSData* token;
-/**
- *  业务ID，传递证书时分配
- */
+
+///业务 ID，传递证书时分配
 @property(nonatomic,assign) uint32_t busiId;
 @property(nonatomic,assign) uint32_t busiId;
 
 
 @end
 @end
 
 
-
-/**
- *  切后台参数
- */
+/// 切后台参数
 @interface TIMBackgroundParam : NSObject
 @interface TIMBackgroundParam : NSObject
 
 
-/**
- *  C2C 未读计数
- */
+///C2C 未读计数
 @property(nonatomic,assign) int c2cUnread;
 @property(nonatomic,assign) int c2cUnread;
 
 
-/**
- *  群 未读计数
- */
+///群未读计数
 @property(nonatomic,assign) int groupUnread;
 @property(nonatomic,assign) int groupUnread;
 
 
 @end
 @end
 
 
+/// 消息定位
 @interface TIMMessageLocator : NSObject
 @interface TIMMessageLocator : NSObject
-/**
- *  所属会话的id
- */
+
+///所属会话的 id
 @property(nonatomic,strong) NSString * sessId;
 @property(nonatomic,strong) NSString * sessId;
-/**
- *  所属会话的类型
- */
+
+///所属会话的类型
 @property(nonatomic,assign) TIMConversationType sessType;
 @property(nonatomic,assign) TIMConversationType sessType;
-/**
- *  消息序列号
- */
+
+///消息序列号
 @property(nonatomic,assign) uint64_t seq;
 @property(nonatomic,assign) uint64_t seq;
-/**
- *  消息随机码
- */
+
+///消息随机码
 @property(nonatomic,assign) uint64_t rand;
 @property(nonatomic,assign) uint64_t rand;
-/**
- *  消息时间戳
- */
+
+///消息时间戳
 @property(nonatomic,assign) time_t time;
 @property(nonatomic,assign) time_t time;
-/**
- *  是否本人消息
- */
+
+///是否本人消息
 @property(nonatomic,assign) BOOL isSelf;
 @property(nonatomic,assign) BOOL isSelf;
 
 
-/**
- *  是否来自撤销通知
- */
+///是否来自撤销通知
 @property(nonatomic,assign) BOOL isFromRevokeNotify;
 @property(nonatomic,assign) BOOL isFromRevokeNotify;
 
 
 @end
 @end
 
 
-/**
- *  已读回执
- */
+/// 已读回执
 @interface TIMMessageReceipt : NSObject
 @interface TIMMessageReceipt : NSObject
-/**
- *  已读回执对应的会话（目前只支持C2C会话）
- */
+
+///已读回执对应的会话（目前只支持 C2C 会话）
 @property(nonatomic,strong) TIMConversation * conversation;
 @property(nonatomic,strong) TIMConversation * conversation;
-/**
- *  收到已读回执时，这个时间戳之前的消息都已读
- */
+
+///收到已读回执时，这个时间戳之前的消息都已读
 @property(nonatomic,assign) time_t timestamp;
 @property(nonatomic,assign) time_t timestamp;
 @end
 @end
 
 
+/// Android 离线推送配置
 @interface TIMAndroidOfflinePushConfig : NSObject
 @interface TIMAndroidOfflinePushConfig : NSObject
-/**
- *  离线推送时展示标签
- */
+
+///离线推送时展示标签
 @property(nonatomic,strong) NSString * title;
 @property(nonatomic,strong) NSString * title;
-/**
- *  Android离线Push时声音字段信息
- */
+
+///Android 离线 Push 时声音字段信息
 @property(nonatomic,strong) NSString * sound;
 @property(nonatomic,strong) NSString * sound;
-/**
- *  离线推送时通知形式
- */
+
+///离线推送时通知形式
 @property(nonatomic,assign) TIMAndroidOfflinePushNotifyMode notifyMode;
 @property(nonatomic,assign) TIMAndroidOfflinePushNotifyMode notifyMode;
 
 
 @end
 @end
 
 
+/// iOS 离线推送配置
 @interface TIMIOSOfflinePushConfig : NSObject
 @interface TIMIOSOfflinePushConfig : NSObject
-/**
- *  离线Push时声音字段信息
- */
+
+///离线 Push 时声音字段信息
 @property(nonatomic,strong) NSString * sound;
 @property(nonatomic,strong) NSString * sound;
-/**
- *  忽略badge计数
- */
+
+///忽略 badge 计数
 @property(nonatomic,assign) BOOL ignoreBadge;
 @property(nonatomic,assign) BOOL ignoreBadge;
 
 
 @end
 @end
 
 
+/// 填入 sound 字段表示接收时不会播放声音
+extern NSString * const kIOSOfflinePushNoSound;
+
+/// 自定义消息 push
+@interface TIMOfflinePushInfo : NSObject
+
+///自定义消息描述信息，做离线Push时文本展示
+@property(nonatomic,strong) NSString * desc;
+
+///离线 Push 时扩展字段信息
+@property(nonatomic,strong) NSString * ext;
+
+///推送规则标志
+@property(nonatomic,assign) TIMOfflinePushFlag pushFlag;
+
+///iOS离线推送配置
+@property(nonatomic,strong) TIMIOSOfflinePushConfig * iosConfig;
+
+///Android离线推送配置
+@property(nonatomic,strong) TIMAndroidOfflinePushConfig * androidConfig;
+@end
+
+/// 群组内的本人信息
+@interface TIMGroupSelfInfo : NSObject
+
+///加入群组时间
+@property(nonatomic,assign) uint32_t joinTime;
+
+///群组中的角色
+@property(nonatomic,assign) TIMGroupMemberRole role;
+
+///群组消息接收选项
+@property(nonatomic,assign) TIMGroupReceiveMessageOpt recvOpt;
+
+///群组中的未读消息数
+@property(nonatomic,assign) uint32_t unReadMessageNum;
+
+@end
+
+/// 群资料信息
+@interface TIMGroupInfo : TIMCodingModel
+
+///群组 Id
+@property(nonatomic,strong) NSString* group;
+
+///群名
+@property(nonatomic,strong) NSString* groupName;
+
+///群创建人/管理员
+@property(nonatomic,strong) NSString * owner;
+
+///群类型：Private,Public,ChatRoom
+@property(nonatomic,strong) NSString* groupType;
+
+///群创建时间
+@property(nonatomic,assign) uint32_t createTime;
+
+///最近一次群资料修改时间
+@property(nonatomic,assign) uint32_t lastInfoTime;
+
+///最近一次发消息时间
+@property(nonatomic,assign) uint32_t lastMsgTime;
+
+///最大成员数
+@property(nonatomic,assign) uint32_t maxMemberNum;
+
+///群成员数量
+@property(nonatomic,assign) uint32_t memberNum;
+
+///入群类型
+@property(nonatomic,assign) TIMGroupAddOpt addOpt;
+
+///群公告
+@property(nonatomic,strong) NSString* notification;
+
+///群简介
+@property(nonatomic,strong) NSString* introduction;
+
+///群头像
+@property(nonatomic,strong) NSString* faceURL;
+
+///最后一条消息
+@property(nonatomic,strong) TIMMessage* lastMsg;
+
+///在线成员数量
+@property(nonatomic,assign) uint32_t onlineMemberNum;
+
+///群组是否被搜索类型
+@property(nonatomic,assign) TIMGroupSearchableType isSearchable;
+
+///群组成员可见类型
+@property(nonatomic,assign) TIMGroupMemberVisibleType isMemberVisible;
+
+///是否全员禁言
+@property(nonatomic,assign) BOOL allShutup;
+
+///群组中的本人信息
+@property(nonatomic,strong) TIMGroupSelfInfo* selfInfo;
+
+///自定义字段集合,key 是 NSString* 类型,value 是 NSData* 类型
+@property(nonatomic,strong) NSDictionary<NSString *,NSData *>* customInfo;
+
+@end
+
+/// 事件上报信息
+@interface TIMEventReportItem : NSObject
+
+///事件 id
+@property(nonatomic,assign) uint32_t event;
+
+///错误码
+@property(nonatomic,assign) uint32_t code;
+
+///错误描述
+@property(nonatomic,strong) NSString * desc;
+
+///事件延迟（单位 ms）
+@property(nonatomic,assign) uint32_t delay;
+
+@end
+
+/// 获取某个群组资料
+@interface TIMGroupInfoOption : NSObject
+
+///需要获取的群组信息标志（TIMGetGroupBaseInfoFlag）,默认为0xffffff
+@property(nonatomic,assign) uint64_t groupFlags;
+
+///需要获取群组资料的自定义信息（NSString*）列表
+@property(nonatomic,strong) NSArray * groupCustom;
+
+@end
+
+/// 需要某个群成员资料
+@interface TIMGroupMemberInfoOption : NSObject
+
+///需要获取的群成员标志（TIMGetGroupMemInfoFlag）,默认为0xffffff
+@property(nonatomic,assign) uint64_t memberFlags;
+
+///需要获取群成员资料的自定义信息（NSString*）列表
+@property(nonatomic,strong) NSArray * memberCustom;
+
+@end
+
+/// 群成员资料
+@interface TIMGroupMemberInfo : TIMCodingModel
+
+///成员
+@property(nonatomic,strong) NSString* member;
+
+///群名片
+@property(nonatomic,strong) NSString* nameCard;
+
+///加入群组时间
+@property(nonatomic,assign) time_t joinTime;
+
+///成员类型
+@property(nonatomic,assign) TIMGroupMemberRole role;
+
+///禁言结束时间（时间戳）
+@property(nonatomic,assign) uint32_t silentUntil;
+
+///自定义字段集合,key 是 NSString*类型,value 是 NSData*类型
+@property(nonatomic,strong) NSDictionary* customInfo;
+
+@end
+
+///资料与关系链
+@interface TIMFriendProfileOption : NSObject
+
+///关系链最大缓存时间(默认缓存一天；获取资料和关系链超过缓存时间，将自动向服务器发起请求)
+@property NSInteger expiredSeconds;
+
+@end
+
+///用户资料
+@interface TIMUserProfile : TIMCodingModel
+
 /**
 /**
- *  群组内的本人信息
+ *  用户 identifier
  */
  */
-@interface TIMGroupSelfInfo : NSObject
+@property(nonatomic,strong) NSString* identifier;
 
 
 /**
 /**
- *  加入群组时间
+ *  用户昵称
  */
  */
-@property(nonatomic,assign) uint32_t joinTime;
+@property(nonatomic,strong) NSString* nickname;
 
 
 /**
 /**
- *  群组中的角色
+ *  好友验证方式
  */
  */
-@property(nonatomic,assign) TIMGroupMemberRole role;
+@property(nonatomic,assign) TIMFriendAllowType allowType;
 
 
 /**
 /**
- *  群组消息接收选项
+ * 用户头像
  */
  */
-@property(nonatomic,assign) TIMGroupReceiveMessageOpt recvOpt;
+@property(nonatomic,strong) NSString* faceURL;
 
 
 /**
 /**
- *  群组中的未读消息数
+ *  用户签名
  */
  */
-@property(nonatomic,assign) uint32_t unReadMessageNum;
+@property(nonatomic,strong) NSData* selfSignature;
 
 
-@end
+/**
+ *  用户性别
+ */
+@property(nonatomic,assign) TIMGender gender;
 
 
 /**
 /**
- *  群资料信息
+ *  用户生日
  */
  */
-@interface TIMGroupInfo : TIMCodingModel
+@property(nonatomic,assign) uint32_t birthday;
 
 
 /**
 /**
- *  群组Id
+ *  用户区域
  */
  */
-@property(nonatomic,strong) NSString* group;
+@property(nonatomic,strong) NSData* location;
+
 /**
 /**
- *  群名
+ *  用户语言
  */
  */
-@property(nonatomic,strong) NSString* groupName;
+@property(nonatomic,assign) uint32_t language;
+
 /**
 /**
- *  群创建人/管理员
+ *  等级
  */
  */
-@property(nonatomic,strong) NSString * owner;
+@property(nonatomic,assign) uint32_t level;
+
 /**
 /**
- *  群类型：Private,Public,ChatRoom
+ *  角色
  */
  */
-@property(nonatomic,strong) NSString* groupType;
+@property(nonatomic,assign) uint32_t role;
+
 /**
 /**
- *  群创建时间
+ *  自定义字段集合,key是NSString类型,value是NSData类型或者NSNumber类型
+ *  key值按照后台配置的字符串传入,不包括 TIMProfileTypeKey_Custom_Prefix 前缀
  */
  */
-@property(nonatomic,assign) uint32_t createTime;
+@property(nonatomic,strong) NSDictionary* customInfo;
+
+@end
+
+typedef void(^ProfileCallBack) (TIMUserProfile * proflie);
+
 /**
 /**
- *  最近一次群资料修改时间
+ *  好友
  */
  */
-@property(nonatomic,assign) uint32_t lastInfoTime;
+@interface TIMFriend : TIMCodingModel
+
 /**
 /**
- *  最近一次发消息时间
+ *  好友identifier
  */
  */
-@property(nonatomic,assign) uint32_t lastMsgTime;
+@property(nonatomic,strong) NSString *identifier;
+
 /**
 /**
- *  最大成员数
+ *  好友备注（最大96字节，获取自己资料时，该字段为空）
  */
  */
-@property(nonatomic,assign) uint32_t maxMemberNum;
+@property(nonatomic,strong) NSString *remark;
+
 /**
 /**
- *  群成员数量
+ *  分组名称 NSString* 列表
  */
  */
-@property(nonatomic,assign) uint32_t memberNum;
+@property(nonatomic,strong) NSArray *groups;
 
 
 /**
 /**
- *  入群类型
+ *  申请时的添加理由
  */
  */
-@property(nonatomic,assign) TIMGroupAddOpt addOpt;
+@property(nonatomic,strong) NSString *addWording;
 
 
 /**
 /**
- *  群公告
+ *  申请时的添加来源
  */
  */
-@property(nonatomic,strong) NSString* notification;
+@property(nonatomic,strong) NSString *addSource;
 
 
 /**
 /**
- *  群简介
+ * 添加时间
  */
  */
-@property(nonatomic,strong) NSString* introduction;
+@property(nonatomic,assign) uint64_t addTime;
 
 
 /**
 /**
- *  群头像
+ *  自定义字段集合,key是NSString类型,value是NSData类型或者NSNumber类型
+ *  key值按照后台配置的字符串传入,不包括 TIMFriendTypeKey_Custom_Prefix 前缀
  */
  */
-@property(nonatomic,strong) NSString* faceURL;
+@property(nonatomic,strong) NSDictionary* customInfo;
 
 
 /**
 /**
- *  最后一条消息
+ * 好友资料
  */
  */
-@property(nonatomic,strong) TIMMessage* lastMsg;
+@property(nonatomic,strong) TIMUserProfile *profile;
+
+@end
 
 
 /**
 /**
- *  在线成员数量
+ *  创建群参数
  */
  */
-@property(nonatomic,assign) uint32_t onlineMemberNum;
+@interface TIMCreateGroupInfo : TIMCodingModel
 
 
 /**
 /**
- *  群组是否被搜索类型
+ *  群组Id,nil则使用系统默认Id
  */
  */
-@property(nonatomic,assign) TIMGroupSearchableType isSearchable;
+@property(nonatomic,strong) NSString* group;
 
 
 /**
 /**
- *  群组成员可见类型
+ *  群名
  */
  */
-@property(nonatomic,assign) TIMGroupMemberVisibleType isMemberVisible;
+@property(nonatomic,strong) NSString* groupName;
 
 
 /**
 /**
- 是否全员禁言
+ *  群类型：Private,Public,ChatRoom,AVChatRoom,BChatRoom
  */
  */
-@property(nonatomic,assign) BOOL allShutup;
+@property(nonatomic,strong) NSString* groupType;
 
 
 /**
 /**
- *  群组中的本人信息
+ *  是否设置入群选项，Private类型群组请设置为false
  */
  */
-@property(nonatomic,strong) TIMGroupSelfInfo* selfInfo;
+@property(nonatomic,assign) BOOL setAddOpt;
 
 
 /**
 /**
- *  自定义字段集合,key是NSString*类型,value是NSData*类型
+ *  入群选项
  */
  */
-@property(nonatomic,strong) NSDictionary* customInfo;
+@property(nonatomic,assign) TIMGroupAddOpt addOpt;
 
 
-@end
+/**
+ *  最大成员数，填0则系统使用默认值
+ */
+@property(nonatomic,assign) uint32_t maxMemberNum;
 
 
 /**
 /**
- *  事件上报信息
+ *  群公告
  */
  */
-@interface TIMEventReportItem : NSObject
+@property(nonatomic,strong) NSString* notification;
+
 /**
 /**
- *  事件id
+ *  群简介
  */
  */
-@property(nonatomic,assign) uint32_t event;
+@property(nonatomic,strong) NSString* introduction;
+
 /**
 /**
- *  错误码
+ *  群头像
  */
  */
-@property(nonatomic,assign) uint32_t code;
+@property(nonatomic,strong) NSString* faceURL;
+
 /**
 /**
- *  错误描述
+ *  自定义字段集合,key是NSString*类型,value是NSData*类型
  */
  */
-@property(nonatomic,strong) NSString * desc;
+@property(nonatomic,strong) NSDictionary* customInfo;
+
 /**
 /**
- *  事件延迟（单位ms）
+ *  创建成员（TIMCreateGroupMemberInfo*）列表
  */
  */
-@property(nonatomic,assign) uint32_t delay;
+@property(nonatomic,strong) NSArray <TIMCreateGroupMemberInfo *>* membersInfo;
 
 
 @end
 @end
 
 
-@interface TIMGroupInfoOption : NSObject
-
 /**
 /**
- *  需要获取的群组信息标志（TIMGetGroupBaseInfoFlag）,默认为0xffffff
+ * 未决请求选项
  */
  */
-@property(nonatomic,assign) uint64_t groupFlags;
+@interface TIMGroupPendencyOption : TIMCodingModel
 
 
 /**
 /**
- *  需要获取群组资料的自定义信息（NSString*）列表
+ *  拉取的起始时间 0：拉取最新的
  */
  */
-@property(nonatomic,strong) NSArray * groupCustom;
+@property(nonatomic,assign) uint64_t timestamp;
 
 
+/**
+ *  每页的数量
+ */
+@property(nonatomic,assign) uint32_t numPerPage;
 @end
 @end
 
 
-@interface TIMGroupMemberInfoOption : NSObject
+/**
+ *  未决请求元信息
+ */
+@interface TIMGroupPendencyMeta : TIMCodingModel
 
 
 /**
 /**
- *  需要获取的群成员标志（TIMGetGroupMemInfoFlag）,默认为0xffffff
+ *  下一次拉取的起始时间戳
  */
  */
-@property(nonatomic,assign) uint64_t memberFlags;
+@property(nonatomic,assign) uint64_t nextStartTime;
 
 
 /**
 /**
- *  需要获取群成员资料的自定义信息（NSString*）列表
+ *  已读时间戳大小
  */
  */
-@property(nonatomic,strong) NSArray * memberCustom;
+@property(nonatomic,assign) uint64_t readTimeSeq;
+
+/**
+ *  未决未读数
+ */
+@property(nonatomic,assign) uint32_t unReadCnt;
 
 
 @end
 @end
 
 
 /**
 /**
- *  成员操作返回值
+ *  创建群组时的成员信息
  */
  */
-@interface TIMGroupMemberInfo : TIMCodingModel
+@interface TIMCreateGroupMemberInfo : TIMCodingModel
 
 
 /**
 /**
  *  被操作成员
  *  被操作成员
@@ -1160,127 +1624,176 @@ typedef void (^TIMGetProfileSucc)(TIMUserProfile * profile);
 @property(nonatomic,strong) NSString* member;
 @property(nonatomic,strong) NSString* member;
 
 
 /**
 /**
- *  群名片
+ *  成员类型
  */
  */
-@property(nonatomic,strong) NSString* nameCard;
+@property(nonatomic,assign) TIMGroupMemberRole role;
 
 
 /**
 /**
- *  加入群组时间
+ *  自定义字段集合,key是NSString*类型,value是NSData*类型
  */
  */
-@property(nonatomic,assign) time_t joinTime;
+@property(nonatomic,strong) NSDictionary* customInfo;
+
+@end
 
 
 /**
 /**
- *  成员类型
+ *  成员操作返回值
  */
  */
-@property(nonatomic,assign) TIMGroupMemberRole role;
+@interface TIMGroupMemberResult : NSObject
 
 
 /**
 /**
- *  禁言结束时间（时间戳）
+ *  被操作成员
  */
  */
-@property(nonatomic,assign) uint32_t silentUntil;
-
+@property(nonatomic,strong) NSString* member;
 /**
 /**
- *  自定义字段集合,key是NSString*类型,value是NSData*类型
+ *  返回状态
  */
  */
-@property(nonatomic,strong) NSDictionary* customInfo;
+@property(nonatomic,assign) TIMGroupMemberStatus status;
 
 
 @end
 @end
 
 
-@interface TIMFriendProfileOption : NSObject
-
 /**
 /**
- *  需要获取的好友信息标志（TIMProfileFlag）,默认为0xffffff
+ *  未决申请
  */
  */
-@property(nonatomic,assign) uint64_t friendFlags;
+@interface TIMGroupPendencyItem : TIMCodingModel
 
 
 /**
 /**
- *  需要获取的好友自定义信息（NSString*）列表
+ *  相关群组id
  */
  */
-@property(nonatomic,strong) NSArray * friendCustom;
+@property(nonatomic,strong) NSString* groupId;
 
 
 /**
 /**
- *  需要获取的用户自定义信息（NSString*）列表
+ *  请求者id，请求加群:请求者，邀请加群:邀请人
  */
  */
-@property(nonatomic,strong) NSArray * userCustom;
+@property(nonatomic,strong) NSString* fromUser;
 
 
-@end
+/**
+ *  判决者id，请求加群:0，邀请加群:被邀请人
+ */
+@property(nonatomic,strong) NSString* toUser;
 
 
 /**
 /**
- *  好友资料
+ *  未决添加时间
  */
  */
-@interface TIMUserProfile : TIMCodingModel
+@property(nonatomic,assign) uint64_t addTime;
 
 
 /**
 /**
- *  用户identifier
+ *  未决请求类型
  */
  */
-@property(nonatomic,strong) NSString* identifier;
+@property(nonatomic,assign) TIMGroupPendencyGetType getType;
 
 
 /**
 /**
- *  用户昵称
+ *  已决标志
  */
  */
-@property(nonatomic,strong) NSString* nickname;
+@property(nonatomic,assign) TIMGroupPendencyHandleStatus handleStatus;
 
 
 /**
 /**
- *  用户备注（最大96字节，获取自己资料时，该字段为空）
+ *  已决结果
  */
  */
-@property(nonatomic,strong) NSString* remark;
+@property(nonatomic,assign) TIMGroupPendencyHandleResult handleResult;
 
 
 /**
 /**
- *  好友验证方式
+ *  申请或邀请附加信息
  */
  */
-@property(nonatomic,assign) TIMFriendAllowType allowType;
+@property(nonatomic,strong) NSString* requestMsg;
 
 
 /**
 /**
- * 用户头像
+ *  审批信息：同意或拒绝信息
  */
  */
-@property(nonatomic,strong) NSString* faceURL;
+@property(nonatomic,strong) NSString* handledMsg;
+
 
 
 /**
 /**
- *  用户签名
+ *  同意申请
+ *
+ *  @param msg      同意理由，选填
+ *  @param succ     成功回调
+ *  @param fail     失败回调，返回错误码和错误描述
  */
  */
-@property(nonatomic,strong) NSData* selfSignature;
+-(void) accept:(NSString*)msg succ:(TIMSucc)succ fail:(TIMFail)fail;
 
 
 /**
 /**
- *  好友性别
+ *  拒绝申请
+ *
+ *  @param msg      拒绝理由，选填
+ *  @param succ     成功回调
+ *  @param fail     失败回调，返回错误码和错误描述
  */
  */
-@property(nonatomic,assign) TIMGender gender;
+-(void) refuse:(NSString*)msg succ:(TIMSucc)succ fail:(TIMFail)fail;
+
 
 
 /**
 /**
- *  好友生日
+ *  用户自己的id
  */
  */
-@property(nonatomic,assign) uint32_t birthday;
+@property(nonatomic,strong) NSString* selfIdentifier;
+
+@end
 
 
 /**
 /**
- *  好友区域
+ *  关系链变更详细信息
  */
  */
-@property(nonatomic,strong) NSData* location;
+@interface TIMSNSChangeInfo : NSObject
 
 
 /**
 /**
- *  好友语言
+ *  用户 identifier
  */
  */
-@property(nonatomic,assign) uint32_t language;
+@property(nonatomic,strong) NSString * identifier;
 
 
 /**
 /**
- *  等级
+ *  用户昵称
  */
  */
-@property(nonatomic,assign) uint32_t level;
+@property(nonatomic,strong) NSString * nickname;
 
 
 /**
 /**
- *  角色
+ *  申请添加时有效，添加理由
  */
  */
-@property(nonatomic,assign) uint32_t role;
+@property(nonatomic,strong) NSString * wording;
 
 
 /**
 /**
- *  好友分组名称 NSString* 列表
+ *  申请时填写，添加来源
  */
  */
-@property(nonatomic,strong) NSArray* friendGroups;
+@property(nonatomic,strong) NSString * source;
+
 
 
 /**
 /**
- *  自定义字段集合,key是NSString类型,value是NSData类型或者NSNumber类型
- *  (key值按照后台配置的字符串传入)
+ *  备注 type=TIM_SNS_SYSTEM_SNS_PROFILE_CHANGE 有效
  */
  */
-@property(nonatomic,strong) NSDictionary* customInfo;
+@property(nonatomic,strong) NSString * remark;
+
+@end
 
 
+/**
+ *  发送消息给多用户的失败回调信息
+ */
+@interface TIMSendToUsersDetailInfo : NSObject
+/**
+ *  发送消息成功的目标用户数
+ */
+@property(nonatomic,assign) uint32_t succCnt;
+/**
+ *  发送消息失败的目标用户数
+ */
+@property(nonatomic,assign) uint32_t failCnt;
+/**
+ *  失败信息（TIMSendToUsersErrInfo*）列表
+ */
+@property(nonatomic,strong) NSArray *errInofs;
 @end
 @end
 
 
+/**
+ *  发送消息给多用户的失败信息
+ */
+@interface TIMSendToUsersErrInfo : NSObject
+/**
+ *  发送消息失败的目标用户id
+ */
+@property(nonatomic,strong) NSString *identifier;
+/**
+ *  错误码
+ */
+@property(nonatomic,assign) int code;
+/**
+ *  错误描述
+ */
+@property(nonatomic,strong) NSString *err;
+@end
 #endif
 #endif

+/////////////////////////////////////////////////////////////////////
 //
 //
-//  TIMConversation+MsgExt.h
-//  IMMessageExt
+//                     腾讯云通信服务 IMSDK
 //
 //
-//  Created by tomzhu on 2016/12/27.
+//  模块名称：TIMConversation + MsgExt
 //
 //
+//  模块功能：此处主要存放待废弃的 API 函数，建议您使用 TIMConversation.h 内部声明的接口函数
 //
 //
+/////////////////////////////////////////////////////////////////////
 
 
 #ifndef TIMConversation_h
 #ifndef TIMConversation_h
 #define TIMConversation_h
 #define TIMConversation_h
+#import "TIMConversation.h"
 
 
-#import "ImSDK.h"
-#import "TIMMessage+MsgExt.h"
 
 
 @interface TIMConversation (MsgExt)
 @interface TIMConversation (MsgExt)
 
 
 /**
 /**
- *  保存消息到消息列表，这里只保存在本地
+ *  向前获取会话漫游消息
  *
  *
- *  @param msg 消息体
- *  @param sender 发送方
- *  @param isReaded 是否已读，如果发送方是自己，默认已读
- *
- *  @return 0 成功
- */
-- (int)saveMessage:(TIMMessage*)msg sender:(NSString*)sender isReaded:(BOOL)isReaded;
-
-/**
- *  获取会话消息
- *
- *  @param count 获取数量
- *  @param last  上次最后一条消息
- *  @param succ  成功时回调
- *  @param fail  失败时回调
- *
- *  @return 0 本次操作成功
- */
-- (int)getMessage:(int)count last:(TIMMessage*)last succ:(TIMGetMsgSucc)succ fail:(TIMFail)fail;
-
-/**
- *  向前获取会话消息
+ *  调用方式和 getMessage 一样，区别是 getMessage 获取的是时间更老的消息，主要用于下拉 Tableview 刷新消息数据，getMessageForward 获取的是时间更新的消息，主要用于上拉 Tableview 刷新消息数据。
  *
  *
  *  @param count 获取数量
  *  @param count 获取数量
- *  @param last  上次最后一条消息
+ *  @param last  上次最后一条消息，如果 last 为 nil，从最新的消息开始读取
  *  @param succ  成功时回调
  *  @param succ  成功时回调
  *  @param fail  失败时回调
  *  @param fail  失败时回调
  *
  *
- *  @return 0 本次操作成功
+ *  @return 0：本次操作成功；1：本次操作失败
  */
  */
 - (int)getMessageForward:(int)count last:(TIMMessage*)last succ:(TIMGetMsgSucc)succ fail:(TIMFail)fail;
 - (int)getMessageForward:(int)count last:(TIMMessage*)last succ:(TIMGetMsgSucc)succ fail:(TIMFail)fail;
 
 
 /**
 /**
- *  获取本地会话消息
- *
- *  @param count 获取数量
- *  @param last  上次最后一条消息
- *  @param succ  成功时回调
- *  @param fail  失败时回调
- *
- *  @return 0 本次操作成功
- */
-- (int)getLocalMessage:(int)count last:(TIMMessage*)last succ:(TIMGetMsgSucc)succ fail:(TIMFail)fail;
-
-/**
- *  获取会话消息
+ *  获取指定会话消息
  *
  *
  *  @param locators 消息定位符（TIMMessageLocator）数组
  *  @param locators 消息定位符（TIMMessageLocator）数组
  *  @param succ  成功时回调
  *  @param succ  成功时回调
  *  @param fail  失败时回调
  *  @param fail  失败时回调
  *
  *
- *  @return 0 本次操作成功
+ *  @return 0：本次操作成功；1：本次操作失败
  */
  */
 - (int)findMessages:(NSArray*)locators succ:(TIMGetMsgSucc)succ fail:(TIMFail)fail;
 - (int)findMessages:(NSArray*)locators succ:(TIMGetMsgSucc)succ fail:(TIMFail)fail;
 
 
 /**
 /**
- *  撤回消息（仅C2C和GROUP会话有效、onlineMessage无效、AVChatRoom和BChatRoom无效）
- *
- *  @param msg   被撤回的消息
- *  @param succ  成功时回调
- *  @param fail  失败时回调
- *
- *  @return 0 本次操作成功
- */
-- (int)revokeMessage:(TIMMessage*)msg succ:(TIMSucc)succ fail:(TIMFail)fail;
-
-/**
- *  同步本会话的消息撤回通知（仅GROUP会话有效）
+ *  获取自己的 id
  *
  *
- *  @param succ  成功时回调，同步的通知会通过TIMMessageRevokeListener抛出
- *  @param fail  失败时回调
- *
- *  @return 0 本次操作成功
- */
-- (int)syncRevokeNotify:(TIMSucc)succ fail:(TIMFail)fail;
-
-/**
- *  删除本地会话消息
- *
- *  @param succ  成功时回调
- *  @param fail  失败时回调
- *
- *  @return 0 本次操作成功
- */
-- (int)deleteLocalMessage:(TIMSucc)succ fail:(TIMFail)fail;
-
-/**
- *  设置已读消息
- *
- *  @param readed 会话内最近一条已读的消息，nil表示上报最新消息
- *
- *  @param succ  成功时回调
- *  @param fail  失败时回调
- *
- *  @return 0 表示成功
- */
-- (int)setReadMessage:(TIMMessage*)readed succ:(TIMSucc)succ fail:(TIMFail)fail;
-
-/**
- *  获取该会话的未读计数
- *
- *  @return 返回未读计数
- */
-- (int)getUnReadMessageNum;
-
-/**
- *  获取最后一条消息
- *
- *  @return 最后一条消息
- */
-- (TIMMessage*)getLastMsg;
-
-/**
- *  将消息导入本地数据库
- *
- *  @param msgs 消息（TIMMessage*）列表
- *
- *  @return 0 成功
- */
-- (int)importMessages:(NSArray*)msgs;
-
-/**
- *  设置会话草稿
- *
- *  @param draft 草稿内容
- *
- *  @return 0 成功
- */
-- (int)setDraft:(TIMMessageDraft*)draft;
-
-/**
- *  获取会话草稿
- *
- *  @return 草稿内容，没有草稿返回nil
- */
-- (TIMMessageDraft*)getDraft;
-
-/**
- * 禁用本会话的存储，只对当前初始化有效，重启后需要重新设置
- * 需要 initSdk 之后调用
+ *  @return 用户 id
  */
  */
-- (void)disableStorage;
+- (NSString*)getSelfIdentifier;
 
 
 @end
 @end
 
 

+/////////////////////////////////////////////////////////////////////
 //
 //
-//  TIMConversation.h
-//  ImSDK
+//                     腾讯云通信服务 IMSDK
 //
 //
-//  Created by bodeng on 28/1/15.
-//  Copyright (c) 2015 tencent. All rights reserved.
+//  模块名称：TIMConversation 会话模块
 //
 //
+//  模块功能：一个会话对应一个聊天窗口，比如跟一个好友的 C2C 聊天叫做一个会话，一个聊天群也叫做一个会话。
+//     
+//  TIMConversation 提供的接口函数都是围绕消息的相关操作，包括：消息发送、获取历史消息、设置消息已读设置、撤回和删除等等。
+//
+/////////////////////////////////////////////////////////////////////
 
 
 #ifndef ImSDK_TIMConversation_h
 #ifndef ImSDK_TIMConversation_h
 #define ImSDK_TIMConversation_h
 #define ImSDK_TIMConversation_h
 
 
 #import "TIMComm.h"
 #import "TIMComm.h"
 #import "TIMCallback.h"
 #import "TIMCallback.h"
+#import "TIMMessage.h"
 
 
 @class TIMMessage;
 @class TIMMessage;
 
 
-/**
- *  会话
- */
 @interface TIMConversation : NSObject
 @interface TIMConversation : NSObject
 
 
+#pragma mark 一，发消息
+
+/////////////////////////////////////////////////////////////////////////////////
+//
+//                      （一）发消息
+//
+/////////////////////////////////////////////////////////////////////////////////
+/// @name 发消息相关接口
+/// @{
 /**
 /**
- *  发送消息
+ *  1.1 发送消息
+ *
+ *  TIMMessage 由多个 TIMElem 组成，一个 TIMElem 可以是一串文本，也可以是一张图片。
+ *  虽然说每一条消息都可以包含多个 TIMElem，但这个并不常用，通常您只需要在一个 TIMMessage 塞入一个 TIMElem 即可。
+ *
+ *  详情请参考官网文档 [消息收发](https://cloud.tencent.com/document/product/269/9150)
  *
  *
  *  @param msg  消息体
  *  @param msg  消息体
  *  @param succ 发送成功时回调
  *  @param succ 发送成功时回调
  *  @param fail 发送失败时回调
  *  @param fail 发送失败时回调
  *
  *
- *  @return 0 本次操作成功
+ *  @return 0：操作成功；1：操作失败
  */
  */
 - (int)sendMessage:(TIMMessage*)msg succ:(TIMSucc)succ fail:(TIMFail)fail;
 - (int)sendMessage:(TIMMessage*)msg succ:(TIMSucc)succ fail:(TIMFail)fail;
 
 
 /**
 /**
- *  发送在线消息（服务器不保存消息）
+ *  1.2 发送在线消息（无痕消息）
+ *
+ *  “在线消息”，也可以称为是“无痕消息”。跟普通消息的区别在于：在线消息不会被云服务存储，也不会存储于本地数据库中。
+ *  如果接收者在线，可以收到消息，但如果接收者离线，重新上线后也不能通过 getMessage() 接口从历史消息里查到它们。
+ *
+ *  该类型消息比较适合用作发送广播通知等不重要的提示消息。
+ *
+ *  1. 在线消息不会被计入未读计数
+ *  2. 暂不支持在 AVChatRoom 和 BChatRoom 中发送。
  *
  *
  *  @param msg  消息体
  *  @param msg  消息体
  *  @param succ 成功回调
  *  @param succ 成功回调
  *  @param fail 失败回调
  *  @param fail 失败回调
  *
  *
- *  @return 0 成功
+ *  @return 0：操作成功；1：操作失败
  */
  */
 - (int)sendOnlineMessage:(TIMMessage*)msg succ:(TIMSucc)succ fail:(TIMFail)fail;
 - (int)sendOnlineMessage:(TIMMessage*)msg succ:(TIMSucc)succ fail:(TIMFail)fail;
 
 
+///@}
+
+#pragma mark 二，获取消息
+/////////////////////////////////////////////////////////////////////////////////
+//
+//                      （二）获取消息
+//
+/////////////////////////////////////////////////////////////////////////////////
+/// @name 获取消息相关接口
+/// @{
+/**
+ *  2.1 从云端拉取历史消息
+ *
+ *  如果用户的网络正常且登录成功，可以通过该接口拉取历史消息，该接口会返回云端存储的历史消息（最多存储7天）。
+ *
+ *  1. 单聊和群聊消息会在云端免费存储7天，如果希望存储更长时间，可前往 
+ *     ([IM 控制台](https://console.cloud.tencent.com/avc) -> 功能配置 -> 消息 ->消息漫游时长)进行购买，
+ *     具体资费请参考 [价格说明](https://cloud.tencent.com/document/product/269/11673)。
+ *
+ *  2. 对于图片、语音等资源类消息，获取到的消息体只会包含描述信息，需要通过额外的接口下载数据，
+ *     详情请参考 [消息收发]（https://cloud.tencent.com/document/product/269/9150）中的 "消息解析" 部分文档。
+ *
+ *  @param count 获取数量
+ *  @param last  上次最后一条消息，如果 last 为 nil，从最新的消息开始读取
+ *  @param succ  成功时回调
+ *  @param fail  失败时回调
+ *
+ *  @return 0：本次操作成功；1：本次操作失败
+ */
+- (int)getMessage:(int)count last:(TIMMessage*)last succ:(TIMGetMsgSucc)succ fail:(TIMFail)fail;
+
+/**
+ *  2.2 从本地数据库中获取历史消息
+ *
+ *  如果客户网络异常或登录失败，可以通过该接口获取本地存储的历史消息，调用方法和 getMessage() 一致
+ *
+ *  @param count 获取数量
+ *  @param last  上次最后一条消息
+ *  @param succ  成功时回调
+ *  @param fail  失败时回调
+ *
+ *  @return 0：本次操作成功；1：本次操作失败
+ */
+- (int)getLocalMessage:(int)count last:(TIMMessage*)last succ:(TIMGetMsgSucc)succ fail:(TIMFail)fail;
+
 /**
 /**
- *  获取会话人，单聊为对方账号，群聊为群组Id
+ *  2.3 获取当前会话的最后一条消息
+ *
+ *  可用于“装饰”会话列表，目前大多数 App 的会话列表中都会显示该会话的最后一条消息
+ *
+ *  @return 最后一条消息
+ */
+- (TIMMessage*)getLastMsg;
+
+///@}
+
+#pragma mark 三，设置消息已读
+/////////////////////////////////////////////////////////////////////////////////
+//
+//                      （三）设置消息已读
+//
+/////////////////////////////////////////////////////////////////////////////////
+/// @name 设置消息已读
+/// @{
+/**
+ *  3.1 标记消息为已读状态
+ *
+ *  该接口会标记当前消息以及之前的所有消息为已读状态，标记消息为已读状态会有两个作用：
+ *  1. 已经被标记为已读的消息不会重复提醒，下次登录或者换一台终端设备登录 IM 时，都不会再次收到该消息的未读提醒。
+ *  2. 如果发送者通过 TIMUserConfig -> enableReadReceipt 开启了 “被阅回执”，接收者在标记已读状态时，发送者会收到“被阅提醒”。
+ *  
+ *  @note 该接口尚不支持标记单独一条消息，只能标记一批。即标记当前一条消息，之前的消息也会全被标记为已读状态。
+ *  如果您想做语音的单条消息已读逻辑，请暂时使用 TIMMessage.h -> setCustomInt 接口自定义一个“已读”字段，
+ *  需要注意的是，这个接口设置的字段只会在本地保存，如果切换了终端或则 App 被卸载，这个自定义的字段都会失效。
+ *
+ *  @param fromMsg 会话内最近一条已读的消息，nil 表示上报最新消息
+ *  @param succ  成功时回调
+ *  @param fail  失败时回调
+ *
+ *  @return 0 表示成功 
+ */
+- (int)setReadMessage:(TIMMessage*)fromMsg succ:(TIMSucc)succ fail:(TIMFail)fail;
+
+/**
+ *  3.2 获取会话的未读消息计数
+ *
+ *  1. 同一个终端登录，在未卸载 APP 的情况下，您可以通过当前接口获取的未读消息的个数。
+ *  2. 如果希望换一台终端也能取到同样的未读计数提醒，或者卸载 APP 再重装，未读计数提醒还能保留卸载前的状态，
+ *     就需要设置 TIMUserConfig 的 disableAutoReport 为 YES，这样可以开启多终端同步未读提醒。
+ *
+ *  详情参考 [未读消息计数]（https://cloud.tencent.com/document/product/269/9151）
+ *
+ *  @return 返回未读计数
+ */
+- (int)getUnReadMessageNum;
+
+///@}
+
+#pragma mark 四，撤回/删除消息
+/////////////////////////////////////////////////////////////////////////////////
+//
+//                      （四）撤回/删除消息
+//
+/////////////////////////////////////////////////////////////////////////////////
+/// @name 撤回/删除消息相关接口
+/// @{
+/**
+ *  4.1 撤回一条已发送的消息（消息发送后 ）
+ *
+ *  1. 仅支持 C2C 会话和 GROUP 会话中发送的消息，无法撤销 OnlineMessage，也无法撤销 AVChatRoom 和 BChatRoom 中的消息。
+ *  2. 只支持两分钟之内的消息撤回。
+ *  3. 您需要在 TIMUserConfig -> TIMMessageRevokeListener 监听 onRevokeMessage() 消息撤回回调，
+ *     如果消息撤回成功，消息的接收方会收到一次 onRevokeMessage:(TIMMessageLocator*) 回调，TIMMessageLocator 相当于一条消息的定位标志。
+ *     您可以在已收到的历史消息里进行遍历，通过 TIMMessage 中的 respondsToLocator() 接口进行比对，以便定位到该条消息。
+ *
+ *  @param msg   被撤回的消息
+ *  @param succ  成功时回调
+ *  @param fail  失败时回调
+ *
+ *  @return 0：本次操作成功；1：本次操作失败
+ */
+- (int)revokeMessage:(TIMMessage*)msg succ:(TIMSucc)succ fail:(TIMFail)fail;
+
+/**
+ *  4.2 删除当前会话的本地历史消息
+ *
+ *  @param succ  成功时回调
+ *  @param fail  失败时回调
+ *
+ *  @return 0 本次操作成功
+ */
+- (int)deleteLocalMessage:(TIMSucc)succ fail:(TIMFail)fail;
+
+///@}
+
+#pragma mark 五，获取会话信息
+/////////////////////////////////////////////////////////////////////////////////
+//
+//                      （五）获取会话信息
+//
+/////////////////////////////////////////////////////////////////////////////////
+/// @name 获取会话信息相关接口
+/// @{
+
+/**
+ *  5.1 获取会话类型
+ *
+ *  @return 会话类型
+ */
+- (TIMConversationType)getType;
+
+/**
+ *  5.2 获取会话 ID
+ *
+ *  C2C：对方账号；Group：群组Id。
+ *
+ *  对同一个单聊或则群聊会话，getReceiver 获取的会话 ID 都是固定的，C2C 获取的是对方账号，Group 获取的是群组 Id。
  *
  *
  *  @return 会话人
  *  @return 会话人
  */
  */
 - (NSString*)getReceiver;
 - (NSString*)getReceiver;
 
 
 /**
 /**
- *  获取群名称（只有群会话有效）
+ *  5.3 获取群名称
+ *
+ *  获取群名称，只有群会话有效。
  *
  *
  *  @return 群名称
  *  @return 群名称
  */
  */
 - (NSString*)getGroupName;
 - (NSString*)getGroupName;
 
 
+///@}
+
+#pragma mark 六，草稿箱
+/////////////////////////////////////////////////////////////////////////////////
+//
+//                      （六）草稿箱
+//
+/////////////////////////////////////////////////////////////////////////////////
+/// @name 草稿箱
+/// @{
+
 /**
 /**
- *  获取会话类型
+ *  6.1 添加未编辑完的草稿消息
  *
  *
- *  @return 会话类型
+ *  在发送消息时，常常会遇到尚未编辑完毕就要切换到其它聊天窗口的情况，这些未编辑完的消息就可以通过 setDraft() 接口存储到草稿箱中。
+ *  草稿信息会存本地数据库，重新登录后依然可以获取。
+ *  
+ *
+ *  @param draft 草稿内容，详情请参考 TIMMessage.h 里面的 TIMMessageDraft 定义
+ *
+ *  @return 0：成功；1：失败
  */
  */
-- (TIMConversationType)getType;
+- (int)setDraft:(TIMMessageDraft*)draft;
+
+/**
+ *  6.2 获取未编辑完的草稿消息
+ *
+ *  @return 草稿内容，没有草稿返回 nil
+ */
+- (TIMMessageDraft*)getDraft;
+
+///@}
+
+#pragma mark 七，导入消息到会话
+/////////////////////////////////////////////////////////////////////////////////
+//
+//                      （七）导入消息到会话
+//
+/////////////////////////////////////////////////////////////////////////////////
+/// @name 导入消息到会话相关接口
+/// @{
+/**
+ *  7.1 向本地消息列表中添加一条消息，但并不将其发送出去。
+ *
+ *  该接口主要用于满足向聊天会话中插入一些提示性消息的需求，比如“您已经退出该群”，这类消息有展示
+ *  在聊天消息区的需求，但并没有发送给其他人的必要。
+ *  所以 saveMessage() 相当于一个被禁用了网络发送能力的 sendMessage() 接口。
+ *
+ *  @param msg 消息体
+ *  @param sender 发送方
+ *  @param isRead 是否已读，如果发送方是自己，默认已读
+ *
+ *  @return 0：成功；1：失败
+ */
+- (int)saveMessage:(TIMMessage*)msg sender:(NSString*)sender isReaded:(BOOL)isRead;
 
 
 /**
 /**
- *  获取该会话所属用户的id
+ *  7.2 将消息导入本地数据库
+ *
+ *  @param msgs 消息（TIMMessage*）列表
  *
  *
- *  @return 用户id
+ *  @return 0：成功；1：失败
  */
  */
-- (NSString*)getSelfIdentifier;
+- (int)importMessages:(NSArray*)msgs;
 
 
+///@}
 @end
 @end
 
 
 
 

+//
+//  TIMErrorCode.h
+//  ImSDK
+//
+//  Created by jameskhdeng on 2018/11/23.
+//  Copyright © 2018 tencent. All rights reserved.
+//
+
+#ifndef TIMErrorCode_h
+#define TIMErrorCode_h
+
+enum ERROR_CODE {
+    
+    /////////////////////////////////////////////////////////////////////////////////
+    //
+    //                      （一）终端 IM SDK
+    //
+    /////////////////////////////////////////////////////////////////////////////////
+    
+    // 通用错误码
+    
+    ERR_SUCC                                    = 0,       ///< 无错误。
+    ERR_IN_PROGESS                              = 6015,    ///< 执行中，请做好接口调用控制，例如，第一次初始化操作在回调前，后续的初始化操作会返回该错误码。
+    ERR_INVALID_PARAMETERS                      = 6017,    ///< 参数无效，请检查参数是否符合要求，具体可查看错误信息进一步定义哪个字段。
+    ERR_IO_OPERATION_FAILED                     = 6022,    ///< 操作本地 IO 错误，检查是否有读写权限，磁盘是否已满。
+    ERR_INVALID_JSON                            = 6027,    ///< 错误的 JSON 格式，请检查参数是否符合接口的要求，具体可查看错误信息进一步定义哪个字段。
+    ERR_OUT_OF_MEMORY                           = 6028,    ///< 内存不足，可能存在内存泄漏，iOS 平台使用 Instrument 工具，Android 平台使用 Profiler 工具，分析出什么地方的内存占用高。
+    ERR_PARSE_RESPONSE_FAILED                   = 6001,    ///< PB 解析失败，内部错误，可 [提交工单](https://console.cloud.tencent.com/workorder/category?level1_id=29&level2_id=40&source=0&data_title=%E4%BA%91%E9%80%9A%E4%BF%A1%20%20IM&step=1) 提供使用接口、错误码、错误信息给客服解决。
+    ERR_SERIALIZE_REQ_FAILED                    = 6002,    ///< PB 序列化失败，内部错误，可 [提交工单](https://console.cloud.tencent.com/workorder/category?level1_id=29&level2_id=40&source=0&data_title=%E4%BA%91%E9%80%9A%E4%BF%A1%20%20IM&step=1) 提供使用接口、错误码、错误信息给客服解决。
+    ERR_SDK_NOT_INITIALIZED                     = 6013,    ///< IM SDK 未初始化，初始化成功回调之后重试。
+    ERR_LOADMSG_FAILED                          = 6005,    ///< 加载本地数据库操作失败，可能存储文件有损坏，可 [提交工单](https://console.cloud.tencent.com/workorder/category?level1_id=29&level2_id=40&source=0&data_title=%E4%BA%91%E9%80%9A%E4%BF%A1%20%20IM&step=1) 联系客服定位具体问题。
+    ERR_DATABASE_OPERATE_FAILED                 = 6019,    ///< 本地数据库操作失败，可能是部分目录无权限或者数据库文件已损坏。
+    ERR_SDK_COMM_CROSS_THREAD                   = 7001,    ///< 跨线程错误，不能在跨越不同线程中执行，内部错误，可 [提交工单](https://console.cloud.tencent.com/workorder/category?level1_id=29&level2_id=40&source=0&data_title=%E4%BA%91%E9%80%9A%E4%BF%A1%20%20IM&step=1) 提供使用接口、错误码、错误信息给客服解决。
+    ERR_SDK_COMM_TINYID_EMPTY                   = 7002,    ///< TinyId 为空，内部错误，可 [提交工单](https://console.cloud.tencent.com/workorder/category?level1_id=29&level2_id=40&source=0&data_title=%E4%BA%91%E9%80%9A%E4%BF%A1%20%20IM&step=1) 提供使用接口、错误码、错误信息给客服解决。
+    ERR_SDK_COMM_INVALID_IDENTIFIER             = 7003,    ///< Identifier 非法，必须不为空，要求可打印 ASCII 字符（0x20-0x7e），长度不超过32字节。
+    ERR_SDK_COMM_FILE_NOT_FOUND                 = 7004,    ///< 文件不存在，请检查文件路径是否正确。
+    ERR_SDK_COMM_FILE_TOO_LARGE                 = 7005,    ///< 文件大小超出了限制，如果上传文件，最大限制是28MB。
+    ERR_SDK_COMM_FILE_SIZE_EMPTY                = 7006,    ///< 空文件，要求文件大小不是0字节，如果上传图片、语音、视频或文件，请检查文件是否正确生成。
+    ERR_SDK_COMM_FILE_OPEN_FAILED               = 7007,    ///< 文件打开失败，请检查文件是否存在，或者已被独占打开，引起 SDK 打开失败。
+    
+    // 帐号错误码
+    
+    ERR_SDK_NOT_LOGGED_IN                       = 6014,    ///< IM SDK 未登录，请先登录，成功回调之后重试，或者已被踢下线，可使用 TIMManager getLoginUser 检查当前是否在线。
+    ERR_NO_PREVIOUS_LOGIN                       = 6026,    ///< 自动登录时，并没有登录过该用户，这时候请调用 login 接口重新登录。
+    ERR_USER_SIG_EXPIRED                        = 6206,    ///< UserSig 过期，需要监听 UserStatusListener，onUserSigExpired 后重新获取 UserSig 登录。
+    ERR_LOGIN_KICKED_OFF_BY_OTHER               = 6208,    ///< 其他终端登录同一个帐号，引起已登录的帐号被踢，需重新登录。
+    ERR_SDK_ACCOUNT_LOGIN_IN_PROCESS            = 7501,    ///< 登录正在执行中，例如，第一次 login 或 autoLogin 操作在回调前，后续的 login 或 autoLogin 操作会返回该错误码。
+    ERR_SDK_ACCOUNT_LOGOUT_IN_PROCESS           = 7502,    ///< 登出正在执行中，例如，第一次 logout 操作在回调前，后续的 logout 操作会返回该错误码。
+    ERR_SDK_ACCOUNT_TLS_INIT_FAILED             = 7503,    ///< TLS SDK 初始化失败，内部错误，可 [提交工单](https://console.cloud.tencent.com/workorder/category?level1_id=29&level2_id=40&source=0&data_title=%E4%BA%91%E9%80%9A%E4%BF%A1%20%20IM&step=1) 提供使用接口、错误码、错误信息给客服解决。
+    ERR_SDK_ACCOUNT_TLS_NOT_INITIALIZED         = 7504,    ///< TLS SDK 未初始化，内部错误，可 [提交工单](https://console.cloud.tencent.com/workorder/category?level1_id=29&level2_id=40&source=0&data_title=%E4%BA%91%E9%80%9A%E4%BF%A1%20%20IM&step=1) 提供使用接口、错误码、错误信息给客服解决。
+    ERR_SDK_ACCOUNT_TLS_TRANSPKG_ERROR          = 7505,    ///< TLS SDK TRANS 包格式错误，内部错误，可 [提交工单](https://console.cloud.tencent.com/workorder/category?level1_id=29&level2_id=40&source=0&data_title=%E4%BA%91%E9%80%9A%E4%BF%A1%20%20IM&step=1) 提供使用接口、错误码、错误信息给客服解决。
+    ERR_SDK_ACCOUNT_TLS_DECRYPT_FAILED          = 7506,    ///< TLS SDK 解密失败，内部错误，可 [提交工单](https://console.cloud.tencent.com/workorder/category?level1_id=29&level2_id=40&source=0&data_title=%E4%BA%91%E9%80%9A%E4%BF%A1%20%20IM&step=1) 提供使用接口、错误码、错误信息给客服解决。
+    ERR_SDK_ACCOUNT_TLS_REQUEST_FAILED          = 7507,    ///< TLS SDK 请求失败，内部错误，可 [提交工单](https://console.cloud.tencent.com/workorder/category?level1_id=29&level2_id=40&source=0&data_title=%E4%BA%91%E9%80%9A%E4%BF%A1%20%20IM&step=1) 提供使用接口、错误码、错误信息给客服解决。
+    ERR_SDK_ACCOUNT_TLS_REQUEST_TIMEOUT         = 7508,    ///< TLS SDK 请求超时，内部错误，可 [提交工单](https://console.cloud.tencent.com/workorder/category?level1_id=29&level2_id=40&source=0&data_title=%E4%BA%91%E9%80%9A%E4%BF%A1%20%20IM&step=1) 提供使用接口、错误码、错误信息给客服解决。
+    
+    // 消息错误码
+    
+    ERR_INVALID_CONVERSATION                    = 6004,    ///< 会话无效，getConversation 时检查是否已经登录，如未登录获取会话，会有此错误码返回。
+    ERR_FILE_TRANS_AUTH_FAILED                  = 6006,    ///< 文件传输鉴权失败，可 [提交工单](https://console.cloud.tencent.com/workorder/category?level1_id=29&level2_id=40&source=0&data_title=%E4%BA%91%E9%80%9A%E4%BF%A1%20%20IM&step=1) 提供使用接口、错误码、错误信息给客服解决。
+    ERR_FILE_TRANS_NO_SERVER                    = 6007,    ///< 文件传输获取 Server 列表失败，可 [提交工单](https://console.cloud.tencent.com/workorder/category?level1_id=29&level2_id=40&source=0&data_title=%E4%BA%91%E9%80%9A%E4%BF%A1%20%20IM&step=1) 提供使用接口、错误码、错误信息给客服解决。
+    ERR_FILE_TRANS_UPLOAD_FAILED                = 6008,    ///< 文件传输上传失败，请检查网络是否连接，如果上传的是图片，确认图片能够正常打开。
+    ERR_FILE_TRANS_DOWNLOAD_FAILED              = 6009,    ///< 文件传输下载失败，请检查网络，或者文件、语音是否已经过期，目前资源文件存储7天。
+    ERR_HTTP_REQ_FAILED                         = 6010,    ///< HTTP 请求失败，请检查 URL 地址是否合法，可在网页浏览器尝试访问该 URL 地址。
+    ERR_INVALID_MSG_ELEM                        = 6016,    ///< IM SDK 无效消息 elem，具体可查看错误信息进一步定义哪个字段。
+    ERR_INVALID_SDK_OBJECT                      = 6021,    ///< 无效的对象，例如用户自己生成 TIMImage 对象，或内部赋值错误导致对象无效。
+    ERR_SDK_MSG_BODY_SIZE_LIMIT                 = 8001,    ///< 消息长度超出限制，消息长度不要超过8k，消息长度是各个 elem 长度的总和，elem 长度是所有 elem 字段的长度总和。
+    ERR_SDK_MSG_KEY_REQ_DIFFER_RSP              = 8002,    ///< 消息 KEY 错误，内部错误，网络请求包的 KEY 和 回复包的不一致。
+    
+    // 群组错误码
+    
+    ERR_SDK_GROUP_INVALID_ID                    = 8501,    ///< 群组 ID 非法，自定义群组 ID 必须为可打印 ASCII 字符（0x20-0x7e），最长48个字节，且前缀不能为 @TGS#（避免与服务端默认分配的群组 ID 混淆）。
+    ERR_SDK_GROUP_INVALID_NAME                  = 8502,    ///< 群名称非法，群名称最长30字节，字符编码必须是 UTF-8 ，如果包含中文，可能用多个字节表示一个中文字符，请注意检查字符串的字节长度。
+    ERR_SDK_GROUP_INVALID_INTRODUCTION          = 8503,    ///< 群简介非法，群简介最长240字节，字符编码必须是 UTF-8 ，如果包含中文，可能用多个字节表示一个中文字符，请注意检查字符串的字节长度。
+    ERR_SDK_GROUP_INVALID_NOTIFICATION          = 8504,    ///< 群公告非法，群公告最长300字节，字符编码必须是 UTF-8 ，如果包含中文，可能用多个字节表示一个中文字符，请注意检查字符串的字节长度。
+    ERR_SDK_GROUP_INVALID_FACE_URL              = 8505,    ///< 群头像 URL 非法，群头像 URL 最长100字节，可在网页浏览器尝试访问该 URL 地址。
+    ERR_SDK_GROUP_INVALID_NAME_CARD             = 8506,    ///< 群名片非法，群名片最长50字节，字符编码必须是 UTF-8 ，如果包含中文，可能用多个字节表示一个中文字符，请注意检查字符串的字节长度。
+    ERR_SDK_GROUP_MEMBER_COUNT_LIMIT            = 8507,    ///< 超过群组成员数的限制，在创建群和邀请成员时，指定的成员数超出限制，最大群成员数量：私有群是200人，公开群是2000人，聊天室是10000人，音视频聊天室和在线成员广播大群无限制。
+    ERR_SDK_GROUP_JOIN_PRIVATE_GROUP_DENY       = 8508,    ///< 不允许申请加入 Private 群组，任意群成员可邀请入群，且无需被邀请人同意。
+    ERR_SDK_GROUP_INVITE_SUPER_DENY             = 8509,    ///< 不允许邀请角色为群主的成员，请检查角色字段是否填写正确。
+    ERR_SDK_GROUP_INVITE_NO_MEMBER              = 8510,    ///< 不允许邀请0个成员，请检查成员字段是否填写正确。
+    
+    // 关系链错误码
+    
+    ERR_SDK_FRIENDSHIP_INVALID_PROFILE_KEY      = 9001,    ///< 资料字段非法，资料支持标配字段及自定义字段，其中自定义字段的关键字，必须是英文字母，且长度不得超过8字节，自定义字段的值最长不能超过500字节。
+    ERR_SDK_FRIENDSHIP_INVALID_ADD_REMARK       = 9002,    ///< 备注字段非法，最大96字节，字符编码必须是 UTF-8 ，如果包含中文，可能用多个字节表示一个中文字符，请注意检查字符串的字节长度。
+    ERR_SDK_FRIENDSHIP_INVALID_ADD_WORDING      = 9003,    ///< 请求添加好友的请求说明字段非法，最大120字节，字符编码必须是 UTF-8 ，如果包含中文，可能用多个字节表示一个中文字符，请注意检查字符串的字节长度。
+    ERR_SDK_FRIENDSHIP_INVALID_ADD_SOURCE       = 9004,    ///< 请求添加好友的添加来源字段非法，来源需要添加“AddSource_Type_”前缀。
+    ERR_SDK_FRIENDSHIP_FRIEND_GROUP_EMPTY       = 9005,    ///< 好友分组字段非法，必须不为空，每个分组的名称最长30字节，字符编码必须是 UTF-8 ，如果包含中文，可能用多个字节表示一个中文字符，请注意检查字符串的字节长度。
+    
+    // 网络错误码
+    
+    ERR_SDK_NET_ENCODE_FAILED                   = 9501,    ///< SSO 加密失败，内部错误，可 [提交工单](https://console.cloud.tencent.com/workorder/category?level1_id=29&level2_id=40&source=0&data_title=%E4%BA%91%E9%80%9A%E4%BF%A1%20%20IM&step=1) 提供使用接口、错误码、错误信息给客服解决。
+    ERR_SDK_NET_DECODE_FAILED                   = 9502,    ///< SSO 解密失败，内部错误，可 [提交工单](https://console.cloud.tencent.com/workorder/category?level1_id=29&level2_id=40&source=0&data_title=%E4%BA%91%E9%80%9A%E4%BF%A1%20%20IM&step=1) 提供使用接口、错误码、错误信息给客服解决。
+    ERR_SDK_NET_AUTH_INVALID                    = 9503,    ///< SSO 未完成鉴权，可能登录未完成，请在登录完成后再操作。
+    ERR_SDK_NET_COMPRESS_FAILED                 = 9504,    ///< 数据包压缩失败，内部错误，可 [提交工单](https://console.cloud.tencent.com/workorder/category?level1_id=29&level2_id=40&source=0&data_title=%E4%BA%91%E9%80%9A%E4%BF%A1%20%20IM&step=1) 提供使用接口、错误码、错误信息给客服解决。
+    ERR_SDK_NET_UNCOMPRESS_FAILED               = 9505,    ///< 数据包解压失败，内部错误，可 [提交工单](https://console.cloud.tencent.com/workorder/category?level1_id=29&level2_id=40&source=0&data_title=%E4%BA%91%E9%80%9A%E4%BF%A1%20%20IM&step=1) 提供使用接口、错误码、错误信息给客服解决。
+    ERR_SDK_NET_FREQ_LIMIT                      = 9506,    ///< 调用频率限制，最大每秒发起 5 次请求。
+    ERR_SDK_NET_REQ_COUNT_LIMIT                 = 9507,    ///< 请求队列満，超过同时请求的数量限制，最大同时发起1000个请求。
+    ERR_SDK_NET_DISCONNECT                      = 9508,    ///< 网络已断开，未建立连接，或者建立 socket 连接时，检测到无网络。
+    ERR_SDK_NET_ALLREADY_CONN                   = 9509,    ///< 网络连接已建立，重复创建连接，内部错误。
+    ERR_SDK_NET_CONN_TIMEOUT                    = 9510,    ///< 建立网络连接超时，请等网络恢复后重试。
+    ERR_SDK_NET_CONN_REFUSE                     = 9511,    ///< 网络连接已被拒绝，请求过于频繁，服务端拒绝服务。
+    ERR_SDK_NET_NET_UNREACH                     = 9512,    ///< 没有到达网络的可用路由，请等网络恢复后重试。
+    ERR_SDK_NET_SOCKET_NO_BUFF                  = 9513,    ///< 系统中没有足够的缓冲区空间资源可用来完成调用，系统过于繁忙，内部错误。
+    ERR_SDK_NET_RESET_BY_PEER                   = 9514,    ///< 对端重置了连接，可能服务端过载，SDK 内部会自动重连，请等网络连接成功 onConnSucc （ iOS ） 或 onConnected （ Android ） 回调后重试。
+    ERR_SDK_NET_SOCKET_INVALID                  = 9515,    ///< socket 套接字无效，内部错误，可 [提交工单](https://console.cloud.tencent.com/workorder/category?level1_id=29&level2_id=40&source=0&data_title=%E4%BA%91%E9%80%9A%E4%BF%A1%20%20IM&step=1) 提供使用接口、错误码、错误信息给客服解决。
+    ERR_SDK_NET_HOST_GETADDRINFO_FAILED         = 9516,    ///< IP 地址解析失败，内部错误，可能是本地 imsdk_config 配置文件被损坏，读取到到 IP 地址非法。
+    ERR_SDK_NET_CONNECT_RESET                   = 9517,    ///< 网络连接到中间节点或服务端重置，引起连接失效，内部错误，SDK 内部会自动重连，请等网络连接成功 onConnSucc （ iOS ） 或 onConnected （ Android ） 回调后重试。
+    ERR_SDK_NET_WAIT_INQUEUE_TIMEOUT            = 9518,    ///< 请求包等待进入待发送队列超时，发送时网络连接建立比较慢 或 频繁断网重连时，会出现该错误，请检查网络连接是否正常。
+    ERR_SDK_NET_WAIT_SEND_TIMEOUT               = 9519,    ///< 请求包已进入待发送队列，等待进入系统的网络 buffer 超时，数据包较多 或 发送线程处理不过来，内部错误。
+    ERR_SDK_NET_WAIT_ACK_TIMEOUT                = 9520,    ///< 请求包已进入系统的网络 buffer ，等待服务端回包超时，可能请求包没离开终端设备、中间路由丢弃、服务端意外丢包或回包被系统网络层丢弃，内部错误。
+    
+    /////////////////////////////////////////////////////////////////////////////////
+    //
+    //                      （二）服务端
+    //
+    /////////////////////////////////////////////////////////////////////////////////
+    
+    // SSO 接入层的错误码
+    
+    ERR_SVR_SSO_CONNECT_LIMIT                   = -302  ,  ///< SSO 的连接数量超出限制，服务端拒绝服务。
+    ERR_SVR_SSO_VCODE                           = -10000,  ///< 下发验证码标志错误。
+    ERR_SVR_SSO_D2_EXPIRED                      = -10001,  ///< D2 过期。
+    ERR_SVR_SSO_A2_UP_INVALID                   = -10003,  ///< A2 校验失败等场景使用。
+    ERR_SVR_SSO_A2_DOWN_INVALID                 = -10004,  ///< 处理下行包时发现 A2 验证没通过或者被安全打击。
+    ERR_SVR_SSO_EMPTY_KEY                       = -10005,  ///< 不允许空 D2Key 加密。
+    ERR_SVR_SSO_UIN_INVALID                     = -10006,  ///< D2 中的 uin 和 SSO 包头的 uin 不匹配。
+    ERR_SVR_SSO_VCODE_TIMEOUT                   = -10007,  ///< 验证码下发超时。
+    ERR_SVR_SSO_NO_IMEI_AND_A2                  = -10008,  ///< 需要带上 IMEI 和 A2 。
+    ERR_SVR_SSO_COOKIE_INVALID                  = -10009,  ///< Cookie 非法。
+    ERR_SVR_SSO_DOWN_TIP                        = -10101,  ///< 下发提示语，D2 过期。
+    ERR_SVR_SSO_DISCONNECT                      = -10102,  ///< 断链锁屏。
+    ERR_SVR_SSO_IDENTIFIER_INVALID              = -10103,  ///< 失效身份。
+    ERR_SVR_SSO_CLIENT_CLOSE                    = -10104,  ///< 终端自动退出。
+    ERR_SVR_SSO_MSFSDK_QUIT                     = -10105,  ///< MSFSDK 自动退出。
+    ERR_SVR_SSO_D2KEY_WRONG                     = -10106,  ///< SSO D2key 解密失败次数太多，通知终端需要重置，重新刷新 D2 。
+    ERR_SVR_SSO_UNSURPPORT                      = -10107,  ///< 不支持聚合，给终端返回统一的错误码。终端在该 TCP 长连接上停止聚合。
+    ERR_SVR_SSO_PREPAID_ARREARS                 = -10108,  ///< 预付费欠费。
+    ERR_SVR_SSO_PACKET_WRONG                    = -10109,  ///< 请求包格式错误。
+    ERR_SVR_SSO_APPID_BLACK_LIST                = -10110,  ///< SDKAppID 黑名单。
+    ERR_SVR_SSO_CMD_BLACK_LIST                  = -10111,  ///< SDKAppID 设置 service cmd 黑名单。
+    ERR_SVR_SSO_APPID_WITHOUT_USING             = -10112,  ///< SDKAppID 停用。
+    ERR_SVR_SSO_FREQ_LIMIT                      = -10113,  ///< 频率限制(用户)，频率限制是设置针对某一个协议的每秒请求数的限制。
+    ERR_SVR_SSO_OVERLOAD                        = -10114,  ///< 过载丢包(系统)，连接的服务端处理过多请求，处理不过来，拒绝服务。
+    
+    // 资源文件错误码
+    
+    ERR_SVR_RES_NOT_FOUND                       = 114000,  ///< 要发送的资源文件不存在。
+    ERR_SVR_RES_ACCESS_DENY                     = 114001,  ///< 要发送的资源文件不允许访问。
+    ERR_SVR_RES_SIZE_LIMIT                      = 114002,  ///< 文件大小超过限制。
+    ERR_SVR_RES_SEND_CANCEL                     = 114003,  ///< 用户取消发送，如发送过程中登出等原因。
+    ERR_SVR_RES_READ_FAILED                     = 114004,  ///< 读取文件内容失败。
+    ERR_SVR_RES_TRANSFER_TIMEOUT                = 114005,  ///< 资源文件（如图片、文件、语音、视频）传输超时，一般是网络问题导致。
+    ERR_SVR_RES_INVALID_PARAMETERS              = 114011,  ///< 参数非法。
+    ERR_SVR_RES_INVALID_FILE_MD5                = 115066,  ///< 文件 MD5 校验失败。
+    ERR_SVR_RES_INVALID_PART_MD5                = 115068,  ///< 分片 MD5 校验失败。
+    
+    // 后台公共错误码
+    
+    ERR_SVR_COMM_INVALID_HTTP_URL               = 60002,  ///< HTTP 解析错误 ，请检查 HTTP 请求 URL 格式。
+    ERR_SVR_COMM_REQ_JSON_PARSE_FAILED          = 60003,  ///< HTTP 请求 JSON 解析错误，请检查 JSON 格式。
+    ERR_SVR_COMM_INVALID_ACCOUNT                = 60004,  ///< 请求 URI 或 JSON 包体中 Identifier 或 UserSig 错误。
+    ERR_SVR_COMM_INVALID_ACCOUNT_EX             = 60005,  ///< 请求 URI 或 JSON 包体中 Identifier 或 UserSig 错误。
+    ERR_SVR_COMM_INVALID_SDKAPPID               = 60006,  ///< SDKAppID 失效，请核对 SDKAppID 有效性。
+    ERR_SVR_COMM_REST_FREQ_LIMIT                = 60007,  ///< REST 接口调用频率超过限制，请降低请求频率。
+    ERR_SVR_COMM_REQUEST_TIMEOUT                = 60008,  ///< 服务请求超时或 HTTP 请求格式错误，请检查并重试。
+    ERR_SVR_COMM_INVALID_RES                    = 60009,  ///< 请求资源错误，请检查请求 URL。
+    ERR_SVR_COMM_ID_NOT_ADMIN                   = 60010,  ///< REST API 请求的 Identifier 字段请填写 App 管理员帐号。
+    ERR_SVR_COMM_SDKAPPID_FREQ_LIMIT            = 60011,  ///< SDKAppID 请求频率超限，请降低请求频率。
+    ERR_SVR_COMM_SDKAPPID_MISS                  = 60012,  ///< REST 接口需要带 SDKAppID，请检查请求 URL 中的 SDKAppID。
+    ERR_SVR_COMM_RSP_JSON_PARSE_FAILED          = 60013,  ///< HTTP 响应包 JSON 解析错误。
+    ERR_SVR_COMM_EXCHANGE_ACCOUNT_TIMEUT        = 60014,  ///< 置换帐号超时。
+    ERR_SVR_COMM_INVALID_ID_FORMAT              = 60015,  ///< 请求包体 Identifier 类型错误，请确认 Identifier 为字符串格式。
+    ERR_SVR_COMM_SDKAPPID_FORBIDDEN             = 60016,  ///< SDKAppID 被禁用，请 [提交工单](https://console.cloud.tencent.com/workorder/category?level1_id=29&level2_id=40&source=0&data_title=%E4%BA%91%E9%80%9A%E4%BF%A1%20%20IM&step=1) 联系客服确认。
+    ERR_SVR_COMM_REQ_FORBIDDEN                  = 60017,  ///< 请求被禁用，请 [提交工单](https://console.cloud.tencent.com/workorder/category?level1_id=29&level2_id=40&source=0&data_title=%E4%BA%91%E9%80%9A%E4%BF%A1%20%20IM&step=1) 联系客服确认。
+    ERR_SVR_COMM_REQ_FREQ_LIMIT                 = 60018,  ///< 请求过于频繁，请稍后重试。
+    ERR_SVR_COMM_REQ_FREQ_LIMIT_EX              = 60019,  ///< 请求过于频繁，请稍后重试。
+    ERR_SVR_COMM_INVALID_SERVICE                = 60020,  ///< 未购买套餐包或购买的套餐包正在配置中暂未生效，请五分钟后再次尝试。
+    ERR_SVR_COMM_SENSITIVE_TEXT                 = 80001,  ///< 文本安全打击，文本中可能包含敏感词汇。
+    ERR_SVR_COMM_BODY_SIZE_LIMIT                = 80002,  ///< 发消息包体过长，目前支持最大8k消息包体长度，请减少包体大小重试。
+    
+    // 帐号错误码
+    
+    ERR_SVR_ACCOUNT_USERSIG_EXPIRED             = 70001,  ///< UserSig 已过期，请重新生成 UserSig，建议 UserSig 有效期不小于24小时。
+    ERR_SVR_ACCOUNT_USERSIG_EMPTY               = 70002,  ///< UserSig 长度为0，请检查传入的 UserSig 是否正确。
+    ERR_SVR_ACCOUNT_USERSIG_CHECK_FAILED        = 70003,  ///< UserSig 校验失败，请确认下 UserSig 内容是否被截断，如缓冲区长度不够导致的内容截断。
+    ERR_SVR_ACCOUNT_USERSIG_CHECK_FAILED_EX     = 70005,  ///< UserSig 校验失败，可用工具自行验证生成的 UserSig 是否正确。
+    ERR_SVR_ACCOUNT_USERSIG_MISMATCH_PUBLICKEY  = 70009,  ///< 用公钥验证 UserSig 失败，请确认生成的 UserSig 使用的私钥和 SDKAppID 是否对应。
+    ERR_SVR_ACCOUNT_USERSIG_MISMATCH_ID         = 70013,  ///< 请求的 Identifier 与生成 UserSig 的 Identifier 不匹配。
+    ERR_SVR_ACCOUNT_USERSIG_MISMATCH_SDKAPPID   = 70014,  ///< 请求的 SDKAppID 与生成 UserSig 的 SDKAppID 不匹配。
+    ERR_SVR_ACCOUNT_USERSIG_PUBLICKEY_NOT_FOUND = 70016,  ///< 验证 UserSig 时公钥不存在。请先登录控制台下载私钥，下载私钥的具体方法可参考 [下载签名用的私钥](https://cloud.tencent.com/document/product/269/32688#.E4.B8.8B.E8.BD.BD.E7.AD.BE.E5.90.8D.E7.94.A8.E7.9A.84.E7.A7.81.E9.92.A5) 。
+    ERR_SVR_ACCOUNT_SDKAPPID_NOT_FOUND          = 70020,  ///< SDKAppID 未找到，请在云通信 IM 控制台确认应用信息。
+    ERR_SVR_ACCOUNT_INVALID_USERSIG             = 70052,  ///< UserSig 已经失效，请重新生成，再次尝试。
+    ERR_SVR_ACCOUNT_NOT_FOUND                   = 70107,  ///< 请求的用户帐号不存在。
+    ERR_SVR_ACCOUNT_SEC_RSTR                    = 70114,  ///< 安全原因被限制。
+    ERR_SVR_ACCOUNT_INTERNAL_TIMEOUT            = 70169,  ///< 服务端内部超时，请重试。
+    ERR_SVR_ACCOUNT_INVALID_COUNT               = 70206,  ///< 请求中批量数量不合法。
+    ERR_SVR_ACCOUNT_INVALID_PARAMETERS          = 70402,  ///< 参数非法，请检查必填字段是否填充，或者字段的填充是否满足协议要求。
+    ERR_SVR_ACCOUNT_ADMIN_REQUIRED              = 70403,  ///< 请求需要 App 管理员权限。
+    ERR_SVR_ACCOUNT_FREQ_LIMIT                  = 70050,  ///< 因失败且重试次数过多导致被限制，请检查 UserSig 是否正确，一分钟之后再试。
+    ERR_SVR_ACCOUNT_BLACKLIST                   = 70051,  ///< 帐号被拉入黑名单。
+    ERR_SVR_ACCOUNT_COUNT_LIMIT                 = 70398,  ///< 创建帐号数量超过免费体验版数量限制，请升级为专业版。
+    ERR_SVR_ACCOUNT_INTERNAL_ERROR              = 70500,  ///< 服务端内部错误，请重试。
+    
+    // 资料错误码
+    
+    ERR_SVR_PROFILE_INVALID_PARAMETERS          = 40001,  ///< 请求参数错误，请根据错误描述检查请求是否正确。
+    ERR_SVR_PROFILE_ACCOUNT_MISS                = 40002,  ///< 请求参数错误，没有指定需要拉取资料的用户帐号。
+    ERR_SVR_PROFILE_ACCOUNT_NOT_FOUND           = 40003,  ///< 请求的用户帐号不存在。
+    ERR_SVR_PROFILE_ADMIN_REQUIRED              = 40004,  ///< 请求需要 App 管理员权限。
+    ERR_SVR_PROFILE_SENSITIVE_TEXT              = 40005,  ///< 资料字段中包含敏感词。
+    ERR_SVR_PROFILE_INTERNAL_ERROR              = 40006,  ///< 服务端内部错误，请稍后重试。
+    ERR_SVR_PROFILE_READ_PERMISSION_REQUIRED    = 40007,  ///< 没有资料字段的读权限，详情可参见 [资料字段](https://cloud.tencent.com/document/product/269/1500#.E8.B5.84.E6.96.99.E5.AD.97.E6.AE.B5) 。
+    ERR_SVR_PROFILE_WRITE_PERMISSION_REQUIRED   = 40008,  ///< 没有资料字段的写权限，详情可参见 [资料字段](https://cloud.tencent.com/document/product/269/1500#.E8.B5.84.E6.96.99.E5.AD.97.E6.AE.B5) 。
+    ERR_SVR_PROFILE_TAG_NOT_FOUND               = 40009,  ///< 资料字段的 Tag 不存在。
+    ERR_SVR_PROFILE_SIZE_LIMIT                  = 40601,  ///< 资料字段的 Value 长度超过500字节。
+    ERR_SVR_PROFILE_VALUE_ERROR                 = 40605,  ///< 标配资料字段的 Value 错误，详情可参见 [标配资料字段](https://cloud.tencent.com/doc/product/269/1500#.E6.A0.87.E9.85.8D.E8.B5.84.E6.96.99.E5.AD.97.E6.AE.B5) 。
+    ERR_SVR_PROFILE_INVALID_VALUE_FORMAT        = 40610,  ///< 资料字段的 Value 类型不匹配，详情可参见 [标配资料字段](https://cloud.tencent.com/doc/product/269/1500#.E6.A0.87.E9.85.8D.E8.B5.84.E6.96.99.E5.AD.97.E6.AE.B5) 。
+    
+    // 关系链错误码
+    
+    ERR_SVR_FRIENDSHIP_INVALID_PARAMETERS       = 30001,  ///< 请求参数错误，请根据错误描述检查请求是否正确。
+    ERR_SVR_FRIENDSHIP_INVALID_SDKAPPID         = 30002,  ///< SDKAppID 不匹配。
+    ERR_SVR_FRIENDSHIP_ACCOUNT_NOT_FOUND        = 30003,  ///< 请求的用户帐号不存在。
+    ERR_SVR_FRIENDSHIP_ADMIN_REQUIRED           = 30004,  ///< 请求需要 App 管理员权限。
+    ERR_SVR_FRIENDSHIP_SENSITIVE_TEXT           = 30005,  ///< 关系链字段中包含敏感词。
+    ERR_SVR_FRIENDSHIP_INTERNAL_ERROR           = 30006,  ///< 服务端内部错误，请重试。
+    ERR_SVR_FRIENDSHIP_NET_TIMEOUT              = 30007,  ///< 网络超时，请稍后重试。
+    ERR_SVR_FRIENDSHIP_WRITE_CONFLICT           = 30008,  ///< 并发写导致写冲突，建议使用批量方式。
+    ERR_SVR_FRIENDSHIP_ADD_FRIEND_DENY          = 30009,  ///< 后台禁止该用户发起加好友请求。
+    ERR_SVR_FRIENDSHIP_COUNT_LIMIT              = 30010,  ///< 自己的好友数已达系统上限。
+    ERR_SVR_FRIENDSHIP_GROUP_COUNT_LIMIT        = 30011,  ///< 分组已达系统上限。
+    ERR_SVR_FRIENDSHIP_PENDENCY_LIMIT           = 30012,  ///< 未决数已达系统上限。
+    ERR_SVR_FRIENDSHIP_BLACKLIST_LIMIT          = 30013,  ///< 黑名单数已达系统上限。
+    ERR_SVR_FRIENDSHIP_PEER_FRIEND_LIMIT        = 30014,  ///< 对方的好友数已达系统上限。
+    ERR_SVR_FRIENDSHIP_IN_SELF_BLACKLIST        = 30515,  ///< 请求添加好友时，对方在自己的黑名单中，不允许加好友。
+    ERR_SVR_FRIENDSHIP_ALLOW_TYPE_DENY_ANY      = 30516,  ///< 请求添加好友时，对方的加好友验证方式是不允许任何人添加自己为好友。
+    ERR_SVR_FRIENDSHIP_IN_PEER_BLACKLIST        = 30525,  ///< 请求添加好友时，自己在对方的黑名单中，不允许加好友。
+    ERR_SVR_FRIENDSHIP_ALLOW_TYPE_NEED_CONFIRM  = 30539,  ///< A 请求加 B 为好友，B 的加好友验证方式被设置为“AllowType_Type_NeedConfirm”，这时 A 与 B 之间只能形成未决关系，该返回码用于标识加未决成功，以便与加好友成功的返回码区分开，调用方可以捕捉该错误给用户一个合理的提示。
+    ERR_SVR_FRIENDSHIP_ADD_FRIEND_SEC_RSTR      = 30540,  ///< 添加好友请求被安全策略打击，请勿频繁发起添加好友请求。
+    ERR_SVR_FRIENDSHIP_PENDENCY_NOT_FOUND       = 30614,  ///< 请求的未决不存在。
+    ERR_SVR_FRIENDSHIP_DEL_NONFRIEND            = 31704,  ///< 与请求删除的帐号之间不存在好友关系。
+    ERR_SVR_FRIENDSHIP_DEL_FRIEND_SEC_RSTR      = 31707,  ///< 删除好友请求被安全策略打击，请勿频繁发起删除好友请求。
+    ERR_SVR_FRIENDSHIP_ACCOUNT_NOT_FOUND_EX     = 31804,  ///< 请求的用户帐号不存在。
+    
+    // 最近联系人错误码
+    
+    ERR_SVR_CONV_ACCOUNT_NOT_FOUND              = 50001,  ///< 请求的用户帐号不存在。
+    ERR_SVR_CONV_INVALID_PARAMETERS             = 50002,  ///< 请求参数错误，请根据错误描述检查请求是否正确。
+    ERR_SVR_CONV_ADMIN_REQUIRED                 = 50003,  ///< 请求需要 App 管理员权限。
+    ERR_SVR_CONV_INTERNAL_ERROR                 = 50004,  ///< 服务端内部错误，请重试。
+    ERR_SVR_CONV_NET_TIMEOUT                    = 50005,  ///< 网络超时，请稍后重试。
+    
+    // 消息错误码
+    
+    ERR_SVR_MSG_PKG_PARSE_FAILED                = 20001,  ///< 请求包非法，请检查发送方和接收方帐号是否存在。
+    ERR_SVR_MSG_INTERNAL_AUTH_FAILED            = 20002,  ///< 内部鉴权失败。
+    ERR_SVR_MSG_INVALID_ID                      = 20003,  ///< Identifier 无效或者 Identifier 未导入云通信 IM。
+    ERR_SVR_MSG_NET_ERROR                       = 20004,  ///< 网络异常，请重试。
+    ERR_SVR_MSG_INTERNAL_ERROR1                 = 20005,  ///< 服务端内部错误，请重试。
+    ERR_SVR_MSG_PUSH_DENY                       = 20006,  ///< 触发发送单聊消息之前回调，App 后台返回禁止下发该消息。
+    ERR_SVR_MSG_IN_PEER_BLACKLIST               = 20007,  ///< 发送单聊消息，被对方拉黑，禁止发送。
+    ERR_SVR_MSG_BOTH_NOT_FRIEND                 = 20009,  ///< 消息发送双方互相不是好友，禁止发送（配置单聊消息校验好友关系才会出现）。
+    ERR_SVR_MSG_NOT_PEER_FRIEND                 = 20010,  ///< 发送单聊消息，自己不是对方的好友（单向关系），禁止发送。
+    ERR_SVR_MSG_NOT_SELF_FRIEND                 = 20011,  ///< 发送单聊消息，对方不是自己的好友（单向关系），禁止发送。
+    ERR_SVR_MSG_SHUTUP_DENY                     = 20012,  ///< 因禁言，禁止发送消息。
+    ERR_SVR_MSG_REVOKE_TIME_LIMIT               = 20016,  ///< 消息撤回超过了时间限制（默认2分钟）。
+    ERR_SVR_MSG_DEL_RAMBLE_INTERNAL_ERROR       = 20018,  ///< 删除漫游内部错误。
+    ERR_SVR_MSG_JSON_PARSE_FAILED               = 90001,  ///< JSON 格式解析失败，请检查请求包是否符合 JSON 规范。
+    ERR_SVR_MSG_INVALID_JSON_BODY_FORMAT        = 90002,  ///< JSON 格式请求包中 MsgBody 不符合消息格式描述，或者 MsgBody 不是 Array 类型，请参考 [TIMMsgElement 对象](https://cloud.tencent.com/document/product/269/2720#.E6.B6.88.E6.81.AF.E5.85.83.E7.B4.A0timmsgelement) 的定义。
+    ERR_SVR_MSG_INVALID_TO_ACCOUNT              = 90003,  ///< JSON 格式请求包体中缺少 To_Account 字段或者 To_Account 字段不是 Integer 类型
+    ERR_SVR_MSG_INVALID_RAND                    = 90005,  ///< JSON 格式请求包体中缺少 MsgRandom 字段或者 MsgRandom 字段不是 Integer 类型
+    ERR_SVR_MSG_INVALID_TIMESTAMP               = 90006,  ///< JSON 格式请求包体中缺少 MsgTimeStamp 字段或者 MsgTimeStamp 字段不是 Integer 类型
+    ERR_SVR_MSG_BODY_NOT_ARRAY                  = 90007,  ///< JSON 格式请求包体中 MsgBody 类型不是 Array 类型，请将其修改为 Array 类型
+    ERR_SVR_MSG_ADMIN_REQUIRED                  = 90009,  ///< 请求需要 App 管理员权限。
+    ERR_SVR_MSG_INVALID_JSON_FORMAT             = 90010,  ///< JSON 格式请求包不符合消息格式描述，请参考 [TIMMsgElement 对象](https://cloud.tencent.com/document/product/269/2720#.E6.B6.88.E6.81.AF.E5.85.83.E7.B4.A0timmsgelement) 的定义。
+    ERR_SVR_MSG_TO_ACCOUNT_COUNT_LIMIT          = 90011,  ///< 批量发消息目标帐号超过500，请减少 To_Account 中目标帐号数量。
+    ERR_SVR_MSG_TO_ACCOUNT_NOT_FOUND            = 90012,  ///< To_Account 没有注册或不存在，请确认 To_Account 是否导入云通信 IM 或者是否拼写错误。
+    ERR_SVR_MSG_TIME_LIMIT                      = 90026,  ///< 消息离线存储时间错误（最多不能超过7天）。
+    ERR_SVR_MSG_INVALID_SYNCOTHERMACHINE        = 90031,  ///< JSON 格式请求包体中 SyncOtherMachine 字段不是 Integer 类型
+    ERR_SVR_MSG_INVALID_MSGLIFETIME             = 90044,  ///< JSON 格式请求包体中 MsgLifeTime 字段不是 Integer 类型
+    ERR_SVR_MSG_ACCOUNT_NOT_FOUND               = 90048,  ///< 请求的用户帐号不存在。
+    ERR_SVR_MSG_INTERNAL_ERROR2                 = 90994,  ///< 服务内部错误，请重试。
+    ERR_SVR_MSG_INTERNAL_ERROR3                 = 90995,  ///< 服务内部错误，请重试。
+    ERR_SVR_MSG_INTERNAL_ERROR4                 = 91000,  ///< 服务内部错误，请重试。
+    ERR_SVR_MSG_INTERNAL_ERROR5                 = 90992,  ///< 服务内部错误，请重试；如果所有请求都返回该错误码，且 App 配置了第三方回调，请检查 App 服务端是否正常向云通信 IM 后台服务端返回回调结果。
+    ERR_SVR_MSG_BODY_SIZE_LIMIT                 = 93000,  ///< JSON 数据包超长，消息包体请不要超过8k。
+    ERR_SVR_MSG_LONGPOLLING_COUNT_LIMIT         = 91101,  ///< Web 端长轮询被踢（Web 端同时在线实例个数超出限制）。
+    // 120001 - 130000,  ///< 单聊第三方回调返回的自定义错误码。
+    
+    // 群组错误码
+    
+    ERR_SVR_GROUP_INTERNAL_ERROR                = 10002,  ///< 服务端内部错误，请重试。
+    ERR_SVR_GROUP_API_NAME_ERROR                = 10003,  ///< 请求中的接口名称错误，请核对接口名称并重试。
+    ERR_SVR_GROUP_INVALID_PARAMETERS            = 10004,  ///< 参数非法，请根据错误描述检查请求是否正确。
+    ERR_SVR_GROUP_ACOUNT_COUNT_LIMIT            = 10005,  ///< 请求包体中携带的帐号数量过多。
+    ERR_SVR_GROUP_FREQ_LIMIT                    = 10006,  ///< 操作频率限制，请尝试降低调用的频率。
+    ERR_SVR_GROUP_PERMISSION_DENY               = 10007,  ///< 操作权限不足，比如 Public 群组中普通成员尝试执行踢人操作，但只有 App 管理员才有权限。
+    ERR_SVR_GROUP_INVALID_REQ                   = 10008,  ///< 请求非法，可能是请求中携带的签名信息验证不正确，请再次尝试或 [提交工单](https://console.cloud.tencent.com/workorder/category?level1_id=29&level2_id=40&source=0&data_title=%E4%BA%91%E9%80%9A%E4%BF%A1%20%20IM&step=1) 联系技术客服。
+    ERR_SVR_GROUP_SUPER_NOT_ALLOW_QUIT          = 10009,  ///< 该群不允许群主主动退出。
+    ERR_SVR_GROUP_NOT_FOUND                     = 10010,  ///< 群组不存在，或者曾经存在过，但是目前已经被解散。
+    ERR_SVR_GROUP_JSON_PARSE_FAILED             = 10011,  ///< 解析 JSON 包体失败，请检查包体的格式是否符合 JSON 格式。
+    ERR_SVR_GROUP_INVALID_ID                    = 10012,  ///< 发起操作的 Identifier 非法，请检查发起操作的用户 Identifier 是否填写正确。
+    ERR_SVR_GROUP_ALLREADY_MEMBER               = 10013,  ///< 被邀请加入的用户已经是群成员。
+    ERR_SVR_GROUP_FULL_MEMBER_COUNT             = 10014,  ///< 群已满员，无法将请求中的用户加入群组，如果是批量加人，可以尝试减少加入用户的数量。
+    ERR_SVR_GROUP_INVALID_GROUPID               = 10015,  ///< 群组 ID 非法，请检查群组 ID 是否填写正确。
+    ERR_SVR_GROUP_REJECT_FROM_THIRDPARTY        = 10016,  ///< App 后台通过第三方回调拒绝本次操作。
+    ERR_SVR_GROUP_SHUTUP_DENY                   = 10017,  ///< 因被禁言而不能发送消息，请检查发送者是否被设置禁言。
+    ERR_SVR_GROUP_RSP_SIZE_LIMIT                = 10018,  ///< 应答包长度超过最大包长（1MB），请求的内容过多，请尝试减少单次请求的数据量。
+    ERR_SVR_GROUP_ACCOUNT_NOT_FOUND             = 10019,  ///< 请求的用户帐号不存在。
+    ERR_SVR_GROUP_GROUPID_IN_USED               = 10021,  ///< 群组 ID 已被使用，请选择其他的群组 ID。
+    ERR_SVR_GROUP_SEND_MSG_FREQ_LIMIT           = 10023,  ///< 发消息的频率超限，请延长两次发消息时间的间隔。
+    ERR_SVR_GROUP_REQ_ALLREADY_BEEN_PROCESSED   = 10024,  ///< 此邀请或者申请请求已经被处理。
+    ERR_SVR_GROUP_GROUPID_IN_USED_FOR_SUPER     = 10025,  ///< 群组 ID 已被使用，并且操作者为群主，可以直接使用。
+    ERR_SVR_GROUP_SDKAPPID_DENY                 = 10026,  ///< 该 SDKAppID 请求的命令字已被禁用，请 [提交工单](https://console.cloud.tencent.com/workorder/category?level1_id=29&level2_id=40&source=0&data_title=%E4%BA%91%E9%80%9A%E4%BF%A1%20%20IM&step=1) 联系客服。
+    ERR_SVR_GROUP_REVOKE_MSG_NOT_FOUND          = 10030,  ///< 请求撤回的消息不存在。
+    ERR_SVR_GROUP_REVOKE_MSG_TIME_LIMIT         = 10031,  ///< 消息撤回超过了时间限制（默认2分钟）。
+    ERR_SVR_GROUP_REVOKE_MSG_DENY               = 10032,  ///< 请求撤回的消息不支持撤回操作。
+    ERR_SVR_GROUP_NOT_ALLOW_REVOKE_MSG          = 10033,  ///< 群组类型不支持消息撤回操作。
+    ERR_SVR_GROUP_REMOVE_MSG_DENY               = 10034,  ///< 该消息类型不支持删除操作。
+    ERR_SVR_GROUP_NOT_ALLOW_REMOVE_MSG          = 10035,  ///< 音视频聊天室和在线成员广播大群不支持删除消息。
+    ERR_SVR_GROUP_AVCHATROOM_COUNT_LIMIT        = 10036,  ///< 音视频聊天室创建数量超过了限制，请参考 [价格说明](https://cloud.tencent.com/document/product/269/11673) 购买预付费套餐“IM音视频聊天室”。
+    ERR_SVR_GROUP_COUNT_LIMIT                   = 10037,  ///< 单个用户可创建和加入的群组数量超过了限制，请参考 [价格说明](https://cloud.tencent.com/document/product/269/11673) 购买或升级预付费套餐“单人可创建与加入群组数”。
+    ERR_SVR_GROUP_MEMBER_COUNT_LIMIT            = 10038,  ///< 群成员数量超过限制，请参考 [价格说明](https://cloud.tencent.com/document/product/269/11673) 购买或升级预付费套餐“扩展群人数上限”。
+    
+    /////////////////////////////////////////////////////////////////////////////////
+    //
+    //                      （三）V3版本的错误码（待废弃）
+    //
+    /////////////////////////////////////////////////////////////////////////////////
+    
+    ERR_NO_SUCC_RESULT                          = 6003,   ///< 批量操作无成功结果。
+    ERR_TO_USER_INVALID                         = 6011,   ///< 无效接收方。
+    ERR_REQUEST_TIMEOUT                         = 6012,   ///< 请求超时。
+    ERR_INIT_CORE_FAIL                          = 6018,   ///< INIT CORE 模块失败。
+    ERR_EXPIRED_SESSION_NODE                    = 6020,   ///< SessionNode 为 null 。
+    ERR_LOGGED_OUT_BEFORE_LOGIN_FINISHED        = 6023,   ///< 在登录完成前进行了登出（在登录时返回）。
+    ERR_TLSSDK_NOT_INITIALIZED                  = 6024,   ///< TLS SDK 未初始化。
+    ERR_TLSSDK_USER_NOT_FOUND                   = 6025,   ///< TLS SDK 没有找到相应的用户信息。
+    ERR_BIND_FAIL_UNKNOWN                       = 6100,   ///< QALSDK 未知原因BIND失败。
+    ERR_BIND_FAIL_NO_SSOTICKET                  = 6101,   ///< 缺少 SSO 票据。
+    ERR_BIND_FAIL_REPEATD_BIND                  = 6102,   ///< 重复 BIND。
+    ERR_BIND_FAIL_TINYID_NULL                   = 6103,   ///< TinyId 为空。
+    ERR_BIND_FAIL_GUID_NULL                     = 6104,   ///< GUID 为空。
+    ERR_BIND_FAIL_UNPACK_REGPACK_FAILED         = 6105,   ///< 解注册包失败。
+    ERR_BIND_FAIL_REG_TIMEOUT                   = 6106,   ///< 注册超时。
+    ERR_BIND_FAIL_ISBINDING                     = 6107,   ///< 正在 BIND 操作中。
+    ERR_PACKET_FAIL_UNKNOWN                     = 6120,   ///< 发包未知错误。
+    ERR_PACKET_FAIL_REQ_NO_NET                  = 6121,   ///< 发送请求包时没有网络。
+    ERR_PACKET_FAIL_RESP_NO_NET                 = 6122,   ///< 发送回复包时没有网络。
+    ERR_PACKET_FAIL_REQ_NO_AUTH                 = 6123,   ///< 发送请求包时没有权限。
+    ERR_PACKET_FAIL_SSO_ERR                     = 6124,   ///< SSO 错误。
+    ERR_PACKET_FAIL_REQ_TIMEOUT                 = 6125,   ///< 请求超时。
+    ERR_PACKET_FAIL_RESP_TIMEOUT                = 6126,   ///< 回复超时。
+    ERR_PACKET_FAIL_REQ_ON_RESEND               = 6127,   ///< 重发失败。
+    ERR_PACKET_FAIL_RESP_NO_RESEND              = 6128,   ///< 重发时没有真正发送。
+    ERR_PACKET_FAIL_FLOW_SAVE_FILTERED          = 6129,   ///< 保存被过滤。
+    ERR_PACKET_FAIL_REQ_OVER_LOAD               = 6130,   ///< 发送过载。
+    ERR_PACKET_FAIL_LOGIC_ERR                   = 6131,   ///< 数据逻辑错误。
+    ERR_FRIENDSHIP_PROXY_NOT_SYNCED             = 6150,   ///< proxy_manager 没有完成服务端数据同步。
+    ERR_FRIENDSHIP_PROXY_SYNCING                = 6151,   ///< proxy_manager 正在进行服务端数据同步。
+    ERR_FRIENDSHIP_PROXY_SYNCED_FAIL            = 6152,   ///< proxy_manager 同步失败。
+    ERR_FRIENDSHIP_PROXY_LOCAL_CHECK_ERR        = 6153,   ///< proxy_manager 请求参数，在本地检查不合法。
+    ERR_GROUP_INVALID_FIELD                     = 6160,   ///< Group assistant 请求字段中包含非预设字段。
+    ERR_GROUP_STORAGE_DISABLED                  = 6161,   ///< Group assistant 群资料本地存储没有开启。
+    ERR_LOADGRPINFO_FAILED                      = 6162,   ///< 加载群资料失败。
+    ERR_REQ_NO_NET_ON_REQ                       = 6200,   ///< 请求的时候没有网络。
+    ERR_REQ_NO_NET_ON_RSP                       = 6201,   ///< 响应的时候没有网络。
+    ERR_SERIVCE_NOT_READY                       = 6205,   ///< QALSDK 服务未就绪。
+    ERR_LOGIN_AUTH_FAILED                       = 6207,   ///< 账号认证失败（ TinyId 转换失败）。
+    ERR_NEVER_CONNECT_AFTER_LAUNCH              = 6209,   ///< 在应用启动后没有尝试联网。
+    ERR_REQ_FAILED                              = 6210,   ///< QALSDK 执行失败。
+    ERR_REQ_INVALID_REQ                         = 6211,   ///< 请求非法，toMsgService 非法。
+    ERR_REQ_OVERLOADED                          = 6212,   ///< 请求队列满。
+    ERR_REQ_KICK_OFF                            = 6213,   ///< 已经被其他终端踢了。
+    ERR_REQ_SERVICE_SUSPEND                     = 6214,   ///< 服务被暂停。
+    ERR_REQ_INVALID_SIGN                        = 6215,   ///< SSO 签名错误。
+    ERR_REQ_INVALID_COOKIE                      = 6216,   ///< SSO cookie 无效。
+    ERR_LOGIN_TLS_RSP_PARSE_FAILED              = 6217,   ///< 登录时 TLS SDK 回包校验，包体长度错误。
+    ERR_LOGIN_OPENMSG_TIMEOUT                   = 6218,   ///< 登录时 OPENSTATSVC 向 OPENMSG 上报状态超时。
+    ERR_LOGIN_OPENMSG_RSP_PARSE_FAILED          = 6219,   ///< 登录时 OPENSTATSVC 向 OPENMSG 上报状态时解析回包失败。
+    ERR_LOGIN_TLS_DECRYPT_FAILED                = 6220,   ///< 登录时 TLS SDK 解密失败。
+    ERR_WIFI_NEED_AUTH                          = 6221,   ///< WIFI 需要认证。
+    ERR_USER_CANCELED                           = 6222,   ///< 用户已取消。
+    ERR_REVOKE_TIME_LIMIT_EXCEED                = 6223,   ///< 消息撤回超过了时间限制（默认2分钟）。
+    ERR_LACK_UGC_EXT                            = 6224,   ///< 缺少 UGC 扩展包。
+    ERR_AUTOLOGIN_NEED_USERSIG                  = 6226,   ///< 自动登录，本地票据过期，需要 UserSig 手动登录。
+    ERR_QAL_NO_SHORT_CONN_AVAILABLE             = 6300,   ///< 没有可用的短连接 SSO 。
+    ERR_REQ_CONTENT_ATTACK                      = 80101,  ///< 消息内容安全打击。
+    ERR_LOGIN_SIG_EXPIRE                        = 70101,  ///< 登录返回，票据过期。
+    ERR_SDK_HAD_INITIALIZED                     = 90101,  ///< IM SDK 已经初始化无需重复初始化。
+    ERR_OPENBDH_BASE                            = 115000, ///< OpenBDH 错误码基。
+    ERR_REQUEST_NO_NET_ONREQ                    = 6250,   ///< 请求时没有网络，请等网络恢复后重试。
+    ERR_REQUEST_NO_NET_ONRSP                    = 6251,   ///< 响应时没有网络，请等网络恢复后重试。
+    ERR_REQUEST_FAILED                          = 6252,   ///< QALSDK 执行失败。
+    ERR_REQUEST_INVALID_REQ                     = 6253,   ///< 请求非法，toMsgService 非法。
+    ERR_REQUEST_OVERLOADED                      = 6254,   ///< 请求队列満。
+    ERR_REQUEST_KICK_OFF                        = 6255,   ///< 已经被其他终端踢了。
+    ERR_REQUEST_SERVICE_SUSPEND                 = 6256,   ///< 服务被暂停。
+    ERR_REQUEST_INVALID_SIGN                    = 6257,   ///< SSO 签名错误。
+    ERR_REQUEST_INVALID_COOKIE                  = 6258,   ///< SSO cookie 无效。
+    
+};
+
+#endif /* TIMErrorCode_h */

+//
+//  TIMFriendshipDefine.h
+//  imsdk
+//
+//  Created by annidyfeng on 2019/3/7.
+//  Copyright © 2019年 Tencent. All rights reserved.
+//
+
+#ifndef TIMFriendshipDefine_h
+#define TIMFriendshipDefine_h
+
+#import "ImSDK.h"
+
+@class TIMFriendPendencyResponse;
+@class TIMFriendPendencyItem;
+@class TIMFriendFutureMeta;
+@class TIMFriendGroup;
+
+#pragma mark - 枚举类型
+
+/**
+ * 好友操作状态
+ *
+ * 详细错误码参见 https://cloud.tencent.com/document/product/269/1671#.E5.85.B3.E7.B3.BB.E9.93.BE.E9.94.99.E8.AF.AF.E7.A0.81
+ */
+typedef NS_ENUM(NSInteger, TIMFriendStatus) {
+    /**
+     *  操作成功
+     */
+    TIM_FRIEND_STATUS_SUCC                              = 0,
+    
+    /**
+     *  请求参数错误，请根据错误描述检查请求是否正确
+     */
+    TIM_FRIEND_PARAM_INVALID                                = 30001,
+
+    /**
+     *  请求参数错误，SdkAppid 不匹配。
+     */
+    TIM_FRIEND_SDK_APPID_INVALID                            = 30002,
+
+    /**
+     *  请求的用户帐号不存在
+     */
+    TIM_FRIEND_ID_INVALID                                   = 30003,
+
+    /**
+     *  请求需要 App 管理员权限
+     */
+    TIM_FRIEND_NEED_ADMIN_PERMISSON                         = 30004,
+
+    /**
+     *  关系链字段中包含敏感词
+     */
+    TIM_FRIEND_DIRTY_WORD                                   = 30005,
+    
+    /**
+     *  服务器内部错误，请重试
+     */
+    TIM_FRIEND_SERVER_ERROR                                 = 30006,
+
+    /**
+     *  网络超时，请稍后重试
+     */
+    TIM_FRIEND_TIMEOUT                                      = 30007,
+
+    /**
+     *  并发写导致写冲突，建议使用批量方式
+     */
+    TIM_FRIEND_WRITE_ERROR                                  = 30008,
+
+    /**
+     *  后台禁止该用户发起加好友请求
+     */
+    TIM_ADD_FRIEND_FORBIDEN                                 = 30009,
+    
+    /**
+     *  自己的好友数已达系统上限
+     */
+    TIM_ADD_FRIEND_STATUS_SELF_FRIEND_FULL                  = 30010,
+    
+    /**
+     * 分组已达系统上限
+     */
+    TIM_UPDATE_FRIEND_GROUP_STATUS_MAX_GROUPS_EXCEED        = 30011,
+
+    /**
+     * 未决数已达系统上限。
+     */
+    TIM_PENDENCY_STATUS_FULL                                = 30012,
+    
+    /**
+     * 黑名单数已达系统上限
+     */
+    TIM_ADD_BLACKLIST_STATUS_FULL                           = 30013,
+    
+    /**
+     *  对方的好友数已达系统上限
+     */
+    TIM_ADD_FRIEND_STATUS_THEIR_FRIEND_FULL                 = 30014,
+    
+    /**
+     *  被加好友在自己的黑名单中
+     */
+    TIM_ADD_FRIEND_STATUS_IN_SELF_BLACK_LIST                = 30515,
+    
+    /**
+     *  被加好友设置为禁止加好友
+     */
+    TIM_ADD_FRIEND_STATUS_FRIEND_SIDE_FORBID_ADD            = 30516,
+    
+    /**
+     *  已被被添加好友设置为黑名单
+     */
+    TIM_ADD_FRIEND_STATUS_IN_OTHER_SIDE_BLACK_LIST          = 30525,
+    
+    /**
+     *  等待好友审核同意
+     */
+    TIM_ADD_FRIEND_STATUS_PENDING                           = 30539,
+    
+    /**
+     *  添加好友请求被安全策略打击，请勿频繁发起添加好友请求
+     */
+    TIM_ADD_FRIEND_STATUS_SENSITIVE                         = 30540,
+    
+    /**
+     *  对方没有申请过好友
+     */
+    TIM_RESPONSE_FRIEND_STATUS_NO_REQ                       = 30614,
+    
+    /**
+     *  删除好友请求被安全策略打击，请勿频繁发起删除好友请求
+     */
+    TIM_DELETE_FRIEND_STATUS_SENSITIVE                      = 31707,
+};
+
+typedef NS_ENUM(NSInteger, TIMDelFriendType) {
+    /**
+     *  删除单向好友
+     */
+    TIM_FRIEND_DEL_SINGLE               = 1,
+    
+    /**
+     *  删除双向好友
+     */
+    TIM_FRIEND_DEL_BOTH                 = 2,
+};
+
+typedef NS_ENUM(NSInteger, TIMPendencyType) {
+    /**
+     *  别人发给我的
+     */
+    TIM_PENDENCY_COME_IN                    = 1,
+    
+    /**
+     *  我发给别人的
+     */
+    TIM_PENDENCY_SEND_OUT                   = 2,
+    
+    /**
+     * 别人发给我的 和 我发给别人的。仅拉取时有效
+     */
+    TIM_PENDENCY_BOTH                       = 3,
+};
+
+/**
+ * 推荐好友类型
+ */
+typedef NS_ENUM(NSInteger, TIMFutureFriendType) {
+    /**
+     *  收到的未决请求
+     */
+    TIM_FUTURE_FRIEND_PENDENCY_IN_TYPE              = 0x1,
+    
+    /**
+     *  发出去的未决请求
+     */
+    TIM_FUTURE_FRIEND_PENDENCY_OUT_TYPE             = 0x2,
+    
+    /**
+     *  推荐好友
+     */
+    TIM_FUTURE_FRIEND_RECOMMEND_TYPE                = 0x4,
+    
+    /**
+     *  已决好友
+     */
+    TIM_FUTURE_FRIEND_DECIDE_TYPE                   = 0x8,
+};
+
+/**
+ * 翻页选项
+ */
+typedef NS_ENUM(NSInteger, TIMPageDirectionType) {
+    /**
+     *  向上翻页
+     */
+    TIM_PAGE_DIRECTION_UP_TYPE            = 1,
+    
+    /**
+     *  向下翻页
+     */
+    TIM_PAGE_DIRECTION_DOWN_TYPE           = 2,
+};
+
+/**
+ *  好友检查类型
+ */
+typedef NS_ENUM(NSInteger,TIMFriendCheckType) {
+    /**
+     *  单向好友
+     */
+    TIM_FRIEND_CHECK_TYPE_UNIDIRECTION     = 0x1,
+    /**
+     *  互为好友
+     */
+    TIM_FRIEND_CHECK_TYPE_BIDIRECTION      = 0x2,
+};
+
+/**
+ *  好友关系类型
+ */
+typedef NS_ENUM(NSInteger,TIMFriendRelationType) {
+    /**
+     *  不是好友
+     */
+    TIM_FRIEND_RELATION_TYPE_NONE           = 0x0,
+    /**
+     *  对方在我的好友列表中
+     */
+    TIM_FRIEND_RELATION_TYPE_MY_UNI         = 0x1,
+    /**
+     *  我在对方的好友列表中
+     */
+    TIM_FRIEND_RELATION_TYPE_OTHER_UNI      = 0x2,
+    /**
+     *  互为好友
+     */
+    TIM_FRIEND_RELATION_TYPE_BOTHWAY        = 0x3,
+};
+
+typedef NS_ENUM(NSInteger, TIMFriendResponseType) {
+    /**
+     *  同意加好友（建立单向好友）
+     */
+    TIM_FRIEND_RESPONSE_AGREE                       = 0,
+    
+    /**
+     *  同意加好友并加对方为好友（建立双向好友）
+     */
+    TIM_FRIEND_RESPONSE_AGREE_AND_ADD               = 1,
+    
+    /**
+     *  拒绝对方好友请求
+     */
+    TIM_FRIEND_RESPONSE_REJECT                      = 2,
+};
+
+/**
+ *  好友检查类型
+ */
+typedef NS_ENUM(NSInteger,TIMFriendAddType) {
+    /**
+     *  单向好友
+     */
+    TIM_FRIEND_ADD_TYPE_SINGLE     = 1,
+    /**
+     *  互为好友
+     */
+    TIM_FRIEND_ADD_TYPE_BOTH       = 2,
+};
+#pragma mark - block回调
+
+/**
+ * 获取未决请求列表成功
+ *
+ *  @param pendencyResponse 未决请求元信息
+ */
+typedef void (^TIMGetFriendPendencyListSucc)(TIMFriendPendencyResponse *pendencyResponse);
+
+/**
+ *  群搜索回调
+ *
+ *  @param totalNum 搜索结果的总数
+ *  @param users    请求的用户列表片段
+ */
+typedef void (^TIMUserSearchSucc)(uint64_t totalNum, NSArray * users);
+
+/**
+ *  好友分组列表
+ *
+ *  @param groups 好友分组（TIMFriendGroup*)列表
+ */
+typedef void (^TIMFriendGroupArraySucc)(NSArray<TIMFriendGroup *> * groups);
+
+/**
+ *  好友关系检查回调
+ *
+ *  @param results TIMCheckFriendResult列表
+ */
+typedef void (^TIMFriendCheckSucc)(NSArray* results);
+
+#pragma mark - 基本类型
+
+/**
+ *  加好友请求
+ */
+@interface TIMFriendRequest : TIMCodingModel
+
+/**
+ *  用户identifier（必填）
+ */
+@property (nonatomic,strong) NSString* identifier;
+
+/**
+ *  备注（备注最大96字节）
+ */
+@property (nonatomic,strong) NSString* remark;
+
+/**
+ *  请求说明（最大120字节）
+ */
+@property (nonatomic,strong) NSString* addWording;
+
+/**
+ *  添加来源
+ *  来源需要添加“AddSource_Type_”前缀
+ */
+@property (nonatomic,strong) NSString* addSource;
+
+/**
+ *  分组
+ */
+@property (nonatomic,strong) NSString* group;
+
+/**
+ *  加好友方式 (可选)
+ */
+@property (nonatomic,assign) TIMFriendAddType addType;
+
+@end
+
+/**
+ * 未决请求
+ */
+@interface TIMFriendPendencyItem : TIMCodingModel
+
+/**
+ * 用户标识
+ */
+@property(nonatomic,strong) NSString* identifier;
+/**
+ * 增加时间
+ */
+@property(nonatomic,assign) uint64_t addTime;
+/**
+ * 来源
+ */
+@property(nonatomic,strong) NSString* addSource;
+/**
+ * 加好友附言
+ */
+@property(nonatomic,strong) NSString* addWording;
+
+/**
+ * 加好友昵称
+ */
+@property(nonatomic,strong) NSString* nickname;
+
+/**
+ * 未决请求类型
+ */
+@property(nonatomic,assign) TIMPendencyType type;
+
+@end
+
+/**
+ * 未决推送
+ */
+@interface TIMFriendPendencyInfo : TIMCodingModel
+/**
+ * 用户标识
+ */
+@property(nonatomic,strong) NSString* identifier;
+/**
+ * 来源
+ */
+@property(nonatomic,strong) NSString* addSource;
+/**
+ * 加好友附言
+ */
+@property(nonatomic,strong) NSString* addWording;
+
+/**
+ * 加好友昵称
+ */
+@property(nonatomic,strong) NSString* nickname;
+@end
+
+/**
+ * 未决请求信息
+ */
+@interface TIMFriendPendencyRequest : TIMCodingModel
+
+/**
+ * 序列号，未决列表序列号
+ *    建议客户端保存seq和未决列表，请求时填入server返回的seq
+ *    如果seq是server最新的，则不返回数据
+ */
+@property(nonatomic,assign) uint64_t seq;
+
+/**
+ * 翻页时间戳，只用来翻页，server返回0时表示没有更多数据，第一次请求填0
+ *    特别注意的是，如果server返回的seq跟填入的seq不同，翻页过程中，需要使用客户端原始seq请求，直到数据请求完毕，才能更新本地seq
+ */
+@property(nonatomic,assign) uint64_t timestamp;
+
+/**
+ * 每页的数量，即本次请求最多返回多个数据，建议最大不超过 100，设置太大一次请求回包的时间会过长
+ */
+@property(nonatomic,assign) uint64_t numPerPage;
+
+/**
+ * 未决请求拉取类型
+ */
+@property(nonatomic,assign) TIMPendencyType type;
+
+@end
+
+/**
+ * 未决返回信息
+ */
+@interface TIMFriendPendencyResponse : TIMCodingModel
+
+/**
+ * 本次请求的未决列表序列号
+ */
+@property(nonatomic,assign) uint64_t seq;
+
+/**
+ * 本次请求的翻页时间戳
+ */
+@property(nonatomic,assign) uint64_t timestamp;
+
+/**
+ * 未决请求未读数量
+ */
+@property(nonatomic,assign) uint64_t unreadCnt;
+
+/**
+ * 未决数据
+ */
+@property NSArray<TIMFriendPendencyItem *> * pendencies;
+
+@end
+
+/**
+ *  好友分组信息
+ */
+@interface TIMFriendGroup : TIMCodingModel
+/**
+ *  好友分组名称
+ */
+@property(nonatomic,strong) NSString* name;
+
+/**
+ *  分组成员数量
+ */
+@property(nonatomic,assign) uint64_t userCnt;
+
+/**
+ *  分组成员identifier列表
+ */
+@property(nonatomic,strong) NSArray* friends;
+
+@end
+
+/**
+ *  好友关系检查
+ */
+@interface TIMFriendCheckInfo : NSObject
+/**
+ *  检查用户的id列表（NSString*）
+ */
+@property(nonatomic,strong) NSArray* users;
+
+/**
+ *  检查类型
+ */
+@property(nonatomic,assign) TIMFriendCheckType checkType;
+
+@end
+
+@interface TIMCheckFriendResult : NSObject
+/**
+ *  用户id
+ */
+@property NSString* identifier;
+
+/**
+ * 返回码
+ */
+@property NSInteger result_code;
+
+/**
+ * 返回信息
+ */
+@property NSString *result_info;
+
+/**
+ *  检查结果
+ */
+@property(nonatomic,assign) TIMFriendRelationType resultType;
+
+@end
+
+@interface TIMFriendResult : NSObject
+
+/**
+ *  用户Id
+ */
+@property NSString* identifier;
+
+/**
+ * 返回码
+ */
+@property NSInteger result_code;
+
+/**
+ * 返回信息
+ */
+@property NSString *result_info;
+
+@end
+
+/**
+ * 响应好友请求
+ */
+@interface TIMFriendResponse : NSObject
+
+/**
+ *  响应类型
+ */
+@property(nonatomic,assign) TIMFriendResponseType responseType;
+
+/**
+ *  用户identifier
+ */
+@property(nonatomic,strong) NSString* identifier;
+
+/**
+ *  备注好友（可选，如果要加对方为好友）。备注最大96字节
+ */
+@property(nonatomic,strong) NSString* remark;
+
+@end
+
+
+/**
+ *  好友分组信息扩展
+ */
+@interface TIMFriendGroupWithProfiles : TIMFriendGroup
+/**
+ *  好友资料（TIMUserProfile*）列表
+ */
+@property(nonatomic,strong) NSArray* profiles;
+@end
+
+// 用户资料KEY
+
+/**
+ * 昵称
+ * 值类型: NSString
+ */
+extern NSString *const TIMProfileTypeKey_Nick;
+/**
+ * 头像
+ * 值类型: NSString
+ */
+extern NSString *const TIMProfileTypeKey_FaceUrl;
+/**
+ * 好友申请
+ * 值类型: NSNumber [TIM_FRIEND_ALLOW_ANY,TIM_FRIEND_NEED_CONFIRM,TIM_FRIEND_DENY_ANY]
+ */
+extern NSString *const TIMProfileTypeKey_AllowType;
+/**
+ * 性别
+ * 值类型: NSNumber [TIM_GENDER_UNKNOWN,TIM_GENDER_MALE,TIM_GENDER_FEMALE]
+ */
+extern NSString *const TIMProfileTypeKey_Gender;
+/**
+ * 生日
+ * 值类型: NSNumber
+ */
+extern NSString *const TIMProfileTypeKey_Birthday;
+/**
+ * 位置
+ * 值类型: NSString
+ */
+extern NSString *const TIMProfileTypeKey_Location;
+/**
+ * 语言
+ * 值类型: NSNumber
+ */
+extern NSString *const TIMProfileTypeKey_Language;
+/**
+ * 等级
+ * 值类型: NSNumber
+ */
+extern NSString *const TIMProfileTypeKey_Level;
+/**
+ * 角色
+ * 值类型: NSNumber
+ */
+extern NSString *const TIMProfileTypeKey_Role;
+/**
+ * 签名
+ * 值类型: NSString
+ */
+extern NSString *const TIMProfileTypeKey_SelfSignature;
+/**
+ * 自定义字段前缀
+ * 值类型: [NSString,NSData|NSNumber]
+ * @note 当设置自定义字的值NSString对象时，后台会将其转为UTF8保存在数据库中。由于部分用户迁移资料时可能不是UTF8类型，所以在获取资料时，统一返回NSData类型。
+ */
+extern NSString *const TIMProfileTypeKey_Custom_Prefix;
+
+// 好友资料KEY
+
+/**
+ * 备注
+ * 值类型: NSString
+ */
+extern NSString *const TIMFriendTypeKey_Remark;
+/**
+ * 分组
+ * 值类型: [NSArray]
+ */
+extern NSString *const TIMFriendTypeKey_Group;
+/**
+ * 自定义字段前缀
+ * 值类型: [NSString,NSData|NSNumber]
+ */
+extern NSString *const TIMFriendTypeKey_Custom_Prefix;
+#endif /* TIMFriendshipDefine_h */
+

+//
+//  TIMFriendshipManager.h
+//  imsdk
+//
+//  Created by annidyfeng on 2019/3/7.
+//  Copyright © 2019年 Tencent. All rights reserved.
+//
+
+#ifndef TIMFriendshipManager_h
+#define TIMFriendshipManager_h
+
+#import "TIMComm.h"
+#import "TIMFriendshipDefine.h"
+
+@interface TIMFriendshipManager : NSObject
+/**
+ *  获取好友管理器实例
+ *
+ *  @return 管理器实例
+ */
++ (TIMFriendshipManager*)sharedInstance;
+
+/**
+ *  设置自己的资料
+ *
+ *  @param values 需要更新的属性，可一次更新多个字段. 参见 TIMFriendshipDefine.h 的 TIMProfileTypeKey_XXX
+ *  @param succ 成功回调
+ *  @param fail 失败回调
+ *
+ *  @return 0 发送请求成功
+ */
+- (int)modifySelfProfile:(NSDictionary<NSString *, id> *)values succ:(TIMSucc)succ fail:(TIMFail)fail;
+
+/**
+ *  获取自己的资料
+ *
+ *  @param succ  成功回调，返回 TIMUserProfile
+ *  @param fail  失败回调
+ *
+ *  @return 0 发送请求成功
+ */
+- (int)getSelfProfile:(TIMGetProfileSucc)succ fail:(TIMFail)fail;
+
+/**
+ *  在缓存中查询自己的资料
+ *
+ *  @return 返回缓存的资料，未找到返回nil
+ */
+- (TIMUserProfile *)querySelfProfile;
+
+/**
+ *  获取指定用户资料
+ *
+ *  @param identifiers 用户id，非好友的用户也可以
+ *  @prarm forceUpdate 强制从后台拉取
+ *  @param succ 成功回调
+ *  @param fail 失败回调
+ *
+ *  @return 0 发送请求成功
+ */
+- (int)getUsersProfile:(NSArray<NSString *> *)identifiers forceUpdate:(BOOL)forceUpdate succ:(TIMUserProfileArraySucc)succ fail:(TIMFail)fail;
+
+/**
+ *  在缓存中查询用户的资料
+ *
+ *  @praram identifier 用户id，非好友的用户也可以
+ *
+ *  @return 返回缓存的资料，未找到返回nil
+ */
+- (TIMUserProfile *)queryUserProfile:(NSString *)identifier;
+
+/**
+ *  获取好友列表
+ *
+ *  @param succ 成功回调，返回好友(TIMFriend)列表
+ *  @param fail 失败回调
+ *
+ *  @return 0 发送请求成功
+ */
+-(int)getFriendList:(TIMFriendArraySucc)succ fail:(TIMFail)fail;
+
+
+/**
+ *  在缓存中查询用户的关系链数据
+ *
+ *  @praram identifier 用户id
+ *
+ *  @return 返回缓存的关系链数据，未找到返回nil
+ *  @note 缓存数据来自于上一次调用getFriendList，请确保已调用了获取好友列表方法
+ */
+- (TIMFriend *)queryFriend:(NSString *)identifier;
+
+/**
+ *  获取缓存中的关系链列表
+ *
+ *  @return 返回缓存的关系链数据
+ *  @note 缓存数据来自于上一次调用getFriendList，请确保已调用了获取好友列表方法
+ */
+- (NSArray<TIMFriend *> *)queryFriendList;
+
+/**
+ *  检查指定用户的好友关系
+ *
+ *  @param checkInfo 好友检查信息
+ *  @param succ  成功回调，返回检查结果
+ *  @param fail  失败回调
+ *
+ *  @return 0 发送成功
+ */
+- (int)checkFriends:(TIMFriendCheckInfo *)checkInfo succ:(TIMCheckFriendResultArraySucc)succ fail:(TIMFail)fail;
+
+/**
+ *  添加好友
+ *
+ *  @param request 添加好友请求
+ *  @param succ  成功回调(TIMFriendResult)
+ *  @param fail  失败回调
+ *
+ *  @return 0 发送请求成功
+ */
+- (int)addFriend:(TIMFriendRequest *)request succ:(TIMFriendResultSucc)succ fail:(TIMFail)fail;
+
+/**
+ *  响应对方好友邀请
+ *
+ *  @param response  响应请求
+ *  @param succ      成功回调
+ *  @param fail      失败回调
+ *
+ *  @return 0 发送请求成功
+ */
+- (int)doResponse:(TIMFriendResponse *)response succ:(TIMFriendResultSucc)succ fail:(TIMFail)fail;
+
+/**
+ *  删除好友
+ *
+ *  @param identifiers 好友id
+ *  @param delType 删除类型（单向好友、双向好友）
+ *  @param succ  成功回调([TIMFriendResult])
+ *  @param fail  失败回调
+ *
+ *  @return 0 发送请求成功
+ */
+- (int)deleteFriends:(NSArray *)identifiers delType:(TIMDelFriendType)delType succ:(TIMFriendResultArraySucc)succ fail:(TIMFail)fail;
+
+/**
+ *  修改好友
+ *
+ *  @param identifier 好友id
+ *  @param values  需要更新的属性，可一次更新多个字段. 参见 TIMFriendshipDefine.h 的 TIMFriendTypeKey_XXX
+ *  @param succ 成功回调
+ *  @param fail 失败回调
+ *
+ *  @return 0 发送请求成功
+ */
+- (int)modifyFriend:(NSString *)identifier values:(NSDictionary<NSString *, id> *)values succ:(TIMSucc)succ fail:(TIMFail)fail;
+
+/**
+ *  获取未决列表
+ *
+ *  @param pendencyRequest  请求信息，详细参考TIMFriendPendencyRequest
+ *  @param succ 成功回调
+ *  @param fail 失败回调
+ *
+ *  @return 0 发送请求成功
+ */
+- (int)getPendencyList:(TIMFriendPendencyRequest *)pendencyRequest succ:(TIMGetFriendPendencyListSucc)succ fail:(TIMFail)fail;
+
+/**
+ *  未决删除
+ *
+ *  @param type  未决好友类型
+ *  @param identifiers 要删除的未决列表
+ *  @param succ  成功回调
+ *  @param fail  失败回调
+ *
+ *  @return 0 发送请求成功
+ */
+- (int)deletePendency:(TIMPendencyType)type users:(NSArray *)identifiers succ:(TIMSucc)succ fail:(TIMFail)fail;
+
+/**
+ *  未决已读上报
+ *
+ *  @param timestamp 已读时间戳，此时间戳以前的消息都将置为已读
+ *  @param succ  成功回调
+ *  @param fail  失败回调
+ *
+ *  @return 0 发送请求成功
+ */
+- (int)pendencyReport:(uint64_t)timestamp succ:(TIMSucc)succ fail:(TIMFail)fail;
+
+/**
+ *  获取黑名单列表
+ *
+ *  @param succ 成功回调，返回NSString*列表
+ *  @param fail 失败回调
+ *
+ *  @return 0 发送请求成功
+ */
+- (int)getBlackList:(TIMFriendArraySucc)succ fail:(TIMFail)fail;
+
+/**
+ *  添加用户到黑名单
+ *
+ *  @param identifiers 用户列表
+ *  @param succ  成功回调
+ *  @param fail  失败回调
+ *
+ *  @return 0 发送请求成功
+ */
+- (int)addBlackList:(NSArray *)identifiers succ:(TIMFriendResultArraySucc)succ fail:(TIMFail)fail;
+
+/**
+ *  把用户从黑名单中删除
+ *
+ *  @param identifiers 用户列表
+ *  @param succ  成功回调
+ *  @param fail  失败回调
+ *
+ *  @return 0 发送请求成功
+ */
+- (int)deleteBlackList:(NSArray *)identifiers succ:(TIMFriendResultArraySucc)succ fail:(TIMFail)fail;
+
+/**
+ *  新建好友分组
+ *
+ *  @param groupNames  分组名称列表,必须是当前不存在的分组
+ *  @param identifiers 要添加到分组中的好友
+ *  @param succ  成功回调
+ *  @param fail  失败回调
+ *
+ *  @return 0 发送请求成功
+ */
+- (int)createFriendGroup:(NSArray *)groupNames users:(NSArray *)identifiers succ:(TIMFriendResultArraySucc)succ fail:(TIMFail)fail;
+
+/**
+ *  获取指定的好友分组信息
+ *
+ *  @param groupNames      要获取信息的好友分组名称列表,传入nil获得所有分组信息
+ *  @param succ  成功回调，返回 TIMFriendGroup* 列表
+ *  @param fail  失败回调
+ *
+ *  @return 0 发送请求成功
+ */
+- (int)getFriendGroups:(NSArray *)groupNames succ:(TIMFriendGroupArraySucc)succ fail:(TIMFail)fail;
+
+/**
+ *  删除好友分组
+ *
+ *  @param groupNames  要删除的好友分组名称列表
+ *  @param succ  成功回调
+ *  @param fail  失败回调
+ *
+ *  @return 0 发送请求成功
+ */
+- (int)deleteFriendGroup:(NSArray *)groupNames succ:(TIMSucc)succ fail:(TIMFail)fail;
+
+/**
+ *  修改好友分组的名称
+ *
+ *  @param oldName   原来的分组名称
+ *  @param newName   新的分组名称
+ *  @param succ  成功回调
+ *  @param fail  失败回调
+ *
+ *  @return 0 发送请求成功
+ */
+- (int)renameFriendGroup:(NSString*)oldName newName:(NSString*)newName succ:(TIMSucc)succ fail:(TIMFail)fail;
+
+/**
+ *  添加好友到一个好友分组
+ *
+ *  @param groupName   好友分组名称
+ *  @param identifiers  要添加到分组中的好友
+ *  @param succ  成功回调
+ *  @param fail  失败回调
+ *
+ *  @return 0 发送请求成功
+ */
+- (int)addFriendsToFriendGroup:(NSString *)groupName users:(NSArray *)identifiers succ:(TIMFriendResultArraySucc)succ fail:(TIMFail)fail;
+
+/**
+ *  从好友分组中删除好友
+ *
+ *  @param groupName   好友分组名称
+ *  @param identifiers  要移出分组的好友
+ *  @param succ  成功回调
+ *  @param fail  失败回调
+ *
+ *  @return 0 发送请求成功
+ */
+- (int)deleteFriendsFromFriendGroup:(NSString *)groupName users:(NSArray *)identifiers succ:(TIMFriendResultArraySucc)succ fail:(TIMFail)fail;
+@end
+
+#endif /* TIMFriendshipManager_h */