update ios sdk to 3.7.0

Author: huangminlinux

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

@@ -212,6 +212,18 @@ typedef NS_ENUM(NSInteger, JMSGPlatformType) {
   kJMSGPlatformTypeWeb        = 16,
 };
 
+/*!
+ * 群成员类型
+ */
+typedef NS_ENUM(NSInteger, JMSGGroupMemberType) {
+  /// 普通成员
+  kJMSGGroupMemberTypeOrdinary = 0,
+  /// 群主
+  kJMSGGroupMemberTypeOwner    = 1,
+  /// 管理员
+  kJMSGGroupMemberTypeAdmin    = 2,
+};
+
 /*!
  * 发送消息透传的的类型
  */
@@ -280,6 +292,8 @@ typedef NS_ENUM(NSInteger, JMSGEventNotificationType) {
   kJMSGEventNotificationGroupTypeChange = 83,
   /// 事件类型: 解散群组
   kJMSGEventNotificationDissolveGroup = 11001,
+  /// 事件类型: 群组成员上限变更
+  kJMSGEventNotificationGroupMaxMemberCountChange = 11002,
 
 
   // 好友相关事件

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

@@ -12,6 +12,7 @@
 #import <Foundation/Foundation.h>
 #import <JMessage/JMSGConstants.h>
 #import <JMessage/JMSGUser.h>
+#import <JMessage/JMSGGroup.h>
 
 @class JMSGMessage;
 @class JMSGAbstractContent;
@@ -190,7 +191,7 @@ JMSG_ASSUME_NONNULL_BEGIN
 /*!
  * @abstract 获取当前所有会话的未读消息的总数
  *
- * @discussion 获取所有会话未读消息总数
+ * @discussion 获取所有会话未读消息总数，开启免打扰的会话未读数不会加入计数
  */
 + (NSNumber *)getAllUnreadCount;
 
@@ -519,7 +520,7 @@ JMSG_ASSUME_NONNULL_BEGIN
 - (void)avatarData:(JMSGAsyncDataHandler)handler;
 
 /*!
- * @abstract 获取会话头像的本地路径(仅限单聊)
+ * @abstract 获取会话头像的本地路径
  *
  * @return 返回本地路，返回值只有在下载完成之后才有意义
  */

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

@@ -12,8 +12,6 @@
 #import <Foundation/Foundation.h>
 #import <JMessage/JMSGAbstractContent.h>
 
-
-
 /*!
  * 事件类型的消息内容
  *
@@ -40,6 +38,11 @@
  */
 - (NSString *JMSG_NULLABLE)getEventFromUsername;
 
+/*!
+ * @abstract 获取事件发起者
+ */
+- (JMSGUser *JMSG_NULLABLE)getEventFromUser;
+
 /*!
  * @abstract 获取事件作用对象用户名列表
  * @return 返回类型为 NSArray，数组成员为事件作用对象的用户名
@@ -49,6 +52,16 @@
  */
 - (NSArray *JMSG_NULLABLE)getEventToUsernameList;
 
+/*!
+ * @abstract 获取事件作用对象列表。
+ */
+- (NSArray <__kindof JMSGUser *>*JMSG_NULLABLE)getEventToUserList;
+
+/*!
+ * @abstract 获取事件自定义字段
+ */
+- (NSString *JMSG_NULLABLE)getEventCustom;
+
 /*!
  @abstract 展示此事件的文本描述
 

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

@@ -14,6 +14,32 @@
 
 @class JMSGUser,JMSGApplyJoinGroupEvent;
 
+/*!
+ * 群成员信息类
+ *
+ * #### 可通过 [JMSGGroup memberInfoList:]和 [JMSGGroup memberInfoWithUsername:appkey:] 两个接口获取群成员信息
+ */
+@interface JMSGGroupMemberInfo : NSObject
+
+/// 成员用户信息
+@property(nonatomic, strong, readonly) JMSGUser *JMSG_NULLABLE user;
+/// 入群时间
+@property(nonatomic, assign, readonly) UInt64 ctime;
+/// 群昵称
+@property(nonatomic, strong, readonly) NSString *JMSG_NULLABLE groupNickname;
+/// 群组成员的身份
+@property(nonatomic, assign, readonly) JMSGGroupMemberType memberType;
+
+/*!
+ * @abstract 获取群成员的展示名
+ *
+ * @discussion 展示优先级：群昵称 > 好友备注(user.noteName) > 用户昵称(user.nickname) > 用户名(user.username)
+ *
+ * #### 同接口 [JMSGGroup memberDisplayName:] 相同效果
+ */
+- (NSString *JMSG_NULLABLE)displayName;
+@end
+
 /*!
  * 群信息类（此类仅用于修改群信息、创建群、群信息展示）
  *
@@ -39,6 +65,8 @@
 @property(nonatomic, assign, readwrite) JMSGGroupType groupType;
 /** 群组人数上限*/
 @property(nonatomic, strong, readonly) NSString *JMSG_NONNULL maxMemberCount;
+/** 群组创建时间*/
+@property(nonatomic, assign, readonly) SInt64  ctime;
 
 @end
 
@@ -343,10 +371,10 @@ JMSG_ASSUME_NONNULL_BEGIN
  * @discussion 一般在群组详情界面调用此接口，展示群组的所有成员列表。
  * 本接口只是在本地请求成员列表，不会发起服务器端请求。
  */
-- (NSArray JMSG_GENERIC(__kindof JMSGUser *)*)memberArray;
+- (NSArray JMSG_GENERIC(__kindof JMSGUser *)*)memberArray __attribute__((deprecated("Use - memberInfoList:")));
 
 /*!
- * @abstract 获取群组成员列表（异步接口）
+ * @abstract 获取群组成员列表（建议使用 [JMSGGroup memberInfoList:] 接口）
  *
  * @handler 成员列表. NSArray 里成员类型是 JMSGUser.
  *
@@ -355,6 +383,27 @@ JMSG_ASSUME_NONNULL_BEGIN
  */
 - (void)memberArrayWithCompletionHandler:(JMSGCompletionHandler JMSG_NULLABLE)handler;
 
+/*!
+ * @abstract 获取所有群成员信息列表
+ *
+ * @handler 成员列表. 类型为 NSArray，里面元素为 JMSGGroupMemberInfo.
+ *
+ * @discussion 返回数据中的 JMSGGroupMemberInfo 包含了成员 user 信息、入群时间、群昵称等
+ */
+- (void)memberInfoList:(JMSGCompletionHandler JMSG_NULLABLE)handler;
+
+/*!
+ * @abstract 获取单个群成员信息
+ *
+ * @param  username 目标用户 username
+ * @param  appkey   目标用户 appkey，不传则默认本应用 appkey
+ * @return 群成员信息对象
+ *
+ * @discussion JMSGGroupMemberInfo 包含了成员 user 信息、入群时间、群昵称等
+ */
+- (JMSGGroupMemberInfo *JMSG_NULLABLE)memberInfoWithUsername:(NSString *JMSG_NONNULL)username
+                                                      appkey:(NSString *JMSG_NULLABLE)appkey;
+
 /*!
  * @abstract 修改群组类型
  *
@@ -392,12 +441,36 @@ JMSG_ASSUME_NONNULL_BEGIN
  */
 - (void)setIsShield:(BOOL)isShield handler:(JMSGCompletionHandler)handler;
 
+/*!
+ * @abstract 设置成员群昵称
+ *
+ * @param nickname 群昵称
+ * @param username 目标用户的 username
+ * @param appKey   目标用户的 appKey,若传入空则默认使用本应用appKey
+ */
+- (void)setGroupNickname:(NSString *JMSG_NULLABLE)nickname
+                username:(NSString *JMSG_NONNULL)username
+                  appKey:(NSString *JMSG_NULLABLE)appKey
+                 handler:(JMSGCompletionHandler JMSG_NULLABLE)handler;
+
+/*!
+ * @abstract 获取成员的群昵称
+ *
+ * @param  username 群成员 username
+ * @patam  appKey   群成员 appKey，不传则默认是本应用 appkey
+ * @return 群昵称
+ *
+ * @discussion 还可以通过获取群成员信息 JMSGGroupMemberInfo 来获取群昵称
+ */
+- (NSString *JMSG_NULLABLE)groupNicknameWithUsername:(NSString *)username
+                                              appKey:(NSString *JMSG_NULLABLE)appKey;
+
 /*!
  * @abstract 群成员禁言设置
  *
  * @param isSilence 是否禁言， YES:是 NO: 否
- * @param username  带设置的用户的 username
- * @param appKey  带设置的用户的 appKey,若传入空则默认使用本应用appKey
+ * @param username  待设置的用户的 username
+ * @param username  带待设置的用户的 appKey,若传入空则默认使用本应用appKey
  * @param handler   结果回调
  *
  * @discussion 注意: 目前 SDK 只支持群主设置群里某个用户禁言
@@ -594,6 +667,15 @@ JMSG_ASSUME_NONNULL_BEGIN
  */
 - (NSString *JMSG_NULLABLE)largeAvatarLocalPath;
 
+/*!
+ * @abstract 获取群成员的展示名
+ *
+ * @param memberUid 群成员的 uid（即：[JMSGUser uid]）
+ *
+ * @discussion 展示优先级：群昵称 > 好友备注(user.noteName) > 用户昵称(user.nickname) > 用户名(user.username)
+ */
+- (NSString *)memberDisplayName:(UInt64)memberUid;
+
 /*!
  * @abstract 获取群组的展示名
  *

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

@@ -66,4 +66,16 @@
 @optional
 - (void)onReceiveGroupAdminApprovalEvent:(JMSGGroupAdminApprovalEvent *)event;
 
+/*!
+ * @abstract 群成员群昵称变更通知
+ *
+ * @param events 群成员昵称变更事件列表
+ *
+ * @discussion 如果是离线事件，SDK 会将所有的修改记录加入数组上抛。事件具体相关属性请查看 JMSGGroupNicknameChangeEvent 类
+ *
+ * @since 3.7.0
+ */
+@optional
+- (void)onReceiveGroupNicknameChangeEvents:(NSArray<__kindof JMSGGroupNicknameChangeEvent*>*)events;
+
 @end

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

@@ -2,7 +2,7 @@
 //  JMSGLocationContent.h
 //  JMessage
 //
-//  Created by 邓永豪 on 16/7/26.
+//  Created by dyh on 16/7/26.
 //  Copyright © 2016年 HXHG. All rights reserved.
 //
 

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

@@ -377,7 +377,7 @@ JMSG_ASSUME_NONNULL_BEGIN
 
 
 /*!
- * 消息ID：这个ID是本地存数据库生成的ID，不是服务器端下发时的ID。
+ * 消息ID：这个 ID 是本地生成的ID，不是服务器端下发时的ID。
  */
 @property(nonatomic, strong, readonly) NSString *msgId;
 
@@ -642,6 +642,15 @@ JMSG_ASSUME_NONNULL_BEGIN
  */
 - (NSString *)toJsonString;
 
+/*!
+ * @abstract JSON 字符串 转换为 消息对象。
+ *
+ * @discussion 遵循 Message JSON 协议的定义。失败时返回 nil
+ *
+ * #### 注意：尽量不要自己随意拼接 json 字符串去转换，容易导致创建的 message 无法正常发送
+ */
++ (JMSGMessage *JMSG_NULLABLE)fromJson:(NSString *JMSG_NONNULL)json;
+
 /*!
  * @abstract 对象比较
  *