Showing
13 changed files
with
223 additions
and
239 deletions
| @@ -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.
No preview for this file type
-
Please register or login to post a comment