聊天室管理

          /*!
 * @abstract 分页获取聊天室详情
 *
 * @param appKey  选填，为 nil 则获取当前应用下的聊天室
 * @param start   分页获取的下标，第一页从  index = 0 开始
 * @param count   一页的数量，每页最大值是 50
 * @param handler 结果回调. 正常返回时 resultObject 类型是 NSArray<JMSGChatRoom>
 *
 * @discussion 该接口总是向服务器端发起请求.
 */
+ (void)getChatRoomListWithAppKey:(NSString *JMSG_NULLABLE)appKey
                            start:(NSInteger)start
                            count:(NSInteger)count
                completionHandler:(JMSGCompletionHandler JMSG_NULLABLE)handler;

        

          /*!
 * @abstract 获取当前用户已加入的聊天室列表
 *
 * @param handler 结果回调. 正常返回时 resultObject 类型是 NSArray<JMSGChatRoom>
 *
 * @discussion 该接口总是向服务器端发起请求.
 */
+ (void)getMyChatRoomListCompletionHandler:(JMSGCompletionHandler JMSG_NULLABLE)handler;

        

          /*!
 * @abstract 获取聊天室详情
 *
 * @param roomIds   待获取详情的聊天室 ID 数组
 * @param handler   结果回调. 正常返回时 resultObject 类型是 NSArray<JMSGChatRoom>
 *
 * @discussion 该接口总是向服务器端发起请求.
 */
+ (void)getChatRoomInfosWithRoomIds:(NSArray *JMSG_NONNULL)roomIds
                  completionHandler:(JMSGCompletionHandler JMSG_NULLABLE)handler;

        

          /*!
 * @abstract 加入聊天室
 *
 * @param roomId    聊天室 id
 * @param handler   结果回调. error = nil 表示加入成功，resultObject 为 JMSGConversation 类型
 *
 * @discussion 成功进入聊天室之后，会将聊天室中最近若干条聊天记录同步下来并以 onReceiveChatRoomConversation: 事件的形式通知到上层，进入聊天室会自动获取最近50条消息。
 */
+ (void)enterChatRoomWithRoomId:(NSString *JMSG_NONNULL)roomId
              completionHandler:(JMSGCompletionHandler JMSG_NULLABLE)handler;

        

          /*!
 * @abstract 退出聊天室
 *
 * @param roomId    聊天室 id
 * @param handler   结果回调. error = nil 表示加入成功.
 *
 * @discussion 退出聊天室后获取不到任何消息和通知.
 */
+ (void)leaveChatRoomWithRoomId:(NSString *JMSG_NONNULL)roomId
              completionHandler:(JMSGCompletionHandler JMSG_NULLABLE)handler;

        

          /*!
 * @abstract 返回聊天室 conversation 列表（异步,已排序）
 *
 * @param handler 结果回调。正常返回时 resultObject 的类型为 NSArray，数组里成员的类型为 JMSGConversation
 *
 * @discussion 当前是返回所有的chatroom conversation 列表，不包括单聊和群聊会话，默认是已经排序。
 */
+ (void)allChatRoomConversation:(JMSGCompletionHandler)handler;

        

          /*!
 * @abstract 获取聊天室会话
 *
 * @param roomId 聊天室 ID
 *
 * @discussion 如果会话还不存在，则返回 nil
 */
+ (JMSGConversation * JMSG_NULLABLE)chatRoomConversationWithRoomId:(NSString *)roomId;

        

          /*!
 * @abstract 创建聊天室会话
 *
 * @param roomId  聊天室 ID。
 * @param handler 结果回调。正常返回时 resultObject 类型为 JMSGConversation。
 *
 * @discussion 如果会话已经存在，则直接返回。如果不存在则创建。
 * 创建会话时如果发现该 roomId 的信息本地还没有，则需要从服务器端上拉取。
 * 如果从服务器上获取 roomId 的信息不存在或者失败，则创建会话失败。
 */
+ (void)createChatRoomConversationWithRoomId:(NSString *)roomId
                           completionHandler:(JMSGCompletionHandler JMSG_NULLABLE)handler;

        

          /*!
 * @abstract 删除聊天室会话
 *
 * @param roomId  聊天室 ID
 *
 * @discussion 除了删除会话本身，还会删除该会话下所有的聊天消息。
 */
+ (BOOL)deleteChatRoomConversationWithRoomId:(NSString *)roomId;

        

          /*!
 * @abstract 接收聊天室消息
 *
 * @param conversation 聊天室会话
 * @param messages      接收到的消息数组，元素是 JMSGMessage
 *
 * @discussion 注意：
 *
 * 接收聊天室的消息与单聊、群聊消息不同，聊天室消息都是通过这个代理方法来接收的。
 *
 * @since 3.4.0
 */
- (void)onReceiveChatRoomConversation:(JMSGConversation *)conversation
                             messages:(NSArray JMSG_GENERIC(__kindof JMSGMessage *)*)messages;

        

          /*!
 * @abstract 添加黑名单
 *
 * @param usernames 用户名列表
 * @param appkey   用户 appKey，usernames 中的所有用户必须在同一个 AppKey 下，不填则默认为本应用 appKey
 * @param handler 结果回调。error 为 nil 表示成功.
 *
 * @since 3.8.0
 */
