1v1_7/MSYOUPAI/3rd/NIMChat/NIMKit/Sections/Session/ViewController/NIMSessionViewController.h

//
//  NIMSessionViewController.h
//  NIMKit
//
//  Created by NetEase.
//  Copyright (c) 2015年 NetEase. All rights reserved.
//

#import <UIKit/UIKit.h>
#import <NIMSDK/NIMSDK.h>
#import "NIMSessionConfig.h"
#import "NIMMessageCellProtocol.h"
#import "NIMSessionConfigurateProtocol.h"
#import "YOUPAINIMInputView.h"

@interface NIMSessionViewController : UIViewController<NIMSessionInteractorDelegate,NIMInputActionDelegate,NIMMessageCellDelegate,NIMChatManagerDelegate,NIMConversationManagerDelegate>

@property (nonatomic, strong)  UITableView *tableView;

@property (nonatomic, strong)  YOUPAINIMInputView *sessionInputView;

@property (nonatomic, strong)  NIMSession *session;

/**
 *  当前当初的菜单所关联的消息
 *
 *  @discussion 在菜单点击方法中，想获取所点的消息，可以调用此接口
 */
@property (nonatomic, strong, readonly)     NIMMessage *messageForMenu;

/**
 *  会话页主标题
 *
 *  @discussion 可以更改文字的大小，颜色等属性，文案内容请使用 - (NSString *)sessionTitle 接口
 */
@property (nonatomic, strong, readonly)    UILabel *titleLabel;

/**
 *  会话页子标题
 *
 *  @discussion 可以更改文字的大小，颜色等属性，文案内容请使用 - (NSString *)sessionSubTitle 接口
 */
@property (nonatomic, strong, readonly)    UILabel *subTitleLabel;


/**
 *  初始化方法
 *
 *  @param session 所属会话
 *
 *  @return 会话页实例
 */
- (instancetype)initWithSession:(NIMSession *)session;


#pragma mark - 界面
/**
 *  会话页导航栏标题
 */
- (NSString *)youpaifsessionTitle;

/**
 *  会话页导航栏子标题
 */
- (NSString *)sessionSubTitle;

/**
 *  刷新导航栏标题
 */
- (void)refreshSessionTitle:(NSString *)title;

/**
 *  刷新导航子栏标题
 */
- (void)refreshSessionSubTitle:(NSString *)title;

/**
 *  会话页长按消息可以弹出的菜单
 *
 *  @param message 长按的消息
 *
 *  @return 菜单，为UIMenuItem的数组
 */
- (NSArray *)menusItems:(NIMMessage *)message;

/**
 *  会话页详细配置
 */
- (id<NIMSessionConfig>)sessionConfig;


#pragma mark - 消息接口
/**
 *  发送消息
 *
 *  @param message 消息
 */
- (void)sendMessage:(NIMMessage *)message;

#pragma mark - 录音接口
/**
 *  录音失败回调
 *
 *  @param error 失败原因
 */
- (void)onRecordFailed:(NSError *)error;

/**
 *  录音内容是否可以被发送
 *
 *  @param filepath 录音路径
 *
 *  @return 是否允许发送
 *
 *  @discussion 在此回调里检查录音时长是否满足要求发送的录音时长
 */
- (BOOL)recordFileCanBeSend:(NSString *)filepath;

/**
 *  语音不能发送的原因
 *
 *  @discussion 可以显示录音时间不满足要求之类的文案
 */
- (void)showRecordFileNotSendReason;

#pragma mark - 操作接口

/**
 *  追加多条消息
 *
 *  @param messages 消息集合
 *
 *  @discussion 不会比较时间戳，直接加在消息列表末尾。不会触发 DB 操作，，请手动调用 SDK 里 saveMessage:forSession:completion: 接口。
 */

- (void)uiAddMessages:(NSArray *)messages;


/**
 *  插入多条消息
 *
 *  @param messages 消息集合
 *
 *  @discussion 会比较时间戳，加在合适的地方，不推荐聊天室这种大消息量场景使用。不会触发 DB 操作，，请手动调用 SDK 里 saveMessage:forSession:completion: 接口。
 */

- (void)uiInsertMessages:(NSArray *)messages;

/**
 *  删除一条消息
 *
 *  @param message 消息
 *
 *  @return 被删除的 MessageModel
 *
 *  @discussion 不会触发 DB 操作，请手动调用 SDK 里 deleteMessage: 接口
 */
- (NIMMessageModel *)uiDeleteMessage:(NIMMessage *)message;

/**
 *  更新一条消息
 *
 *  @param message 消息
 *
 *  @discussion 不会触发 DB 操作，请手动调用 SDK 里 updateMessage:forSession:completion: 接口
 */
- (void)uiUpdateMessage:(NIMMessage *)message;

@end