update ios sdk to 3.3.0

Author: huangminlinux

ios/RCTJMessageModule/JMessage.framework/Headers/JMSGConstants.h

@@ -212,6 +212,10 @@ typedef NS_ENUM(NSInteger, JMSGEventNotificationType) {
 
   /// 事件类型: 消息撤回
   kJMSGEventNotificationMessageRetract = 55,
+  /// 事件类型: 消息透传
+  kJMSGEventNotificationMessageTransparent = 58,
+  /// 事件类型: 消息回执变更
+  kJMSGEventNotificationMessageReceiptStatusChange = 68,
 
   // 消息事件
   /// 事件类型: 群组被创建
@@ -314,6 +318,8 @@ typedef NS_ENUM(NSInteger, JMSGSDKErrorCode) {
   kJMSGErrorSDKMediaHashCodeIllegal = 864006,
   /// 媒体HASH校验失败
   kJMSGErrorSDKMediaHashVerifyFailed = 864007,
+  /// 这条消息不支持转发
+  kJMSGErrorSDKMessageNotSupportForward = 864008,
 
   // ------------------------ Message (865xxx)
 
@@ -413,6 +419,8 @@ typedef NS_ENUM(NSUInteger, JMSGTcpErrorCode) {
   kJMSGErrorTcpUserNotRegistered = 801003,
   /// 用户密码错误
   kJMSGErrorTcpUserPasswordError = 801004,
+  /// 多通道同时登录错误，登录失败
+  kJMSGErrorTcpLoginMultiChannelError = 801007,
   /// 目标用户不存在
   kJMSGErrorTcpTargetUserNotExist = 803003,
   /// 目标群组不存在
@@ -455,14 +463,6 @@ static NSString *const KEY_REGION = @"region";      //区域
 static NSString *const KEY_SIGNATURE = @"signature";//签名
 static NSString *const KEY_ADDRESS = @"address";    //地址
 static NSString *const KEY_STAR = @"star";
-static NSString *const KEY_UID = @"uid";
-static NSString *const KEY_NO_DISTURB = @"no_disturb";
-static NSString *const KEY_BLACKLIST = @"blicklist";
-static NSString *const KEY_NOTE_NAME = @"memo_name";//note_name
-static NSString *const KEY_NOTE_TEXT = @"memo_others";//note_text
-static NSString *const KEY_SHIELD_GROUP = @"shield_group";
-static NSString *const KEY_USER_MTIME = @"mtime";
-static NSString *const KEY_USER_CTIME = @"ctime";
 
 
 

ios/RCTJMessageModule/JMessage.framework/Headers/JMSGConversation.h

@@ -17,6 +17,7 @@
 @class JMSGAbstractContent;
 @class JMSGImageContent;
 @class JMSGOptionalContent;
+@class JMSGMediaAbstractContent;
 
 
 /*!
@@ -218,6 +219,7 @@ JMSG_ASSUME_NONNULL_BEGIN
 @property(nonatomic, strong, readonly) NSString *targetAppKey;
 
 
+
 ///----------------------------------------------------
 /// @name Message Operations 消息相关操作
 ///----------------------------------------------------
@@ -311,16 +313,24 @@ JMSG_ASSUME_NONNULL_BEGIN
  */
 - (JMSGMessage * JMSG_NULLABLE)createMessageWithContent:(JMSGAbstractContent *)content;
 
+
 /*!
  * @abstract 创建消息对象（图片，异步）
  *
- * @param content 准备好的图片内容
+ * 注意：此方法已过期，请使用 createMessageAsyncWithMediaContent: 方法
+ */
+- (void)createMessageAsyncWithImageContent:(JMSGImageContent *)content
+                         completionHandler:(JMSGCompletionHandler JMSG_NULLABLE)handler __attribute__((deprecated("first deprecated in JMessage 3.3.0 - Use -createMessageAsyncWithMediaContent:")));
+/*!
+ * @abstract 创建消息对象（多媒体消息，异步）
+ *
+ * @param content 准备好的多媒体内容，如：图片、语音、文件等
  * @param handler 结果回调. 正常返回时 resultObject 类型为 JMSGMessage.
  *
- * @discussion 对于图片消息，因为 SDK 要做缩图有一定的性能损耗，图片文件很大时存储落地也会较慢。
+ * @discussion 注意：对于多媒体消息，因为 SDK 要做缩图有一定的性能损耗，图片文件很大时存储落地也会较慢。
  * 所以创建图片消息，建议使用这个异步接口。
  */
-- (void)createMessageAsyncWithImageContent:(JMSGImageContent *)content
+- (void)createMessageAsyncWithMediaContent:(JMSGMediaAbstractContent *)content
                          completionHandler:(JMSGCompletionHandler JMSG_NULLABLE)handler;
 
 /*!
@@ -333,12 +343,12 @@ JMSG_ASSUME_NONNULL_BEGIN
 - (void)sendMessage:(JMSGMessage *)message;
 
 /*!
- * @abstract 发送消息（附带可选功能，如：控制离线消息存储、自定义通知栏内容等）
+ * @abstract 发送消息（附带可选功能，如：控制离线消息存储、自定义通知栏内容、消息已读回执等）
  *
  * @param message           通过消息创建类接口，创建好的消息对象
  * @param optionalContent   可选功能，具体请查看 JMSGOptionalContent 类
  *
- * @discussion 可选功能里可以设置离线消息存储、自定义通知栏内容等，具体请查看 JMSGOptionalContent 类。
+ * @discussion 可选功能里可以设置离线消息存储、自定义通知栏内容、消息已读回执等，具体请查看 JMSGOptionalContent 类。
  *
  */
 - (void)sendMessage:(JMSGMessage *)message optionalContent:(JMSGOptionalContent *)optionalContent;
@@ -421,7 +431,23 @@ JMSG_ASSUME_NONNULL_BEGIN
 - (void)retractMessage:(JMSGMessage *)message completionHandler:(JMSGCompletionHandler)handler;
 
 /*!
- * @abstract 异步获取会话头像(仅限单聊)
+ * @abstract 消息透传
+ *
+ * @param transparentText 用户自定义透传内容，仅限 NSString 类型
+ * @param handler 回调，error=nil 表示成功
+ *
+ * @discussion 注意：
+ *
+ *  1. 消息透传功能，消息不会进入到后台的离线存储中去，仅当对方用户当前在线时才会成功送达，可以快速响应，方便开发者拓展自定义行为；
+ *
+ *  2. 可用来快速实现一些在线场景下的辅助功能 ：输入状态提示、位置信息提示、开发者自定义等。
+ *
+ */
+- (void)sendTransparentMessage:(NSString *JMSG_NONNULL)transparentText
+             completionHandler:(JMSGCompletionHandler JMSG_NULLABLE)handler;
+
+/*!
+ * @abstract 异步获取会话头像
  *
  * @param handler 结果回调。回调参数:
  *
@@ -443,7 +469,7 @@ JMSG_ASSUME_NONNULL_BEGIN
  *
  * @return 返回本地路，返回值只有在下载完成之后才有意义
  */
-- (NSString *)avatarLocalPath;
+- (NSString *JMSG_NULLABLE)avatarLocalPath;
 
 ///----------------------------------------------------
 /// @name Conversation State Maintenance 会话状态维护
@@ -463,6 +489,34 @@ JMSG_ASSUME_NONNULL_BEGIN
  */
 - (NSString *)latestMessageContentText;
 
+/*!
+ * @abstract 获取会话所有扩展字段
+ *
+ * @return 返回所有值，NSDictionary 类型
+ *
+ * @discussion 与 [- (void)setExtraValue:forKey:] 配套使用，可用于对会话属性的扩展
+ */
+- (NSDictionary *JMSG_NULLABLE)getConversationExtras;
+
+/*!
+ * @abstract 获取单个扩展字段
+ *
+ * @return 返回 key 对应值，NSString 类型
+ *
+ * @discussion 与 [- (void)setExtraValue:forKey:] 配套使用，可用于对会话属性的扩展
+ */
+- (NSString *JMSG_NULLABLE)getExtraValueForKey:(NSString *JMSG_NONNULL)key;
+
+/*!
+ * @abstract 增加或更新扩展字段,可扩展会话属性，比如：会话置顶、标识特殊会话等
+ *
+ * @param value 新增键值对的值. String 类型.
+ * @param key   新增键值对的键
+ *
+ * @discussion 如果 value = nil，则删除 extras 中 key 对应的值
+ */
+- (void)setExtraValue:(NSString *JMSG_NULLABLE)value forKey:(NSString *JMSG_NONNULL)key;
+
 /*!
  * @abstract 判断消息是否属于这个 Conversation
  *

ios/RCTJMessageModule/JMessage.framework/Headers/JMSGConversationDelegate.h

@@ -37,10 +37,10 @@
 - (void)onUnreadChanged:(NSUInteger)newCount;
 
 /*!
- * @abstract 同步离线消息通知
+ * @abstract 同步离线消息、离线事件通知
  *
  * @param conversation    同步离线消息的会话
- * @param offlineMessages 离线消息数组
+ * @param offlineMessages 离线消息、离线事件数组
  *
  * @discussion 注意：
  *
@@ -53,11 +53,12 @@
  *
  * 3.1.0 版本之后: SDK 会以会话为单位，不管该会话有多少离线消息，SDK同步完成后每个会话只上抛一次.
  *
- * 注意一个会话只会上抛一个会话,这样会大大减轻上层在收到消息事件需要刷新 UI 的应用场景下,UI 刷新的压力.
+ * 3.2.1 版本之后: SDK 会以会话为单位，不管该会话有多少离线事件，SDK同步完成后每个会话只上抛一次
+ *
+ * 注意：一个会话最多触发两次这个代理，即：离线消息和离线事件各一次,这样会大大减轻上层在收到消息刷新 UI 的压力.
  *
  * 上层通过此代理方法监听离线消息同步的会话,详见官方文档.
  *
- * @since 3.1.0
  */
 @optional
 - (void)onSyncOfflineMessageConversation:(JMSGConversation *)conversation

ios/RCTJMessageModule/JMessage.framework/Headers/JMSGEventDelegate.h

@@ -39,11 +39,34 @@
  *
  * @param retractEvent 下发的通知事件，事件类型请查看 JMSGMessageRetractEvent 类
  *
- * @discussion 收到此事件时，可以通过 event.conversation 判断是否属于某个会话
- *
  * @since 3.2.0
  */
 @optional
 - (void)onReceiveMessageRetractEvent:(JMSGMessageRetractEvent *)retractEvent;
+
+/*!
+ * @abstract 消息回执状态变更事件
+ *
+ * @param receiptEvent 下发的通知事件，事件类型请查看 JMSGMessageReceiptStatusChangeEvent 类
+ *
+ * @discussion 上层可以通过 receiptEvent 获取相应信息
+ *
+ * @since 3.3.0
+ */
+@optional
+- (void)onReceiveMessageReceiptStatusChangeEvent:(JMSGMessageReceiptStatusChangeEvent *)receiptEvent;
+
+/*!
+ * @abstract 消息透传事件
+ *
+ * @param transparentEvent 下发的通知事件，事件类型请查看 JMSGMessageTransparentEvent 类
+ *
+ * @discussion 上层可以通过 transparentEvent 获取相应信息，如果自定义的透传信息、会话
+ *
+ * @since 3.3.0
+ */
+@optional
+- (void)onReceiveMessageTransparentEvent:(JMSGMessageTransparentEvent *)transparentEvent;
+
 @end
 

ios/RCTJMessageModule/JMessage.framework/Headers/JMSGFileContent.h

@@ -39,6 +39,25 @@ JMSG_ASSUME_NONNULL_BEGIN
  */
 - (void)fileData:(JMSGAsyncDataHandler)handler;
 
+/*!
+ * @abstract 获取文件内容的数据
+ *
+ * @param progressHandler 下载进度。会持续回调更新进度, 直接下载完成。如果为 nil 则表示不关心进度。
+ * @param handler 结果回调。回调参数:
+ *
+ * - data 文件数据;
+ * - objectId 消息msgId;
+ * - error 不为nil表示出错;
+ *
+ * 如果 error 为 ni, data 也为 nil, 表示没有数据.
+ *
+ * @discussion
+ * 如果本地数据文件已经存在, 则直接返回;
+ * 如果本地还没有文件，会发起网络请求下载。下载完后再回调。
+ */
+- (void)fileDataWithProgress:(JMSGMediaProgressHandler JMSG_NULLABLE)progressHandler
+           completionHandler:(JMSGAsyncDataHandler JMSG_NULLABLE)handler;
+
 JMSG_ASSUME_NONNULL_END
 
 @end