自建视频会议 - Monibuca Meeting 插件

会议室插件（Meeting）为 Monibuca V6 提供 专业视频会议 能力。适用于在线会议、远程协作、培训讲座等场景。

核心特性

多人视频会议：支持 50+ 并发参与者
会议管理：
- 议程管理（Agenda）
- 会议计时器与发言计时
- 举手功能（Raise Hand）
- 等候室（Lobby）控制入场
实时转写：语音自动转文字（需外部 ASR 服务）
AI 智能服务：
- 自动生成会议纪要
- 从转写内容中提取待办任务
- 会议决议总结
录制与控制：
- 会议录制（MP4 格式）
- 屏幕共享
- 主持人权限控制
参与者管理：踢人、禁言、锁定房间、禁用入场

启用方式

features = ["meeting"]

# Meeting 插件依赖 Room 服务
# room feature 会自动启用

架构设计

graph TB
    subgraph Meeting["MeetingPlugin"]
        SM["SessionManager<br/>会议信息、参与者"]
        Agenda["AgendaManager<br/>议程控制"]
        Trans["TranscriptionManager<br/>实时转写"]
        AI["AIService<br/>总结 & 任务提取"]
        Record["RecordingManager<br/>录制控制"]
        Lobby["LobbyManager<br/>等候室"]
        DB["数据持久化<br/>会议、议程、转写"]
    end

    subgraph RS["Room Service"]
        Room["房间管理<br/>主持人 + 参与者"]
        WS["WebSocket<br/>信令通信"]
        API["RoomApi"]
    end

    subgraph Media["媒体层"]
        WHIP["WebRTC WHIP<br/>推流"]
        WHEP["WebRTC WHEP<br/>拉流"]
        ASR["ASR Service<br/>语音识别"]
    end

    Meeting -->|register_callbacks| RS
    SM --> DB
    Agenda --> DB
    Trans --> AI
    Trans --> DB
    Record --> Media
    Lobby --> API
    Room --> API
    API -->|set_room_locked<br/>set_lobby_enabled| Meeting
    WS --> Meeting
    WHIP --> Media
    WHEP --> Media
    Trans -->|实时推送| ASR

会议生命周期

Scheduled → Starting → Active → Paused → Ended

状态	说明
`Scheduled`	会议已排期，等待开始
`Starting`	等候室接纳参与者中
`Active`	会议进行中
`Paused`	会议暂停
`Ended`	会议已结束

信令协议

会议基础信令

Action	方向	说明
`start_meeting`	C→S	主持人开始会议
`end_meeting`	C→S	主持人结束会议
`pause_meeting`	C→S	主持人暂停会议
`resume_meeting`	C→S	主持人恢复会议

参与者控制信令

Action	方向	说明
`mute_participant`	C→S	主持人静音参与者
`unmute_participant`	C→S	主持人取消静音
`kick_participant`	C→S	主持人踢出参与者
`raise_hand`	C→S	参与者举手
`lower_hand`	C→S	参与者放下手
`participant_muted`	S→C	参与者被静音通知
`participant_kicked`	S→C	参与者被踢出通知
`hand_raised`	S→C	举手通知（广播）

议程信令

Action	方向	说明
`update_agenda`	C→S	更新当前议程项
`next_agenda`	C→S	进入下一个议程项
`agenda_changed`	S→C	议程变化通知（广播）

转写与录制信令

Action	方向	说明
`start_transcription`	C→S	启动实时转写
`stop_transcription`	C→S	停止实时转写
`transcription_result`	S→C	转写结果推送
`start_recording`	C→S	开始录制
`stop_recording`	C→S	停止录制

等候室信令

Action	方向	说明
`toggle_lobby`	C→S	开关等候室
`admit_user`	C→S	允许用户进入
`reject_user`	C→S	拒绝用户进入
`user_pending`	S→C	用户在等候室（广播）

房间锁定信令

Action	方向	说明
`lock_room`	C→S	锁定房间（禁止新用户加入）
`unlock_room`	C→S	解锁房间

议程管理

议程结构

{
  "meeting_id": "meeting_001",
  "agenda": [
    {
      "id": "agenda_1",
      "title": "开场致辞",
      "speaker": "主持人",
      "duration": 5,          // 分钟
      "order": 1
    },
    {
      "id": "agenda_2",
      "title": "业务进展汇报",
      "speaker": "部门负责人",
      "duration": 20,
      "order": 2
    },
    {
      "id": "agenda_3",
      "title": "Q&A 环节",
      "speaker": "全体参与者",
      "duration": 10,
      "order": 3
    }
  ],
  "current_agenda_id": "agenda_2"
}