- (void)addBlacklistWithUsernames:(NSArray <__kindof NSString *>*)usernames
                           appKey:(NSString *JMSG_NULLABLE)appKey
                          handler:(JMSGCompletionHandler JMSG_NULLABLE)handler;

        

          /*!
 * @abstract 删除黑名单
 *
 * @param usernames 用户名列表
 * @param appkey   用户 appKey，usernames 中的所有用户必须在同一个 AppKey 下，不填则默认为本应用 appKey
 * @param handler 结果回调。error 为 nil 表示成功.
 *
 * @since 3.8.0
 */
- (void)deleteBlacklistWithUsernames:(NSArray <__kindof NSString *>*)usernames
                              appKey:(NSString *JMSG_NULLABLE)appKey
                             handler:(JMSGCompletionHandler JMSG_NULLABLE)handler;

        

          /*!
 * @abstract 聊天室的黑名单列表
 *
 * @param handler 结果回调. resultObject 是 NSArray 类型，元素是 JMSGUser
 *
 * @since 3.8.0
 */
- (void)chatRoomBlacklist:(JMSGCompletionHandler JMSG_NULLABLE)handler;

        

          /*!
 * @abstract 添加管理员
 *
 * @param usernames 用户名列表
 * @param appkey    用户 AppKey，不填则默认为本应用 AppKey
 * @param handler   结果回调。error 为 nil 表示成功.
 *
 * @discussion 注意：非 VIP 应用最多设置 15 个管理员，不包括群主本身
 *
 * @since 3.8.0
 */
- (void)addAdminWithUsernames:(NSArray <__kindof NSString *>*)usernames
                       appKey:(NSString *JMSG_NULLABLE)appkey
                      handler:(JMSGCompletionHandler JMSG_NULLABLE)handler;

        

          /*!
 * @abstract 删除管理员
 *
 * @param usernames 用户名列表
 * @param appkey    用户 AppKey，不填则默认为本应用 AppKey
 * @param handler   结果回调。error 为 nil 表示成功.
 *
 * @since 3.8.0
 */
- (void)deleteAdminWithUsernames:(NSArray <__kindof NSString *>*)usernames
                          appKey:(NSString *JMSG_NULLABLE)appkey
                         handler:(JMSGCompletionHandler JMSG_NULLABLE)handler;

        

          /*!
 * @abstract 管理员列表
 *
 * @param handler 结果回调. resultObject 是 NSArray 类型，元素是 JMSGUser
 *
 * @discussion 注意：返回列表中不包含房主.
 *
 * @since 3.8.0
 */
- (void)chatRoomAdminList:(JMSGCompletionHandler JMSG_NULLABLE)handler;

        

          /*!
 * @abstract 设置成员禁言（可设置禁言时间）
 *
 * @param silenceTime 禁言时间戳，单位：毫秒，必须不小于5分钟，不大于1年
 * @param usernames   用户的 username 数组，一次最多500人
 * @param appKey      用户的 appKey，若传入空则默认使用本应用appKey，同一次设置的 usernames 必须在同一个 AppKey 下
 * @param handler     结果回调，error = nil 时，表示成功
 *
 * @discussion 只有房主和管理员可设置；设置成功的话上层会收到相应下发事件。
 *
 * @since 3.8.1
 */
- (void)addChatRoomSilenceWithTime:(SInt64)silenceTime
                         usernames:(NSArray *JMSG_NONNULL)usernames
                            appKey:(NSString *JMSG_NULLABLE)appkey
                           handler:(JMSGCompletionHandler JMSG_NULLABLE)handler;

        

          /*!
 * @abstract 取消成员禁言
 *
 * @param usernames  用户的 username 数组，一次最多500人
 * @param appKey     用户的 appKey，若传入空则默认使用本应用appKey，同一次设置的 usernames 必须在同一个 AppKey 下
 * @param handler   结果回调，error = nil 时，表示成功
 *
 * @discussion 只有房主和管理员可设置；取消成功的话上层会收到相应下发事件。
 *
 * @since 3.8.1
 */
- (void)deleteChatRoomSilenceWithUsernames:(NSArray *JMSG_NONNULL)usernames
                                    appKey:(NSString *JMSG_NULLABLE)appkey
                                   handler:(JMSGCompletionHandler JMSG_NULLABLE)handler;

        

          /*!
 * @abstract 获取禁言状态
 *
 * @param username 用户名
 * @param appKey   用户所在应用 AppKey，不填这默认本应用
 * @param handler  结果回调，resultObject 是 JMSGMemberSilenceInfo 类型
 *                 若 error == nil && resultObject != nil,该成员已被禁言
 *                 若 error == nil && resultObject == nil,该成员未被禁言
 *                 若 error != nil ,请求失败，
 *
 * @discussion 详细信息可查看 JMSGMemberSilenceInfo 类
 *
 * @since 3.8.1
 */
- (void)getChatRoomMemberSilenceWithUsername:(NSString *JMSG_NONNULL)username
                                      appKey:(NSString *JMSG_NULLABLE)appKey
                                     handler:(JMSGCompletionHandler JMSG_NULLABLE)handler;

        

          /*!
 * @abstract 禁言列表
 *
 * @param start 开始位置
 * @param count 需要获取的个数，必须大于 0
 * @param handler 结果回调
 *
 * @since 3.8.1
 */
- (void)getChatRoomSilencesWithStart:(SInt64)start
                               count:(SInt64)count
                             handler:(void(^)(NSArray <__kindof JMSGMemberSilenceInfo *>*JMSG_NULLABLE list,SInt64 total,NSError *JMSG_NULLABLE error))handler;