7_4-核心common-聊天室
1 功能概述
该模块位于文件夹 PolyvLiveCommonModule/Modules/Chatroom 下，采用 MVP 模式设计，将 View 层对 SDK 层的聊天室 chatroomManager 的直接调用隔离开，并将多个场景中对 chatroomManager 的共用代码抽离封装起来，使 View 层的逻辑更简洁。
2 核心类介绍
2.1 PLVChatroomPresenter
PLVChatroomPresenter 类主要负责 socket 的登录、socket 消息的接收与发送，同时还提供以下功能：
对直播间数据的在线人数、观看热度、点赞数进行实时更新；
提供发送各类消息的API，并把消息封装成数据模型返回；
加载历史聊天记录，并把加载结果与数据封装成数据模型通过回调通知 Scene 层；
监听 socket 关于聊天消息的接收与删除，并把新消息封装成数据模型，然后通过回调通知 Scene 层。
2.1.1 初始化
在 Scene 层对 PLVChatroomPresenter 进行初始化，初始化方法定义如下：
也可使用 -init 方法初始化，此时每次调用接口获取的聊天消息条数为默认值 20，默认不允许使用分房间功能。
2.1.2 设置监听器
PLVChatroomPresenter 提供了属性 delegate 用于设置回调监听，初始化 presenter 并设置监听的示例代码如下（更多细节参考 Demo 的 PLVLCChatroomViewModel 类）：
属性 delegate 遵循协议 PLVChatroomPresenterProtocol，用于通知 Scene 层聊天室模块的相关 socket 消息和 Http 接口返回的聊天室相关数据（详见 2.1.3）。协议 PLVChatroomPresenterProtocol 的接口定义如下：
2.1.3 获取聊天记录
PLVChatroomPresenter 提供了加载历史聊天记录，加载历史聊天记录方法定义如下：
每次加载的聊天消息条数为初始化时传入的参数 count 的值，或者默认值 20（使用 -init 方法初始化时）。每次调用 Http 接口成功之后，会记录当前成功加载的页数，下次调用方法 -loadHistory 会自动加载下一页数据。
加载聊天记录成功或失败都会通过 2.1.2 所提到的 delegate 方法通知 Scene 层。
注意，初始化 PLVChatroomPresenter 实例对象时，即自动获取了第一页的聊天记录，并触发获取历史聊天记录相关回调。
2.1.4 发送消息
PLVChatroomPresenter 类提供发送各类消息的API，并把消息封装成数据模型返回，具体接口定义如下：
发送消息成功时接口返回消息数据模型，失败时返回 nil。
2.1.5 禁言和踢人
在讲师端，还支持踢人与禁言的操作，在初始化 PLVChatroomPresenter 的实例对象时，可设置属性 specialRole 为 YES，表示当前登录用户是特殊身份（讲师），此时登录用户将不受聊天室是否关闭、禁言的影响，且可以发送对其他在线成员进行禁言、踢人操作。
Scene 层可直接调用 SDK 的 PLVChatroomManager 的以下方法发送禁言/取消禁言、踢人消息：
2.1.5 销毁
Scene 层在退出当前场景时，对 presenter 实例进行销毁操作。销毁方法定义如下：
Last updated
Was this helpful?