shmily

sdk upgrade

1 Pod::Spec.new do |s| 1 Pod::Spec.new do |s|
2 s.name = "HHVDoctorSDK" 2 s.name = "HHVDoctorSDK"
3 - s.version = "2.1.46" 3 + s.version = "2.1.48"
4 s.summary = "和缓视频医生 SDK" 4 s.summary = "和缓视频医生 SDK"
5 5
6 s.description = <<-DESC 6 s.description = <<-DESC
@@ -12,7 +12,6 @@ @@ -12,7 +12,6 @@
12 #import "TIMComm.h" 12 #import "TIMComm.h"
13 13
14 @class TIMGroupPendencyMeta; 14 @class TIMGroupPendencyMeta;
15 -@class TIMCreateGroupMemberInfo;  
16 15
17 #pragma mark - 枚举类型 16 #pragma mark - 枚举类型
18 17
@@ -222,7 +221,7 @@ typedef NS_ENUM(NSInteger, TIMGroupPendencyHandleResult) { @@ -222,7 +221,7 @@ typedef NS_ENUM(NSInteger, TIMGroupPendencyHandleResult) {
222 /** 221 /**
223 * 群成员列表回调 222 * 群成员列表回调
224 * 223 *
225 - * @param members 群成员列表 224 + * @param members 群成员列表,成员类型 TIMGroupMemberInfo
226 */ 225 */
227 typedef void (^TIMGroupMemberSucc)(NSArray * members); 226 typedef void (^TIMGroupMemberSucc)(NSArray * members);
228 227
@@ -231,7 +230,7 @@ typedef void (^TIMGroupMemberSucc)(NSArray * members); @@ -231,7 +230,7 @@ typedef void (^TIMGroupMemberSucc)(NSArray * members);
231 * 230 *
232 * @param arr 群列表,成员类型 TIMGroupInfo 231 * @param arr 群列表,成员类型 TIMGroupInfo
233 */ 232 */
234 -typedef void (^TIMGroupListSucc)(NSArray<TIMGroupInfo *> * arr); 233 +typedef void (^TIMGroupListSucc)(NSArray * arr);
235 234
236 /** 235 /**
237 * 本人群组内成员信息回调 236 * 本人群组内成员信息回调
@@ -330,7 +329,7 @@ typedef void (^TIMGetGroupPendencyListSucc)(TIMGroupPendencyMeta * meta, NSArray @@ -330,7 +329,7 @@ typedef void (^TIMGetGroupPendencyListSucc)(TIMGroupPendencyMeta * meta, NSArray
330 /** 329 /**
331 * 创建成员(TIMCreateGroupMemberInfo*)列表 330 * 创建成员(TIMCreateGroupMemberInfo*)列表
332 */ 331 */
333 -@property(nonatomic,strong) NSArray <TIMCreateGroupMemberInfo *>* membersInfo; 332 +@property(nonatomic,strong) NSArray* membersInfo;
334 333
335 @end 334 @end
336 335
@@ -33,7 +33,6 @@ @@ -33,7 +33,6 @@
33 @class TIMGroupMemberInfoOption; 33 @class TIMGroupMemberInfoOption;
34 @class TIMFriendProfileOption; 34 @class TIMFriendProfileOption;
35 @class TIMFriendResult; 35 @class TIMFriendResult;
36 -@class TIMCheckFriendResult;  
37 36
38 #pragma mark - 枚举类型 37 #pragma mark - 枚举类型
39 38
@@ -659,13 +658,6 @@ typedef void (^TIMFriendResultSucc)(TIMFriendResult *result); @@ -659,13 +658,6 @@ typedef void (^TIMFriendResultSucc)(TIMFriendResult *result);
659 */ 658 */
660 typedef void (^TIMFriendResultArraySucc)(NSArray<TIMFriendResult *> *results); 659 typedef void (^TIMFriendResultArraySucc)(NSArray<TIMFriendResult *> *results);
661 660
662 -/**  
663 - * 检查好友操作回调  
664 - *  
665 - * @param results 检查结果  
666 - */  
667 -typedef void (^TIMCheckFriendResultArraySucc)(NSArray<TIMCheckFriendResult *> *results);  
668 -  
669 #pragma mark - 基本类型 661 #pragma mark - 基本类型
670 662
671 /// 实现 NSCoding 协议 663 /// 实现 NSCoding 协议
@@ -685,8 +677,11 @@ typedef void (^TIMCheckFriendResultArraySucc)(NSArray<TIMCheckFriendResult *> *r @@ -685,8 +677,11 @@ typedef void (^TIMCheckFriendResultArraySucc)(NSArray<TIMCheckFriendResult *> *r
685 ///用户标识接入 SDK 的应用 ID,必填 677 ///用户标识接入 SDK 的应用 ID,必填
686 @property(nonatomic,assign) int sdkAppId; 678 @property(nonatomic,assign) int sdkAppId;
687 679
688 -///用户的账号类型,新版本不需要再填写  
689 -//@property(nonatomic,strong) NSString * accountType; 680 +///用户的账号类型,必填
  681 +@property(nonatomic,strong) NSString * accountType;
  682 +
  683 +///禁用 crash 上报,默认上报 (方法已废弃,客户需要自己集成 Crash 上报逻辑)
  684 +@property(nonatomic,assign) BOOL disableCrashReport DEPRECATED_ATTRIBUTE;
690 685
691 ///禁止在控制台打印 log 686 ///禁止在控制台打印 log
692 @property(nonatomic,assign) BOOL disableLogPrint; 687 @property(nonatomic,assign) BOOL disableLogPrint;
@@ -714,12 +709,21 @@ typedef void (^TIMCheckFriendResultArraySucc)(NSArray<TIMCheckFriendResult *> *r @@ -714,12 +709,21 @@ typedef void (^TIMCheckFriendResultArraySucc)(NSArray<TIMCheckFriendResult *> *r
714 /// 设置用户配置信息 709 /// 设置用户配置信息
715 @interface TIMUserConfig : NSObject 710 @interface TIMUserConfig : NSObject
716 711
  712 +///禁用本地存储(暂未实现)
  713 +//@property(nonatomic,assign) BOOL disableStorage;
  714 +
717 ///禁止消息已读自动上报,一旦禁用自动上报,需要开发者显式调用 setReadMessage ,详情请参考官网文档 [未读消息计数](https://cloud.tencent.com/document/product/269/9151) 715 ///禁止消息已读自动上报,一旦禁用自动上报,需要开发者显式调用 setReadMessage ,详情请参考官网文档 [未读消息计数](https://cloud.tencent.com/document/product/269/9151)
718 @property(nonatomic,assign) BOOL disableAutoReport; 716 @property(nonatomic,assign) BOOL disableAutoReport;
719 717
720 ///开启 C2C 已读回执,只针对 C2C 消息生效,用户开启已读回执功能后,对方调用 setReadMessage 时会同步已读信息到本客户端,您可以在 TIMMessageReceiptListener 监听消息已读回执 718 ///开启 C2C 已读回执,只针对 C2C 消息生效,用户开启已读回执功能后,对方调用 setReadMessage 时会同步已读信息到本客户端,您可以在 TIMMessageReceiptListener 监听消息已读回执
721 @property(nonatomic,assign) BOOL enableReadReceipt; 719 @property(nonatomic,assign) BOOL enableReadReceipt;
722 720
  721 +///不开启最近联系人(暂未实现)
  722 +//@property(nonatomic,assign) BOOL disableRecnetContact;
  723 +
  724 +///不通过 onNewMessage: 抛出最近联系人的最后一条消息(暂未实现)
  725 +//@property(nonatomic,assign) BOOL disableRecentContactNotify;
  726 +
723 ///设置默认拉取的群组资料 727 ///设置默认拉取的群组资料
724 @property(nonatomic,strong) TIMGroupInfoOption * groupInfoOpt; 728 @property(nonatomic,strong) TIMGroupInfoOption * groupInfoOpt;
725 729
@@ -730,28 +734,28 @@ typedef void (^TIMCheckFriendResultArraySucc)(NSArray<TIMCheckFriendResult *> *r @@ -730,28 +734,28 @@ typedef void (^TIMCheckFriendResultArraySucc)(NSArray<TIMCheckFriendResult *> *r
730 @property(nonatomic,strong) TIMFriendProfileOption * friendProfileOpt; 734 @property(nonatomic,strong) TIMFriendProfileOption * friendProfileOpt;
731 735
732 ///用户登录状态监听器 736 ///用户登录状态监听器
733 -@property(nonatomic,weak) id<TIMUserStatusListener> userStatusListener; 737 +@property(nonatomic,strong) id<TIMUserStatusListener> userStatusListener;
734 738
735 ///会话刷新监听器(未读计数、已读同步) 739 ///会话刷新监听器(未读计数、已读同步)
736 -@property(nonatomic,weak) id<TIMRefreshListener> refreshListener; 740 +@property(nonatomic,strong) id<TIMRefreshListener> refreshListener;
737 741
738 ///消息已读回执监听器 742 ///消息已读回执监听器
739 -@property(nonatomic,weak) id<TIMMessageReceiptListener> messageReceiptListener; 743 +@property(nonatomic,strong) id<TIMMessageReceiptListener> messageReceiptListener;
740 744
741 ///消息 svr 重写监听器 745 ///消息 svr 重写监听器
742 -@property(nonatomic,weak) id<TIMMessageUpdateListener> messageUpdateListener; 746 +@property(nonatomic,strong) id<TIMMessageUpdateListener> messageUpdateListener;
743 747
744 ///消息撤回监听器 748 ///消息撤回监听器
745 -@property(nonatomic,weak) id<TIMMessageRevokeListener> messageRevokeListener; 749 +@property(nonatomic,strong) id<TIMMessageRevokeListener> messageRevokeListener;
746 750
747 ///文件上传进度监听器 751 ///文件上传进度监听器
748 -@property(nonatomic,weak) id<TIMUploadProgressListener> uploadProgressListener; 752 +@property(nonatomic,strong) id<TIMUploadProgressListener> uploadProgressListener;
749 753
750 ///群组事件通知监听器 754 ///群组事件通知监听器
751 -@property(nonatomic,weak) id<TIMGroupEventListener> groupEventListener; 755 +@property(nonatomic,strong) id<TIMGroupEventListener> groupEventListener;
752 756
753 ///关系链数据本地缓存监听器 757 ///关系链数据本地缓存监听器
754 -@property(nonatomic,weak) id<TIMFriendshipListener> friendshipListener; 758 +@property(nonatomic,strong) id<TIMFriendshipListener> friendshipListener;
755 759
756 @end 760 @end
757 761
@@ -782,7 +786,7 @@ typedef void (^TIMCheckFriendResultArraySucc)(NSArray<TIMCheckFriendResult *> *r @@ -782,7 +786,7 @@ typedef void (^TIMCheckFriendResultArraySucc)(NSArray<TIMCheckFriendResult *> *r
782 ///Group 消息声音,不设置传入 nil 786 ///Group 消息声音,不设置传入 nil
783 @property(nonatomic,strong) NSString * groupSound; 787 @property(nonatomic,strong) NSString * groupSound;
784 788
785 -///Video 音视频邀请声音,不设置传入 nil (暂不支持) 789 +///Video 音视频邀请声音,不设置传入 nil
786 @property(nonatomic,strong) NSString * videoSound; 790 @property(nonatomic,strong) NSString * videoSound;
787 791
788 @end 792 @end
@@ -948,7 +952,7 @@ typedef void (^TIMCheckFriendResultArraySucc)(NSArray<TIMCheckFriendResult *> *r @@ -948,7 +952,7 @@ typedef void (^TIMCheckFriendResultArraySucc)(NSArray<TIMCheckFriendResult *> *r
948 @property(nonatomic,strong) TIMGroupSelfInfo* selfInfo; 952 @property(nonatomic,strong) TIMGroupSelfInfo* selfInfo;
949 953
950 ///自定义字段集合,key 是 NSString* 类型,value 是 NSData* 类型 954 ///自定义字段集合,key 是 NSString* 类型,value 是 NSData* 类型
951 -@property(nonatomic,strong) NSDictionary<NSString *,NSData *>* customInfo; 955 +@property(nonatomic,strong) NSDictionary* customInfo;
952 956
953 @end 957 @end
954 958
@@ -1025,71 +1029,44 @@ typedef void (^TIMCheckFriendResultArraySucc)(NSArray<TIMCheckFriendResult *> *r @@ -1025,71 +1029,44 @@ typedef void (^TIMCheckFriendResultArraySucc)(NSArray<TIMCheckFriendResult *> *r
1025 ///用户资料 1029 ///用户资料
1026 @interface TIMUserProfile : TIMCodingModel 1030 @interface TIMUserProfile : TIMCodingModel
1027 1031
1028 -/**  
1029 - * 用户 identifier  
1030 - */ 1032 +///用户 identifier
1031 @property(nonatomic,strong) NSString* identifier; 1033 @property(nonatomic,strong) NSString* identifier;
1032 1034
1033 -/**  
1034 - * 用户昵称  
1035 - */ 1035 +///用户昵称
1036 @property(nonatomic,strong) NSString* nickname; 1036 @property(nonatomic,strong) NSString* nickname;
1037 1037
1038 -/**  
1039 - * 好友验证方式  
1040 - */ 1038 +///好友验证方式
1041 @property(nonatomic,assign) TIMFriendAllowType allowType; 1039 @property(nonatomic,assign) TIMFriendAllowType allowType;
1042 1040
1043 -/**  
1044 - * 用户头像  
1045 - */ 1041 +///用户头像
1046 @property(nonatomic,strong) NSString* faceURL; 1042 @property(nonatomic,strong) NSString* faceURL;
1047 1043
1048 -/**  
1049 - * 用户签名  
1050 - */ 1044 +///用户签名
1051 @property(nonatomic,strong) NSData* selfSignature; 1045 @property(nonatomic,strong) NSData* selfSignature;
1052 1046
1053 -/**  
1054 - * 用户性别  
1055 - */ 1047 +///用户性别
1056 @property(nonatomic,assign) TIMGender gender; 1048 @property(nonatomic,assign) TIMGender gender;
1057 1049
1058 -/**  
1059 - * 用户生日  
1060 - */ 1050 +///用户生日
1061 @property(nonatomic,assign) uint32_t birthday; 1051 @property(nonatomic,assign) uint32_t birthday;
1062 1052
1063 -/**  
1064 - * 用户区域  
1065 - */ 1053 +///用户区域
1066 @property(nonatomic,strong) NSData* location; 1054 @property(nonatomic,strong) NSData* location;
1067 1055
1068 -/**  
1069 - * 用户语言  
1070 - */ 1056 +///用户语言
1071 @property(nonatomic,assign) uint32_t language; 1057 @property(nonatomic,assign) uint32_t language;
1072 1058
1073 -/**  
1074 - * 等级  
1075 - */ 1059 +///等级
1076 @property(nonatomic,assign) uint32_t level; 1060 @property(nonatomic,assign) uint32_t level;
1077 1061
1078 -/**  
1079 - * 角色  
1080 - */ 1062 +///角色
1081 @property(nonatomic,assign) uint32_t role; 1063 @property(nonatomic,assign) uint32_t role;
1082 1064
1083 -/**  
1084 - * 自定义字段集合,key是NSString类型,value是NSData类型或者NSNumber类型  
1085 - * key值按照后台配置的字符串传入,不包括 TIMProfileTypeKey_Custom_Prefix 前缀  
1086 - */ 1065 +///自定义字段集合,key 是 NSString 类型,value 是 NSData 类型或者 NSNumber 类型(key 值按照后台配置的字符串传入)
1087 @property(nonatomic,strong) NSDictionary* customInfo; 1066 @property(nonatomic,strong) NSDictionary* customInfo;
1088 1067
1089 @end 1068 @end
1090 1069
1091 -typedef void(^ProfileCallBack) (TIMUserProfile * proflie);  
1092 -  
1093 /** 1070 /**
1094 * 好友 1071 * 好友
1095 */ 1072 */
@@ -1125,15 +1102,10 @@ typedef void(^ProfileCallBack) (TIMUserProfile * proflie); @@ -1125,15 +1102,10 @@ typedef void(^ProfileCallBack) (TIMUserProfile * proflie);
1125 */ 1102 */
1126 @property(nonatomic,assign) uint64_t addTime; 1103 @property(nonatomic,assign) uint64_t addTime;
1127 1104
1128 -/**  
1129 - * 自定义字段集合,key是NSString类型,value是NSData类型或者NSNumber类型  
1130 - * key值按照后台配置的字符串传入,不包括 TIMFriendTypeKey_Custom_Prefix 前缀  
1131 - */ 1105 +///自定义字段集合,key 是 NSString 类型,value 是 NSData 类型或者 NSNumber 类型(key 值按照后台配置的字符串传入)
1132 @property(nonatomic,strong) NSDictionary* customInfo; 1106 @property(nonatomic,strong) NSDictionary* customInfo;
1133 1107
1134 -/**  
1135 - * 好友资料  
1136 - */ 1108 +///好友资料
1137 @property(nonatomic,strong) TIMUserProfile *profile; 1109 @property(nonatomic,strong) TIMUserProfile *profile;
1138 1110
1139 @end 1111 @end
@@ -88,7 +88,7 @@ @@ -88,7 +88,7 @@
88 * 88 *
89 * 1. 仅 C2C 和 GROUP 会话有效、onlineMessage 无效、AVChatRoom 和 BChatRoom 无效。 89 * 1. 仅 C2C 和 GROUP 会话有效、onlineMessage 无效、AVChatRoom 和 BChatRoom 无效。
90 * 2. 可以在 TIMUserConfig 设置的 TIMMessageRevokeListener 监听 onRevokeMessage 消息撤回回调。 90 * 2. 可以在 TIMUserConfig 设置的 TIMMessageRevokeListener 监听 onRevokeMessage 消息撤回回调。
91 - * 3. 遍历本地消息列表,如果消息的 respondsToLocator 函数返回 YES,则是对应的消息,您可以在 UI 上执行删除操作,具体可以参考 TUIMessageController.h 里面的 onRevokeMessage 回调的实现。 91 + * 3. 遍历本地消息列表,如果消息的 respondsToLocator 函数返回 YES,则是对应的消息,您可以在 UI 上执行删除操作,具体可以参考 TMessageController.h 里面的 onRevokeMessage 回调的实现。
92 * 92 *
93 * @param msg 被撤回的消息 93 * @param msg 被撤回的消息
94 * @param succ 成功时回调 94 * @param succ 成功时回调
@@ -99,6 +99,18 @@ @@ -99,6 +99,18 @@
99 - (int)revokeMessage:(TIMMessage*)msg succ:(TIMSucc)succ fail:(TIMFail)fail; 99 - (int)revokeMessage:(TIMMessage*)msg succ:(TIMSucc)succ fail:(TIMFail)fail;
100 100
101 /** 101 /**
  102 + * 同步群的消息撤回通知
  103 + *
  104 + * 针对群组,断线重连后,如果用户处于群组聊天界面,需要业务端主动同步该群组会话的消息撤回通知。其他场景不需要主动同步消息撤回通知。
  105 + *
  106 + * @param succ 成功时回调,同步的通知会通过 TIMMessageRevokeListener 抛出
  107 + * @param fail 失败时回调
  108 + *
  109 + * @return 0 本次操作成功
  110 + */
  111 +- (int)syncRevokeNotify:(TIMSucc)succ fail:(TIMFail)fail;
  112 +
  113 +/**
102 * 删除本地会话消息 114 * 删除本地会话消息
103 * 115 *
104 * 可以在保留会话同时删除本地的会话消息。 116 * 可以在保留会话同时删除本地的会话消息。
@@ -170,6 +182,14 @@ @@ -170,6 +182,14 @@
170 */ 182 */
171 - (TIMMessageDraft*)getDraft; 183 - (TIMMessageDraft*)getDraft;
172 184
  185 +/**
  186 + * 禁用本会话的存储(暂未实现)
  187 + *
  188 + * 1. 需要 initSdk 之后调用
  189 + * 2. 只对当前初始化有效,重启后需要重新设置
  190 + */
  191 +- (void)disableStorage;
  192 +
173 @end 193 @end
174 194
175 #endif /* TIMConversation_h */ 195 #endif /* TIMConversation_h */
@@ -21,8 +21,6 @@ @@ -21,8 +21,6 @@
21 21
22 /** 22 /**
23 * 好友操作状态 23 * 好友操作状态
24 - *  
25 - * 详细错误码参见 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  
26 */ 24 */
27 typedef NS_ENUM(NSInteger, TIMFriendStatus) { 25 typedef NS_ENUM(NSInteger, TIMFriendStatus) {
28 /** 26 /**
@@ -31,109 +29,96 @@ typedef NS_ENUM(NSInteger, TIMFriendStatus) { @@ -31,109 +29,96 @@ typedef NS_ENUM(NSInteger, TIMFriendStatus) {
31 TIM_FRIEND_STATUS_SUCC = 0, 29 TIM_FRIEND_STATUS_SUCC = 0,
32 30
33 /** 31 /**
34 - * 请求参数错误,请根据错误描述检查请求是否正确  
35 - */  
36 - TIM_FRIEND_PARAM_INVALID = 30001,  
37 -  
38 - /**  
39 - * 请求参数错误,SdkAppid 不匹配。  
40 - */  
41 - TIM_FRIEND_SDK_APPID_INVALID = 30002,  
42 -  
43 - /**  
44 - * 请求的用户帐号不存在 32 + * 加好友、响应好友时有效:自己的好友数已达系统上限
45 */ 33 */
46 - TIM_FRIEND_ID_INVALID = 30003,  
47 -  
48 - /**  
49 - * 请求需要 App 管理员权限  
50 - */  
51 - TIM_FRIEND_NEED_ADMIN_PERMISSON = 30004,  
52 - 34 + TIM_ADD_FRIEND_STATUS_SELF_FRIEND_FULL = 30010,
  35 +
53 /** 36 /**
54 - * 关系链字段中包含敏感词 37 + * 更新好友分组时有效:分组已达系统上限
55 */ 38 */
56 - TIM_FRIEND_DIRTY_WORD = 30005, 39 + TIM_UPDATE_FRIEND_GROUP_STATUS_MAX_GROUPS_EXCEED = 30011,
57 40
58 /** 41 /**
59 - * 服务器内部错误,请重试 42 + * 加好友、响应好友时有效:对方的好友数已达系统上限
60 */ 43 */
61 - TIM_FRIEND_SERVER_ERROR = 30006,  
62 - 44 + TIM_ADD_FRIEND_STATUS_THEIR_FRIEND_FULL = 30014,
  45 +
63 /** 46 /**
64 - * 网络超时,请稍后重试 47 + * 加好友时有效:被加好友在自己的黑名单中
65 */ 48 */
66 - TIM_FRIEND_TIMEOUT = 30007,  
67 - 49 + TIM_ADD_FRIEND_STATUS_IN_SELF_BLACK_LIST = 30515,
  50 +
68 /** 51 /**
69 - * 并发写导致写冲突,建议使用批量方式 52 + * 加好友时有效:被加好友设置为禁止加好友
70 */ 53 */
71 - TIM_FRIEND_WRITE_ERROR = 30008,  
72 - 54 + TIM_ADD_FRIEND_STATUS_FRIEND_SIDE_FORBID_ADD = 30516,
  55 +
73 /** 56 /**
74 - * 后台禁止该用户发起加好友请求 57 + * 加好友时有效:已被被添加好友设置为黑名单
75 */ 58 */
76 - TIM_ADD_FRIEND_FORBIDEN = 30009, 59 + TIM_ADD_FRIEND_STATUS_IN_OTHER_SIDE_BLACK_LIST = 30525,
77 60
78 /** 61 /**
79 - * 自己的好友数已达系统上限 62 + * 加好友时有效:对方好友列表已满
80 */ 63 */
81 - TIM_ADD_FRIEND_STATUS_SELF_FRIEND_FULL = 30010, 64 + TIM_ADD_FRIEND_STATUS_OTHER_SIDE_FRIEND_LIST_FULL = 30535,
82 65
83 /** 66 /**
84 - * 分组已达系统上限 67 + * 加好友时有效:等待好友审核同意
85 */ 68 */
86 - TIM_UPDATE_FRIEND_GROUP_STATUS_MAX_GROUPS_EXCEED = 30011,  
87 - 69 + TIM_ADD_FRIEND_STATUS_PENDING = 30539,
  70 +
88 /** 71 /**
89 - * 未决数已达系统上限。 72 + * 删除好友时有效:删除好友时对方不是好友
90 */ 73 */
91 - TIM_PENDENCY_STATUS_FULL = 30012, 74 + TIM_DEL_FRIEND_STATUS_NO_FRIEND = 31704,
92 75
93 /** 76 /**
94 - * 黑名单数已达系统上限 77 + * 响应好友申请时有效:对方没有申请过好友
95 */ 78 */
96 - TIM_ADD_BLACKLIST_STATUS_FULL = 30013, 79 + TIM_RESPONSE_FRIEND_STATUS_NO_REQ = 30614,
97 80
98 /** 81 /**
99 - * 对方的好友数已达系统上限 82 + * 添加黑名单有效:已经在黑名单了
100 */ 83 */
101 - TIM_ADD_FRIEND_STATUS_THEIR_FRIEND_FULL = 30014, 84 + TIM_ADD_BLACKLIST_FRIEND_STATUS_IN_BLACK_LIST = 31307,
102 85
103 /** 86 /**
104 - * 被加好友在自己的黑名单中 87 + * 删除黑名单有效:用户不在黑名单里
105 */ 88 */
106 - TIM_ADD_FRIEND_STATUS_IN_SELF_BLACK_LIST = 30515, 89 + TIM_DEL_BLACKLIST_FRIEND_STATUS_NOT_IN_BLACK_LIST = 31503,
107 90
108 /** 91 /**
109 - * 被加好友设置为禁止加好友 92 + * 创建好友分组时有效:没有拉到SDKAppId
110 */ 93 */
111 - TIM_ADD_FRIEND_STATUS_FRIEND_SIDE_FORBID_ADD = 30516, 94 + TIM_ADD_FRIEND_GROUP_STATUS_GET_SDKAPPID_FAILED = 32207,
112 95
113 /** 96 /**
114 - * 已被被添加好友设置为黑名单 97 + * 创建好友分组时有效:要加入到好友分组中的用户不是好友
115 */ 98 */
116 - TIM_ADD_FRIEND_STATUS_IN_OTHER_SIDE_BLACK_LIST = 30525, 99 + TIM_ADD_FRIEND_GROUP_STATUS_NOT_FRIEND = 32216,
117 100
118 /** 101 /**
119 - * 等待好友审核同意 102 + * 更新好友分组时有效:没有拉到SDKAppId
120 */ 103 */
121 - TIM_ADD_FRIEND_STATUS_PENDING = 30539, 104 + TIM_UPDATE_FRIEND_GROUP_STATUS_GET_SDKAPPID_FAILED = 32511,
122 105
123 /** 106 /**
124 - * 添加好友请求被安全策略打击,请勿频繁发起添加好友请求 107 + * 更新好友分组时有效:要加入到好友分组中的用户不是好友
125 */ 108 */
126 - TIM_ADD_FRIEND_STATUS_SENSITIVE = 30540, 109 + TIM_UPDATE_FRIEND_GROUP_STATUS_ADD_NOT_FRIEND = 32518,
127 110
128 /** 111 /**
129 - * 对方没有申请过好友 112 + * 更新好友分组时有效:要加入到好友分组中的好友已经在分组中
130 */ 113 */
131 - TIM_RESPONSE_FRIEND_STATUS_NO_REQ = 30614, 114 + TIM_UPDATE_FRIEND_GROUP_STATUS_ADD_ALREADY_IN_GROUP = 32519,
132 115
133 /** 116 /**
134 - * 删除好友请求被安全策略打击,请勿频繁发起删除好友请求 117 + * 更新好友分组时有效:要从好友分组中删除的好友不在好友分组中
135 */ 118 */
136 - TIM_DELETE_FRIEND_STATUS_SENSITIVE = 31707, 119 + TIM_UPDATE_FRIEND_GROUP_STATUS_DEL_NOT_IN_GROUP = 32520,
  120 +
  121 +
137 }; 122 };
138 123
139 typedef NS_ENUM(NSInteger, TIMDelFriendType) { 124 typedef NS_ENUM(NSInteger, TIMDelFriendType) {
@@ -238,7 +223,7 @@ typedef NS_ENUM(NSInteger,TIMFriendRelationType) { @@ -238,7 +223,7 @@ typedef NS_ENUM(NSInteger,TIMFriendRelationType) {
238 /** 223 /**
239 * 互为好友 224 * 互为好友
240 */ 225 */
241 - TIM_FRIEND_RELATION_TYPE_BOTHWAY = 0x3, 226 + TIM_FRIEND_RELATION_TYPE_BOTH = 0x3,
242 }; 227 };
243 228
244 typedef NS_ENUM(NSInteger, TIMFriendResponseType) { 229 typedef NS_ENUM(NSInteger, TIMFriendResponseType) {
@@ -513,18 +498,11 @@ typedef void (^TIMFriendCheckSucc)(NSArray* results); @@ -513,18 +498,11 @@ typedef void (^TIMFriendCheckSucc)(NSArray* results);
513 /** 498 /**
514 * 用户id 499 * 用户id
515 */ 500 */
516 -@property NSString* identifier;  
517 -  
518 -/**  
519 - * 返回码  
520 - */  
521 -@property NSInteger result_code;  
522 - 501 +@property(nonatomic,strong) NSString* identifier;
523 /** 502 /**
524 - * 返回信息 503 + * 返回状态
525 */ 504 */
526 -@property NSString *result_info;  
527 - 505 +@property(nonatomic,assign) TIMFriendStatus status;
528 /** 506 /**
529 * 检查结果 507 * 检查结果
530 */ 508 */
@@ -42,13 +42,6 @@ @@ -42,13 +42,6 @@
42 - (int)getSelfProfile:(TIMGetProfileSucc)succ fail:(TIMFail)fail; 42 - (int)getSelfProfile:(TIMGetProfileSucc)succ fail:(TIMFail)fail;
43 43
44 /** 44 /**
45 - * 在缓存中查询自己的资料  
46 - *  
47 - * @return 返回缓存的资料,未找到返回nil  
48 - */  
49 -- (TIMUserProfile *)querySelfProfile;  
50 -  
51 -/**  
52 * 获取指定用户资料 45 * 获取指定用户资料
53 * 46 *
54 * @param identifiers 用户id,非好友的用户也可以 47 * @param identifiers 用户id,非好友的用户也可以
@@ -61,15 +54,6 @@ @@ -61,15 +54,6 @@
61 - (int)getUsersProfile:(NSArray<NSString *> *)identifiers forceUpdate:(BOOL)forceUpdate succ:(TIMUserProfileArraySucc)succ fail:(TIMFail)fail; 54 - (int)getUsersProfile:(NSArray<NSString *> *)identifiers forceUpdate:(BOOL)forceUpdate succ:(TIMUserProfileArraySucc)succ fail:(TIMFail)fail;
62 55
63 /** 56 /**
64 - * 在缓存中查询用户的资料  
65 - *  
66 - * @praram identifier 用户id,非好友的用户也可以  
67 - *  
68 - * @return 返回缓存的资料,未找到返回nil  
69 - */  
70 -- (TIMUserProfile *)queryUserProfile:(NSString *)identifier;  
71 -  
72 -/**  
73 * 获取好友列表 57 * 获取好友列表
74 * 58 *
75 * @param succ 成功回调,返回好友(TIMFriend)列表 59 * @param succ 成功回调,返回好友(TIMFriend)列表
@@ -81,35 +65,6 @@ @@ -81,35 +65,6 @@
81 65
82 66
83 /** 67 /**
84 - * 在缓存中查询用户的关系链数据  
85 - *  
86 - * @praram identifier 用户id  
87 - *  
88 - * @return 返回缓存的关系链数据,未找到返回nil  
89 - * @note 缓存数据来自于上一次调用getFriendList,请确保已调用了获取好友列表方法  
90 - */  
91 -- (TIMFriend *)queryFriend:(NSString *)identifier;  
92 -  
93 -/**  
94 - * 获取缓存中的关系链列表  
95 - *  
96 - * @return 返回缓存的关系链数据  
97 - * @note 缓存数据来自于上一次调用getFriendList,请确保已调用了获取好友列表方法  
98 - */  
99 -- (NSArray<TIMFriend *> *)queryFriendList;  
100 -  
101 -/**  
102 - * 检查指定用户的好友关系  
103 - *  
104 - * @param checkInfo 好友检查信息  
105 - * @param succ 成功回调,返回检查结果  
106 - * @param fail 失败回调  
107 - *  
108 - * @return 0 发送成功  
109 - */  
110 -- (int)checkFriends:(TIMFriendCheckInfo *)checkInfo succ:(TIMCheckFriendResultArraySucc)succ fail:(TIMFail)fail;  
111 -  
112 -/**  
113 * 添加好友 68 * 添加好友
114 * 69 *
115 * @param request 添加好友请求 70 * @param request 添加好友请求
@@ -156,7 +111,7 @@ @@ -156,7 +111,7 @@
156 - (int)modifyFriend:(NSString *)identifier values:(NSDictionary<NSString *, id> *)values succ:(TIMSucc)succ fail:(TIMFail)fail; 111 - (int)modifyFriend:(NSString *)identifier values:(NSDictionary<NSString *, id> *)values succ:(TIMSucc)succ fail:(TIMFail)fail;
157 112
158 /** 113 /**
159 - * 获取未决列表 114 + * 未决列表请求
160 * 115 *
161 * @param pendencyRequest 请求信息,详细参考TIMFriendPendencyRequest 116 * @param pendencyRequest 请求信息,详细参考TIMFriendPendencyRequest
162 * @param succ 成功回调 117 * @param succ 成功回调
@@ -91,7 +91,7 @@ @@ -91,7 +91,7 @@
91 * 91 *
92 * @param group 群组Id 92 * @param group 群组Id
93 * @param members 要加入的成员列表(NSString* 类型数组) 93 * @param members 要加入的成员列表(NSString* 类型数组)
94 - * @param succ 成功回调 (TIMGroupMemberResult 列表) 94 + * @param succ 成功回调
95 * @param fail 失败回调 95 * @param fail 失败回调
96 * 96 *
97 * @return 0:成功;1:失败 97 * @return 0:成功;1:失败
@@ -108,13 +108,25 @@ @@ -108,13 +108,25 @@
108 * @param group 群组Id 108 * @param group 群组Id
109 * @param reason 删除原因 109 * @param reason 删除原因
110 * @param members 要删除的成员列表 110 * @param members 要删除的成员列表
111 - * @param succ 成功回调 (TIMGroupMemberResult 列表) 111 + * @param succ 成功回调
112 * @param fail 失败回调 112 * @param fail 失败回调
113 * 113 *
114 * @return 0:成功;1:失败 114 * @return 0:成功;1:失败
115 */ 115 */
116 - (int)deleteGroupMemberWithReason:(NSString*)group reason:(NSString*)reason members:(NSArray*)members succ:(TIMGroupMemberSucc)succ fail:(TIMFail)fail; 116 - (int)deleteGroupMemberWithReason:(NSString*)group reason:(NSString*)reason members:(NSArray*)members succ:(TIMGroupMemberSucc)succ fail:(TIMFail)fail;
117 117
  118 +/**
  119 + * 获取群公开信息(暂未实现)
  120 + *
  121 + * 任意用户可以获取群公开资料,只能获取公开信息。
  122 + *
  123 + * @param groups 群组Id
  124 + * @param succ 成功回调
  125 + * @param fail 失败回调
  126 + *
  127 + * @return 0:成功;1:失败
  128 + */
  129 +- (int)getGroupPublicInfo:(NSArray*)groups succ:(TIMGroupListSucc)succ fail:(TIMFail)fail;
118 130
119 /** 131 /**
120 * 获取群列表 132 * 获取群列表
@@ -130,14 +142,12 @@ @@ -130,14 +142,12 @@
130 - (int)getGroupList:(TIMGroupListSucc)succ fail:(TIMFail)fail; 142 - (int)getGroupList:(TIMGroupListSucc)succ fail:(TIMFail)fail;
131 143
132 /** 144 /**
133 - * 获取服务器存储的群组信息 145 + * 获取信息
134 * 146 *
135 - * 1. 无论是公开群还是私有群,群成员均可以拉到群组信息。  
136 - * 2. 如果是公开群,非群组成员可以拉到 group\groupName\owner\groupType\createTime\maxMemberNum\memberNum\introduction\faceURL\addOpt\onlineMemberNum\customInfo 这些字段信息。如果是私有群,非群组成员拉取不到群组信息。  
137 - * 3. 群成员和非群成员这个接口都拉取不到 selfInfo 信息。  
138 - * 4. 默认拉取基本资料,如果想要拉取自定义字段,首先要通过 [IM 控制台](https://console.cloud.tencent.com/avc) -> 功能配置 -> 群维度自定义字段 配置相关的 key 和权限,然后在 initSDK 的时候把生成的 key 设置在 IMGroupInfoOption 里面的 groupCustom 字段。需要注意的是,只有对自定义字段的 value 做了赋值或则修改,才能拉取到自定义字段。 147 + * 1. 获取群组资料接口只能由群成员调用,非群成员无法通过此方法获取资料,需要调用 getGroupPublicInfo 获取资料。
  148 + * 2. 默认拉取基本资料,如果想要拉取自定义字段,首先要通过 [IM 控制台](https://console.cloud.tencent.com/avc) -> 功能配置 -> 群维度自定义字段 配置相关的 key 和权限,然后在 initSDK 的时候把生成的 key 设置在 IMGroupInfoOption 里面的 groupCustom 字段。需要注意的是,只有对自定义字段 value 做了赋值或则修改,才能拉取到自定义字段。
139 * 149 *
140 - * @param succ 成功回调,不包含 selfInfo 信息 150 + * @param succ 成功回调,不包含 selfInfo信息
141 * @param fail 失败回调 151 * @param fail 失败回调
142 * 152 *
143 * @return 0:成功;1:失败 153 * @return 0:成功;1:失败
@@ -145,17 +155,6 @@ @@ -145,17 +155,6 @@
145 - (int)getGroupInfo:(NSArray*)groups succ:(TIMGroupListSucc)succ fail:(TIMFail)fail; 155 - (int)getGroupInfo:(NSArray*)groups succ:(TIMGroupListSucc)succ fail:(TIMFail)fail;
146 156
147 /** 157 /**
148 - * 获取本地存储的群组信息  
149 - *  
150 - * 1. 无论是公开群还是私有群,群成员均可以拉到群组信息。  
151 - * 2. 如果是公开群,非群组成员可以拉到 group\groupName\owner\groupType\createTime\maxMemberNum\memberNum\introduction\faceURL\addOpt\onlineMemberNum\customInfo 这些字段信息。如果是私有群,非群组成员拉取不到群组信息。  
152 - * 3. 群成员和非群成员这个接口都拉取不到 selfInfo 信息。  
153 - *  
154 - * @return 群组信息  
155 - */  
156 -- (TIMGroupInfo *)queryGroupInfo:(NSString *)group;  
157 -  
158 -/**  
159 * 获取本人在群组内的成员信息 158 * 获取本人在群组内的成员信息
160 * 159 *
161 * 默认拉取基本资料,如果想要拉取自定义字段,请参考 getGroupInfo 160 * 默认拉取基本资料,如果想要拉取自定义字段,请参考 getGroupInfo
@@ -187,7 +186,7 @@ @@ -187,7 +186,7 @@
187 * 3. 直播大群:只能拉取部分成员(包括群主、管理员和部分成员)。 186 * 3. 直播大群:只能拉取部分成员(包括群主、管理员和部分成员)。
188 * 187 *
189 * @param group 群组Id 188 * @param group 群组Id
190 - * @param succ 成功回调 (TIMGroupMemberInfo 列表) 189 + * @param succ 成功回调(TIMGroupMemberInfo列表)
191 * @param fail 失败回调 190 * @param fail 失败回调
192 * 191 *
193 * @return 0:成功;1:失败 192 * @return 0:成功;1:失败
@@ -201,7 +200,7 @@ @@ -201,7 +200,7 @@
201 * 200 *
202 * @param group 群组Id 201 * @param group 群组Id
203 * @param members 成员Id(NSString*)列表 202 * @param members 成员Id(NSString*)列表
204 - * @param succ 成功回调 (TIMGroupMemberInfo 列表) 203 + * @param succ 成功回调(TIMGroupMemberInfo列表)
205 * @param fail 失败回调 204 * @param fail 失败回调
206 * 205 *
207 * @return 0:成功;1:失败 206 * @return 0:成功;1:失败
@@ -309,7 +308,7 @@ @@ -309,7 +308,7 @@
309 * 308 *
310 * @return 0:成功;1:失败 309 * @return 0:成功;1:失败
311 */ 310 */
312 -- (int)modifyGroupCustomInfo:(NSString*)group customInfo:(NSDictionary<NSString *,NSData *>*)customInfo succ:(TIMSucc)succ fail:(TIMFail)fail; 311 +- (int)modifyGroupCustomInfo:(NSString*)group customInfo:(NSDictionary*)customInfo succ:(TIMSucc)succ fail:(TIMFail)fail;
313 312
314 /** 313 /**
315 * 转让群给新群主 314 * 转让群给新群主
@@ -399,7 +398,7 @@ @@ -399,7 +398,7 @@
399 * 398 *
400 * @return 0:成功;1:失败 399 * @return 0:成功;1:失败
401 */ 400 */
402 -- (int)modifyGroupMemberInfoSetCustomInfo:(NSString*)group user:(NSString*)identifier customInfo:(NSDictionary<NSString*,NSData*> *)customInfo succ:(TIMSucc)succ fail:(TIMFail)fail; 401 +- (int)modifyGroupMemberInfoSetCustomInfo:(NSString*)group user:(NSString*)identifier customInfo:(NSDictionary*)customInfo succ:(TIMSucc)succ fail:(TIMFail)fail;
403 402
404 /** 403 /**
405 * 修改群组是否可被搜索属性 404 * 修改群组是否可被搜索属性
@@ -467,6 +466,17 @@ @@ -467,6 +466,17 @@
467 */ 466 */
468 - (int)pendencyReport:(uint64_t)timestamp succ:(TIMSucc)succ fail:(TIMFail)fail; 467 - (int)pendencyReport:(uint64_t)timestamp succ:(TIMSucc)succ fail:(TIMFail)fail;
469 468
  469 +/**
  470 + * 获取用户所在群组信息(暂未实现)
  471 + *
  472 + * 开启本地缓存后有效
  473 + *
  474 + * @param groups 群组id(NSString*)列表,nil时返回群组列表
  475 + *
  476 + * @return 群组信息(TIMGroupInfo*)列表,assistant未同步时返回nil
  477 + */
  478 +- (NSArray*)getGroupInfo:(NSArray*)groups;
  479 +
470 @end 480 @end
471 481
472 #endif /* TIMGroupManager_Ext_h */ 482 #endif /* TIMGroupManager_Ext_h */
@@ -65,15 +65,15 @@ @@ -65,15 +65,15 @@
65 - (int)conversationCount; 65 - (int)conversationCount;
66 66
67 /** 67 /**
68 - * 初始化存储 68 + * 初始化存储(暂未实现)
69 * 69 *
70 * 仅查看历史消息时使用,如果要收发消息等操作,如login成功,不需要调用此函数 70 * 仅查看历史消息时使用,如果要收发消息等操作,如login成功,不需要调用此函数
71 * 71 *
72 - * @param param 登陆参数(identifier 必须填写,userSig 不用填写) 72 + * @param param 登陆参数(userSig 不用填写)
73 * @param succ 成功回调,收到回调时,可以获取会话列表和消息 73 * @param succ 成功回调,收到回调时,可以获取会话列表和消息
74 * @param fail 失败回调 74 * @param fail 失败回调
75 * 75 *
76 - * @return 0:请求成功;1:请求失败,identifier 为 nil 或则用户已登录 76 + * @return 0:请求成功;1:失败
77 */ 77 */
78 - (int)initStorage:(TIMLoginParam*)param succ:(TIMLoginSucc)succ fail:(TIMFail)fail; 78 - (int)initStorage:(TIMLoginParam*)param succ:(TIMLoginSucc)succ fail:(TIMFail)fail;
79 79
@@ -42,7 +42,7 @@ @@ -42,7 +42,7 @@
42 /** 42 /**
43 * 1.2 初始化 SDK,设置全局配置信息 43 * 1.2 初始化 SDK,设置全局配置信息
44 * 44 *
45 - * 初始化 SDK 需要设置 TIMSdkConfig 信息,TIMSdkConfig 主要包含 sdkAppId 设置、Log 相关逻辑设置、数据库存储路径设置、网络监听设置等,其中 sdkAppId 的获取请参考官网文档 [跑通Demo(iOS与Mac)](https://cloud.tencent.com/document/product/269/32674)。 45 + * 初始化 SDK 需要设置 TIMSdkConfig 信息,TIMSdkConfig 主要包含 sdkAppId 和 accountType 设置、Log 相关逻辑设置、数据库存储路径设置、网络监听设置等,其中 sdkAppId 和 accountType 的获取请参考官网文档 [跑通Demo(iOS与Mac)](https://cloud.tencent.com/document/product/269/32674)。
46 * 46 *
47 * @param config 配置信息,全局有效,详情请参考 TIMComm.h 中的 TIMSdkConfig 定义 47 * @param config 配置信息,全局有效,详情请参考 TIMComm.h 中的 TIMSdkConfig 定义
48 * 48 *
@@ -340,6 +340,31 @@ @@ -340,6 +340,31 @@
340 /// @name 调试相关接口 340 /// @name 调试相关接口
341 /// @{ 341 /// @{
342 /** 342 /**
  343 + * 获取网络状态
  344 + *
  345 + * @return 网络状态,详情请参考 TIMComm.h 中的 TIMNetworkStatus 定义
  346 + */
  347 +- (TIMNetworkStatus)networkStatus;
  348 +
  349 +/**
  350 + * 设置环境(暂未实现)
  351 + *
  352 + * 在 InitSdk 之前调用,注意:除非是 IM 工作人员指定要求设置,否则不需要调用此接口
  353 + *
  354 + * @param env 0:正式环境(默认);1:测试环境
  355 + *
  356 + */
  357 +- (void)setEnv:(int)env;
  358 +
  359 +/**
  360 + * 获取环境类型(暂未实现)
  361 + *
  362 + * @return env 0:正式环境(默认);1:测试环境
  363 + *
  364 + */
  365 +- (int)getEnv;
  366 +
  367 +/**
343 * 获取版本号 368 * 获取版本号
344 * 369 *
345 * @return 返回版本号,字符串表示,例如 v1.1.1 370 * @return 返回版本号,字符串表示,例如 v1.1.1
@@ -374,12 +399,22 @@ @@ -374,12 +399,22 @@
374 */ 399 */
375 -(TIMLogLevel) getLogLevel; 400 -(TIMLogLevel) getLogLevel;
376 401
  402 +///@}
  403 +
  404 +/////////////////////////////////////////////////////////////////////////////////
  405 +//
  406 +// (九)废弃接口
  407 +//
  408 +/////////////////////////////////////////////////////////////////////////////////
  409 +/// @name 废弃接口
  410 +/// @{
377 /** 411 /**
378 - * 重置ImSDK配置信息,内部自动化测试使用 412 + * 获取联网SDK的版本号 (方法已废弃, SDK 不再依赖 QAL 库)
  413 + *
  414 + * @return 返回版本号
379 */ 415 */
380 -- (void)unInit; 416 +- (NSString*)GetQALVersion;
381 417
382 ///@} 418 ///@}
383 -  
384 @end 419 @end
385 #endif 420 #endif
@@ -72,7 +72,7 @@ @@ -72,7 +72,7 @@
72 @property(nonatomic,strong) NSString * fromUser; 72 @property(nonatomic,strong) NSString * fromUser;
73 73
74 /** 74 /**
75 - * 资料变更的昵称(暂未实现 75 + * 资料变更的昵称(如果昵称没有变更,该值为 nil
76 */ 76 */
77 @property(nonatomic,strong) NSString * nickName; 77 @property(nonatomic,strong) NSString * nickName;
78 78
@@ -113,6 +113,15 @@ @@ -113,6 +113,15 @@
113 - (BOOL)remove; 113 - (BOOL)remove;
114 114
115 /** 115 /**
  116 + * 消息是否有断层
  117 + *
  118 + * OnNewMessage 回调收到消息,如果有断层,需要重新 getMessage 补全(有C2C漫游的情况下使用)
  119 + *
  120 + * @return TRUE:有断层;FALSE:无断层
  121 + */
  122 +- (BOOL)hasGap;
  123 +
  124 +/**
116 * 设置自定义整数,默认为 0 125 * 设置自定义整数,默认为 0
117 * 126 *
118 * 1.此自定义字段仅存储于本地,不会同步到 Server,用户卸载应用或则更换终端后无法获取。 127 * 1.此自定义字段仅存储于本地,不会同步到 Server,用户卸载应用或则更换终端后无法获取。
@@ -152,8 +161,6 @@ @@ -152,8 +161,6 @@
152 /** 161 /**
153 * 获取消息定位符 162 * 获取消息定位符
154 * 163 *
155 - * 如果是自己创建的 TIMMessage,需要等到消息发送成功后才能获取到 TIMMessageLocator 里面的具体信息  
156 - *  
157 * @return locator,详情请参考 TIMComm.h 里面的 TIMMessageLocator 定义 164 * @return locator,详情请参考 TIMComm.h 里面的 TIMMessageLocator 定义
158 */ 165 */
159 - (TIMMessageLocator*)locator; 166 - (TIMMessageLocator*)locator;
@@ -61,7 +61,7 @@ @@ -61,7 +61,7 @@
61 */ 61 */
62 @interface TIMImage : NSObject 62 @interface TIMImage : NSObject
63 /** 63 /**
64 - * 图片 ID,内部标识,可用于外部缓存key 64 + * 图片ID,内部标识,可用于外部缓存key
65 */ 65 */
66 @property(nonatomic,strong) NSString * uuid; 66 @property(nonatomic,strong) NSString * uuid;
67 /** 67 /**
@@ -126,7 +126,7 @@ @@ -126,7 +126,7 @@
126 @property(nonatomic,strong) NSArray * imageList; 126 @property(nonatomic,strong) NSArray * imageList;
127 127
128 /** 128 /**
129 - * 上传时任务 ID,可用来查询上传进度(已废弃,请在 TIMUploadProgressListener 监听上传进度) 129 + * 上传时任务Id,可用来查询上传进度(已废弃,请在 TIMUploadProgressListener 监听上传进度)
130 */ 130 */
131 @property(nonatomic,assign) uint32_t taskId DEPRECATED_ATTRIBUTE; 131 @property(nonatomic,assign) uint32_t taskId DEPRECATED_ATTRIBUTE;
132 132
@@ -159,7 +159,7 @@ @@ -159,7 +159,7 @@
159 */ 159 */
160 @interface TIMSoundElem : TIMElem 160 @interface TIMSoundElem : TIMElem
161 /** 161 /**
162 - * 上传时任务 ID,可用来查询上传进度(已废弃,请在 TIMUploadProgressListener 监听上传进度) 162 + * 上传时任务Id,可用来查询上传进度(已废弃,请在 TIMUploadProgressListener 监听上传进度)
163 */ 163 */
164 @property(nonatomic,assign) uint32_t taskId DEPRECATED_ATTRIBUTE; 164 @property(nonatomic,assign) uint32_t taskId DEPRECATED_ATTRIBUTE;
165 /** 165 /**
@@ -263,9 +263,9 @@ @@ -263,9 +263,9 @@
263 @interface TIMVideoElem : TIMElem 263 @interface TIMVideoElem : TIMElem
264 264
265 /** 265 /**
266 - * 上传时任务 ID,可用来查询上传进度(已废弃,请在 TIMUploadProgressListener 监听上传进度) 266 + * 上传时任务Id,可用来查询上传进度
267 */ 267 */
268 -@property(nonatomic,assign) uint32_t taskId DEPRECATED_ATTRIBUTE; 268 +@property(nonatomic,assign) uint32_t taskId;
269 269
270 /** 270 /**
271 * 视频文件路径,发送消息时设置 271 * 视频文件路径,发送消息时设置
@@ -302,7 +302,7 @@ @@ -302,7 +302,7 @@
302 */ 302 */
303 @interface TIMFileElem : TIMElem 303 @interface TIMFileElem : TIMElem
304 /** 304 /**
305 - * 上传时任务 ID,可用来查询上传进度(已废弃,请在 TIMUploadProgressListener 监听上传进度) 305 + * 上传时任务Id,可用来查询上传进度(已废弃,请在 TIMUploadProgressListener 监听上传进度)
306 */ 306 */
307 @property(nonatomic,assign) uint32_t taskId DEPRECATED_ATTRIBUTE; 307 @property(nonatomic,assign) uint32_t taskId DEPRECATED_ATTRIBUTE;
308 /** 308 /**
@@ -310,7 +310,7 @@ @@ -310,7 +310,7 @@
310 */ 310 */
311 @property(nonatomic,strong) NSString * path; 311 @property(nonatomic,strong) NSString * path;
312 /** 312 /**
313 - * 文件内部 ID 313 + * 文件内部ID
314 */ 314 */
315 @property(nonatomic,strong) NSString * uuid; 315 @property(nonatomic,strong) NSString * uuid;
316 /** 316 /**
@@ -407,7 +407,7 @@ @@ -407,7 +407,7 @@
407 */ 407 */
408 @interface TIMSnapshot : NSObject 408 @interface TIMSnapshot : NSObject
409 /** 409 /**
410 - * 图片 ID,不用设置 410 + * 图片ID,不用设置
411 */ 411 */
412 @property(nonatomic,strong) NSString * uuid; 412 @property(nonatomic,strong) NSString * uuid;
413 /** 413 /**
@@ -522,12 +522,12 @@ @@ -522,12 +522,12 @@
522 @end 522 @end
523 523
524 /** 524 /**
525 - * 群 Tips 525 + * 群Tips
526 */ 526 */
527 @interface TIMGroupTipsElem : TIMElem 527 @interface TIMGroupTipsElem : TIMElem
528 528
529 /** 529 /**
530 - * 群组 ID 530 + * 群组Id
531 */ 531 */
532 @property(nonatomic,strong) NSString * group; 532 @property(nonatomic,strong) NSString * group;
533 533
@@ -609,7 +609,7 @@ @@ -609,7 +609,7 @@
609 @property(nonatomic,assign) TIM_GROUP_SYSTEM_TYPE type; 609 @property(nonatomic,assign) TIM_GROUP_SYSTEM_TYPE type;
610 610
611 /** 611 /**
612 - * 群组 ID 612 + * 群组Id
613 */ 613 */
614 @property(nonatomic,strong) NSString * group; 614 @property(nonatomic,strong) NSString * group;
615 615
@@ -784,7 +784,7 @@ extern NSString * const kIOSOfflinePushNoSound; @@ -784,7 +784,7 @@ extern NSString * const kIOSOfflinePushNoSound;
784 - (NSString*)sender; 784 - (NSString*)sender;
785 785
786 /** 786 /**
787 - * 消息 ID,当消息生成时,就已经固定,这种方式可能跟其他用户产生的消息冲突,需要再加一个时间约束,可以认为 10 分钟以内的消息可以使用 msgId 区分,需要在同一个会话内判断。 787 + * 消息 Id,当消息生成时,就已经固定,这种方式可能跟其他用户产生的消息冲突,需要再加一个时间约束,可以认为 10 分钟以内的消息可以使用 msgId 区分,需要在同一个会话内判断。
788 */ 788 */
789 - (NSString*)msgId; 789 - (NSString*)msgId;
790 790
@@ -803,20 +803,19 @@ extern NSString * const kIOSOfflinePushNoSound; @@ -803,20 +803,19 @@ extern NSString * const kIOSOfflinePushNoSound;
803 - (NSDate*)timestamp; 803 - (NSDate*)timestamp;
804 804
805 /** 805 /**
806 - * 获取发送者资料  
807 - *  
808 - * 如果本地有发送者资料,这里会直接通过 return 值 TIMUserProfile 返回发送者资料,如果本地没有发送者资料,这里会直接 return nil,SDK 内部会向服务器拉取发送者资料,并在 profileCallBack 回调里面返回发送者资料。 806 + * 获取发送者资料(发送者为自己时可能为空)
809 * 807 *
810 - * @param profileCallBack 发送者资料回调 808 + * C2C 消息只有字段:identifier、nickname、customInfo,群组消息只有字段:identifier、nickname、faceURL、customInfo。如果要获取更多用户信息,请主动调用 TIMFriendshipManager.h 里面的 getUsersProfile 接口。
  809 + * C2C 消息不携带 faceURL,原因是在 C2C 会话中,对方的用户固定且 faceURL 一般不会变化,如果每条消息都带上这个字段,会造成系统资源的浪费。
811 * 810 *
812 - * @return 发送者资料,nil 表示本地没有获取到资料 811 + * @return 发送者资料,nil 表示没有获取资料
813 */ 812 */
814 -- (TIMUserProfile*)getSenderProfile:(ProfileCallBack)profileCallBack; 813 +- (TIMUserProfile*)getSenderProfile;
815 814
816 /** 815 /**
817 * 获取发送者群内资料(发送者为自己时可能为空) 816 * 获取发送者群内资料(发送者为自己时可能为空)
818 * 817 *
819 - * @return 发送者群内资料,nil 表示没有获取资料或者不是群消息,目前仅能获取字段:member,nameCard,其他的字段获取建议通过 TIMGroupManager+Ext.h -> getGroupMembers 获取 818 + * @return 发送者群内资料,nil 表示没有获取资料或者不是群消息,目前只有字段:member、nameCard、role、customInfo
820 */ 819 */
821 - (TIMGroupMemberInfo*)getSenderGroupMemberProfile; 820 - (TIMGroupMemberInfo*)getSenderGroupMemberProfile;
822 821
@@ -839,6 +838,15 @@ extern NSString * const kIOSOfflinePushNoSound; @@ -839,6 +838,15 @@ extern NSString * const kIOSOfflinePushNoSound;
839 - (TIMMessagePriority)getPriority; 838 - (TIMMessagePriority)getPriority;
840 839
841 /** 840 /**
  841 + * 获取消息所属会话的接收消息选项(仅对群组消息有效)
  842 + *
  843 + * 对于群组会话消息,可以通过消息属性判断本群组设置的接收消息选项,可参阅 [群组管理](https://cloud.tencent.com/document/product/269/9152#.E4.BF.AE.E6.94.B9.E6.8E.A5.E6.94.B6.E7.BE.A4.E6.B6.88.E6.81.AF.E9.80.89.E9.A1.B9)。
  844 + *
  845 + * @return 接收消息选项
  846 + */
  847 +- (TIMGroupReceiveMessageOpt)getRecvOpt;
  848 +
  849 +/**
842 * 拷贝消息中的属性(ELem、priority、online、offlinePushInfo) 850 * 拷贝消息中的属性(ELem、priority、online、offlinePushInfo)
843 * 851 *
844 * @param srcMsg 源消息 852 * @param srcMsg 源消息
This file is too large to display.