README.md

Tubumu.Abp.Meeting

基于 Mediasoup 的 Abp vNext 视频会议模块。

一、安装

1、创建项目

# 当前目录：任意
mkdir Sample && cd Sample
abp new Sample

2、安装 Tubumu.Abp.Meeting 模块

使用 Abp CLI 安装:

# 当前目录：Sample
cd src/Sample.Web
# 当前目录：Sample/src/Sample.Web
abp add-package Tubumu.Abp.Meeting

或者手工安装，在 Nuget 搜索 Tubumu.Abp.Meeting 并安装，然后修改 SampleWebAbpModule:

// File: Sample/src/Sample.Web/SampleWebModule.cs
// ...
    typeof(AbpSwashbuckleModule),
    // 配置点：1
    typeof(TubumuAbpMeetingModule)
    )]
public class SampleWebModule : AbpModule
// ...

3、下载配置文件及修改 IP

将 mediasoupsettings.json 配置文件下载到 Sample.Web 项目中。

# 当前目录：Sample/src/Sample.Web
curl -o mediasoupsettings.json https://raw.githubusercontent.com/albyho/Tubumu.Abp.Meeting/main/samples/Sample/src/Sample.Web/mediasoupsettings.json

打开 mediasoupsettings.json 配置文件，搜索 AnnouncedIp 键将值修改为本机在局域网中的 IP 或者公网 IP。

// File: Sample/src/Sample.Web/mediasoupsettings.json
// ...
    "WebRtcTransportSettings": {
      "ListenIps": [
        {
          "Ip": "0.0.0.0",
          "AnnouncedIp": null // 修改为本机在局域网中的 IP 或者公网 IP 。保持为空将使用任意一个 IPv4 地址。
        }
      ],
      "InitialAvailableOutgoingBitrate": 1000000,
      "MinimumAvailableOutgoingBitrate": 600000,
      "MaxSctpMessageSize": 262144,
      // Additional options that are not part of WebRtcTransportOptions.
      "MaximumIncomingBitrate": 1500000
    },
    // 用于 FFmpeg 推流等
    "PlainTransportSettings": {
      "ListenIp": {
        "Ip": "0.0.0.0",
        "AnnouncedIp": null // 修改为本机在局域网中的 IP 或者公网 IP 。保持为空将使用任意一个 IPv4 地址。该项目不使用。
      },
      "MaxSctpMessageSize": 262144
    }
// ...

4、Web 前端

可将 Sample 的前端项目的源码 tubumu-abp-meeting-sample-client 下载、编译并复制到 Sample.Web 项目的 wwwroot 目录下。比如：Sample/src/Sample.Web/wwwroot/meeting 目录。

# 当前目录：tubumu-abp-meeting-sample-client
yarn build
cp -R ./dist/* ../Sample/src/Sample.Web/meeting

注意：如有必要，请修改 index.html 文件中的 css 和 js 的路径。

5、新增菜单

菜单链接至 Web 前端的首页。

// File: Sample/src/Sample.Web/Menus/SampleMenus.cs
public class SampleMenus
{
    private const string Prefix = "Sample";
    public const string Home = Prefix + ".Home";

    //Add your menu items here...

    // 配置点：2
    // `Meeting` menu item
    public const string Meeting = Prefix + ".Meeting";
}

// File: Sample/src/Sample.Web/Menus/SampleMenuContributor.cs
private async Task ConfigureMainMenuAsync(MenuConfigurationContext context)
{
    var administration = context.Menu.GetAdministration();
    var l = context.GetLocalizer<SampleResource>();

    context.Menu.Items.Insert(
        0,
        new ApplicationMenuItem(
            SampleMenus.Home,
            l["Menu:Home"],
            "~/",
            icon: "fas fa-home",
            order: 0
        )
    );
    // 配置点：3
    context.Menu.Items.Insert(
        1,
        new ApplicationMenuItem(
            SampleMenus.Meeting,
            l["Menu:Meeting"],
            "~/meeting/index.html",
            icon: "fas fa-users",
            order: 1
        )
    );
    // ... others.
}

二、启动

1. 将 Sample.Web 设为启动项进行启动。

2. 打开浏览器并登录；还可以打开不同的浏览器(Sample使用Cookie认证)使用不同账号登录；如果是局域网或公网还可以通过其他电脑或手机登录。

3. 访问会议页面。操作流程请参考截图。

三、截图

Screenshots

四、交流

微信群