更新议程

{
  "action": "update_agenda",
  "agenda": [
    {
      "title": "开场致辞",
      "speaker": "主持人",
      "duration": 5
    }
  ]
}

参与者管理

静音参与者

{
  "action": "mute_participant",
  "target_user_id": "user_005",
  "mute_audio": true,      // 静音麦克风
  "mute_video": false      // 不关闭摄像头
}

主持人权限控制

主持人具有以下权限：

开始/结束/暂停会议
静音/取消静音参与者
踢出参与者（强制退出）
控制等候室（允许/拒绝进入）
锁定/解锁房间
启动/停止录制
启动/停止转写

举手系统

参与者可以举手表示想发言，主持人可以看到举手队列：

{
  "action": "raise_hand"
}

实时转写

转写原理

┌────────────────┐
│ 参与者麦克风   │
└────────┬───────┘
         │ RTC Audio
         ↓
    ┌─────────────┐         ┌──────────────┐
    │ AudioBuffer │────────→│ ASR Service  │
    └─────────────┘         │ (外部服务)   │
                            └──────┬───────┘
                                   │ 识别结果
                                   ↓
                            ┌─────────────────┐
                            │ TranscriptionDB │
                            └─────────────────┘
                                   │
                                   ↓
                        ┌────────────────────┐
                        │ WebSocket 实时推送 │
                        │ 至所有参与者       │
                        └────────────────────┘

启动转写

{
  "action": "start_transcription",
  "language": "zh-CN"         // 语言代码
}

转写结果格式

{
  "action": "transcription_result",
  "speaker_id": "user_003",
  "speaker_name": "张三",
  "text": "我们上半年的销售额增长了 25%",
  "is_final": true,           // true: 句子完成, false: 临时结果
  "timestamp": "2024-01-15T10:35:00Z"
}

AI 智能服务

会议纪要

会议结束后，AI 自动生成纪要：

{
  "meeting_id": "meeting_001",
  "title": "2024 Q1 季度总结会",
  "date": "2024-01-15",
  "duration": "2小时 15分钟",
  "participants": ["主持人", "张三", "李四"],
  "summary": "本次会议总结了 Q1 业绩，制定了 Q2 目标...",
  "key_points": [
    "销售额同比增长 25%",
    "市场份额提升 5 个百分点",
    "新产品线已上线 3 个"
  ],
  "action_items": [
    {
      "item": "完成市场调研报告",
      "owner": "市场部",
      "deadline": "2024-01-31"
    },
    {
      "item": "优化售后服务流程",
      "owner": "运营部",
      "deadline": "2024-02-15"
    }
  ]
}

任务提取

从转写内容中自动提取任务项：

转写: "李四，能否在下周五前完成客户需求分析？"

提取的任务:
{
  "item": "完成客户需求分析",
  "owner": "李四",
  "deadline": "2024-01-19",  // 下周五
  "priority": "high"
}

等候室（Lobby）

启用等候室

{
  "action": "toggle_lobby",
  "enable": true
}

等候室流程

用户尝试加入 → 进入等候室 → 主持人审核 → 允许/拒绝进入

允许用户进入

{
  "action": "admit_user",
  "target_user_id": "user_008"
}

拒绝用户进入

{
  "action": "reject_user",
  "target_user_id": "user_008"
}

屏幕共享

开启屏幕共享

{
  "action": "share_screen"
}

参与者通过浏览器 API 选择要共享的屏幕或窗口。系统自动将共享内容作为独立的媒体轨道处理。

录制功能

会中 开始 / 停止录制 由 WebSocket 房间信令 与 RoomApi 驱动（见上文信令与架构），不提供 POST /meeting/.../recording/start 这类与全局规则不一致的独立 HTTP 路径。

与其它插件相同，Meeting 的 HTTP REST 统一为 /meeting/api/...（引擎挂载前缀 meeting/api）。若只需通过 HTTP 查看录制条目列表：

curl http://localhost:8180/meeting/api/recordings

（持久化录制目录完全接入前，列表可能为空；单条 play / download / DELETE 见 HTTP API — Meeting REST，与仓库 docs/http-api.md §14.2 同步。）

