云信在线互动是网易云信的一款针对目前市场比较热门的直播解决方案。在方案中结合了网易云信 IM 能力的聊天室模型和网易云信音视频能力的多人会议模型。在使用本解决方案之前请务必了解聊天室和多人会议能力。
- 主播开始直播(在多人会议中推流)，观众可以观看(用播放器拉流)。
- 观众申请连麦，主播端显示连麦队列。
- 主播选择连麦队列中的某一个观众，观众结束播放器拉流并进入主播的多人会议。此时旁路直播自动开启，其他观众会看到主播和连麦观众合并的画面；主播和连麦观众和收到对方的画面数据，用特定控件(AVChatVideoRender)渲染显示。
- 主播结束连麦，连麦观众自动退出多人会议，并开启播放器进行拉流操作。
由于聊天室和多人会议都不是直接针对直播的方案模型，所以需要在应用上层补充一些控制指令来保证直播业务逻辑。 控制指令分为两套：
- 点对点自定义系统通知，用于主播和连麦者的控制交互，用于保证连麦者的上下麦时机。
- 聊天室广播消息，用于全局通知所有观众当前的连麦状态，观众需要根据连麦状态显示或隐藏一些控件。
| 参数 | 说明 | 值 |
|---|---|---|
| type | 自定义系统通知类型:加入连麦队列通知 | PushMicNotificationType#JOIN_QUEUE |
| roomid | 房间ID | 聊天室ID |
| style | 网络通话类型 | AVChatType枚举 |
| info | 进入聊天队列用户信息 | {"nick" : "","avatar" : ""} 字典 |
| 参数 | 说明 | 值 |
|---|---|---|
| type | 自定义系统通知类型:退出连麦队列通知 | PushMicNotificationType#EXIT_QUEUE |
| roomid | 房间ID | 聊天室ID |
| 参数 | 说明 | 值 |
|---|---|---|
| type | 自定义系统通知类型:主播同意连麦通知 | PushMicNotificationType#CONNECTING_MIC |
| roomid | 房间ID | 聊天室ID |
| style | 连麦者连麦方式 | AVChatType枚举 |
当连麦者受到主播同意连麦通知时，会检查自身的连麦状态，如果连麦状态过期则需要发送一条拒绝消息告诉主播
| 参数 | 说明 | 值 |
|---|---|---|
| type | 自定义系统通知类型:连麦者拒绝连麦通知 | PushMicNotificationType#REJECT_CONNECTING |
| roomid | 房间ID | 聊天室ID |
| 参数 | 说明 | 值 |
|---|---|---|
| type | 自定义系统通知类型:主播强制连麦者断开 | PushMicNotificationType#DISCONNECT_MIC |
| roomid | 房间ID | 聊天室ID |
| 参数 | 说明 |
|---|---|
| uid | 连麦者的 accid |
| nick | 连麦者的昵称 |
| avatar | 连麦者的头像 |
| style | 连麦者的连麦方式 |
| 参数 | 说明 |
|---|---|
| uid | 连麦者的 accid |
源码主要分成四个 package ：base、im、thirdparty 和 entertainment。
- base：封装一些 UI 基类，工具类等。
- im：包含登录页面及登录、注册业务逻辑（ activity / business / config 子包下）、基础 UI 组件( ui 子包下)、 会话页面相关组件( session 子包下)。
- thirdparty：包含网易视频云播放器(拉流)相关的核心组件。
- entertainment：娱乐直播相关的页面和业务逻辑。
下面具体介绍 entertainment 包下的子包结构：
- activity：所有 Activity。
- adapter：聊天页面数据源适配器等。
- constant: 聊天页面数据常量，互动连麦数据常量。
- helper：直播间成员缓存，网络探测缓存，主播收到礼物缓存，礼物动画，互动连麦等帮助类。
- http: 网易云信直播间 Demo Http Client(与云信 Demo 应用服务器通信)
- model: 聊天界面数据实体。
- module：直播间收发消息模块、直播间自定义消息。
- ui: 直播间界面 ui 控件。
- viewholder：界面相关 ViewHolder。
- LivePlayerBaseActivity : 直播间基类。包括直播间的进入/离开的操作，监听直播间在线状态和监听直播间被踢出状态。
- LiveActivity：主播端 Activity。包含主播相关操作。
- AudienceActivity： 观众端 Activity。包含观众相关操作。
- IdentifyActivity： 顶部是网络探测相关控件，底部是选择主播或观众身份相关控件
- EnterRoomActivity： 观众身份填写主播创建的房间id，进入直播间
- ChatRoomMsgViewHolderFactory: 直播间消息项展示ViewHolder工厂类。包括消息展示 ViewHolder 的注册操作。