HTTP API

基路径： http(s)://<host>:<port>/meeting/api。请勿使用已废弃的 /room/meeting/...，也勿省略 api 段写成 /meeting/rooms（会与插件顶层路径混淆）。

快速示例（完整字段与错误码以“HTTP API 详细参数与返回”为准）：

curl -X POST http://localhost:8180/meeting/api/rooms \
  -H "Content-Type: application/json" \
  -d '{"room_id":"room-demo-1"}'

逐接口详细说明

默认基地址：http://localhost:8180，前缀：/meeting/api

创建会议室

POST /meeting/api/rooms
Content-Type: application/json

请求体：

{
  "room_id": "room-demo-1"
}

响应（示例）：

{
  "code": 0,
  "message": "success",
  "data": {
    "room_id": "room-demo-1",
    "created": true
  }
}

字段	类型	必填	说明
`room_id`	string	是	会议室唯一 ID

会议室列表

GET /meeting/api/rooms

响应字段：

字段	类型	说明
`rooms`	array	会议室列表
`count`	int	总数

会议室详情

GET /meeting/api/rooms/{room_id}

参数	类型	必填	说明
`room_id`	string	是	会议室 ID

创建预订

POST /meeting/api/reservations
Content-Type: application/json

字段	类型	必填	说明
`room_id`	string	是	会议室 ID
`room_name`	string	是	展示名称
`host_user_id`	string	是	主持人 ID
`start_time`	string(RFC3339)	是	开始时间
`duration_minutes`	int	是	会议时长（分钟）
`participants`	string[]	否	初始参会者

会控操作（禁言示例）

POST /meeting/api/control/mute
Content-Type: application/json

{
  "room_id": "room-demo-1",
  "user_id": "u100"
}

模板创建

POST /meeting/api/templates
Content-Type: application/json

关键字段：name、max_participants、auto_record、auto_lock、enabled。

统计与能力

GET /meeting/api/stats
GET /meeting/api/features

错误响应

HTTP 状态码	场景
`400`	参数校验失败
`404`	会议室/模板不存在
`409`	会议室冲突或重复创建

数据库持久化

会议表 `meeting_sessions`

字段	类型	说明
`id`	string	会议 ID
`title`	string	会议标题
`organizer_id`	string	组织者 ID
`status`	enum	会议状态
`start_time`	timestamp	开始时间
`end_time`	timestamp	结束时间
`participant_count`	int	参与者数
`recording_file`	string	录制文件路径

议程表 `meeting_agenda`

字段	类型	说明
`id`	string	议程 ID
`meeting_id`	string	会议 ID
`title`	string	议程标题
`speaker`	string	发言人
`duration`	int	时长（秒）
`order`	int	排序

转写表 `meeting_transcription`

字段	类型	说明
`id`	string	转写 ID
`meeting_id`	string	会议 ID
`speaker_id`	string	发言人 ID
`text`	text	转写内容
`timestamp`	timestamp	时间戳
`language`	string	语言

配置参考

meeting:
  # 基本配置
  max_participants: 50          # 最大参与者数
  session_timeout: 7200         # 会议超时（秒）

  # 等候室
  enable_lobby: true            # 启用等候室
  lobby_timeout: 300            # 等候室超时（秒）

  # 录制
  enable_recording: true        # 启用录制
  recording_format: "mp4"       # 录制格式
  recording_dir: "./recordings"

  # 转写
  enable_transcription: false   # 启用转写（需配置 ASR 服务）
  asr_service_url: ""           # ASR 服务 URL
  transcription_language: "zh-CN"

  # AI 服务
  enable_ai_summary: false      # 启用 AI 总结
  ai_service_url: ""            # AI 服务 URL

  # 计时器
  timer:
    max_duration: 7200          # 会议最大时长（秒）
    warning_before_end: 300     # 结束前提醒（秒）
    enable_agenda_timer: true   # 议程计时

Web-SDK 集成

基础连接

const room = document.getElementById('room') as MbRoom;
const publisher = document.getElementById('publisher') as MbPublisher;

// 连接会议室
room.setAttribute('ws-url', 'ws://localhost:8180/room?type=meeting');
room.setAttribute('room-id', 'meeting_001');

// 开启音视频
await publisher.startCapture({ audio: true, video: true });
await publisher.startPublish();

主持人控制

const room = document.getElementById('room') as MbRoom;

// 启动会议
room.sendMessage({
  action: 'start_meeting'
});

// 静音参与者
room.sendMessage({
  action: 'mute_participant',
  target_user_id: 'user_005',
  mute_audio: true
});

// 开启等候室
room.sendMessage({
  action: 'toggle_lobby',
  enable: true
});

实时转写

// 启动转写
room.sendMessage({
  action: 'start_transcription',
  language: 'zh-CN'
});

// 监听转写结果
room.addEventListener('transcription_result', (event) => {
  console.log(`${event.speaker_name}: ${event.text}`);
  // 实时显示在转写面板
});

屏幕共享

const publisher = document.getElementById('publisher') as MbPublisher;

// 启动屏幕共享
await publisher.startScreenShare();

// 停止屏幕共享
await publisher.stopScreenShare();

Demo 项目

完整的会议室 Demo 位于 web-sdk/packages/demo/meeting/：

meeting/
├── src/
│   ├── pages/
│   │   ├── Lobby/index.tsx         # 会议列表
│   │   ├── MeetingRoom/index.tsx   # 会议间
│   │   └── Waiting/index.tsx       # 等候室
│   ├── components/
│   │   ├── VideoGrid/index.tsx     # 视频网格
│   │   ├── Transcription/index.tsx # 实时转写面板
│   │   ├── Agenda/index.tsx        # 议程面板
│   │   ├── Participants/index.tsx  # 参与者列表
│   │   └── Controls/index.tsx      # 控制栏
│   ├── services/api.ts             # API 封装
│   └── types/index.ts              # 类型定义
├── package.json                    # port: 5475
└── vite.config.ts

启动 Demo

cd web-sdk/packages/demo/meeting
pnpm install
pnpm dev
# 访问 http://localhost:5475

入会链接

http://localhost:5475?meeting_id=meeting_001&user_id=user_123&role=participant

部署与成本对比

私有化部署步骤

启用 meeting + webrtc + room Feature，参考安装部署
Docker 启动 Monibuca（开放 8180、UDP 端口段用于 WebRTC ICE）
配置 TURN/STUN（公网会议必备），见 WebRTC 插件配置
使用 Web SDK 会议 Demo 或自有前端调用 Room/Meeting API

与云服务对比（量级参考）

维度	Monibuca 自建	声网 / 即构等 SaaS
许可费用	开源版 + 可选商业授权	按分钟/并发计费
数据合规	数据不出机房	依赖云厂商区域
协议扩展	RTMP/HLS/GB28181 同源站	以实时互动 SDK 为主
运维	需自建运维与监控（内置 Admin）	托管运维

详细迁移路径见从声网/即构迁移；引擎选型见流媒体服务器选型。

移动端适配

Demo 自动检测设备类型，移动端采用：

自适应视频网格（最多 4 个视频）
底部固定控制栏
上拉唤出参与者列表
下拉唤出议程面板
转写结果滚动显示

联系我们

微信公众号：不卡科技微信公众号二维码

腾讯频道：流媒体技术腾讯频道二维码

QQ 频道：p0qq0crz08 QQ 频道二维码

QQ 群：751639168 QQ 群二维码

自建视频会议 - Monibuca Meeting 插件

核心特性

启用方式

架构设计

会议生命周期

信令协议

会议基础信令

参与者控制信令

议程信令

转写与录制信令

等候室信令

房间锁定信令

议程管理

议程结构

更新议程

参与者管理

静音参与者

主持人权限控制

举手系统

实时转写

转写原理

启动转写

转写结果格式

AI 智能服务

会议纪要

任务提取

等候室（Lobby）

启用等候室

等候室流程

允许用户进入

拒绝用户进入

屏幕共享

开启屏幕共享

录制功能

HTTP API

逐接口详细说明

创建会议室

会议室列表

会议室详情

创建预订

会控操作（禁言示例）

模板创建

统计与能力

错误响应

数据库持久化

会议表 meeting_sessions

议程表 meeting_agenda

转写表 meeting_transcription

配置参考

Web-SDK 集成

基础连接

主持人控制

实时转写

屏幕共享

Demo 项目

启动 Demo

入会链接

部署与成本对比

私有化部署步骤

与云服务对比（量级参考）

移动端适配

联系我们

会议表 `meeting_sessions`

议程表 `meeting_agenda`

转写表 `meeting_transcription`