wistingcn / wilearning Goto Github PK

View Code? Open in Web Editor NEW

516.0 14.0 141.0 21.84 MB

Multiparty meeting&e-learning using mediasoup, webrtc ,angular and ionic with powerful whiteboard support

License: GNU Affero General Public License v3.0

TypeScript 78.37% Shell 0.48% JavaScript 1.03% HTML 10.85% CSS 3.08% SCSS 6.18%

mediasoup typescript socketio nodejs webrtc angular express ionic

wilearning's Introduction

English

演示系统

WiLearning

WiLearning 是一个开源、免费的在线课堂及视频会议系统，具备以下功能：

多人视频会议 - 进行多人实时音视频及聊天
共享桌面 - 支持共享桌面，支持在共享桌面和课件间进行切换
共享媒体 - 共享本地音频或视频，本地音视频可拖动，实时同步
课件&白板 - 上传本地课件，文件在客户端自动转码，并上传到服务器端，在多端自动同步
实时画笔 - 实时画笔、课件批注，并共享给其他参与人。画笔实时展示，延时小于200ms
课件预览 - 预览课件，并在预览页实时显示课件上的画笔和批注
课件/白板导出 - 将包含画笔、批注的课件/白板导出为pdf文档
私聊、全体禁言等主持人管理功能
课堂信息、网络信息等提示
同时支持多个房间 - 可支持任意多个房间，每个房间参与人数不限定，最终取决于硬件条件
中英文切换 - 根据浏览器设置自动选择语言，也可以手动切换
全终端支持 - 支持Windows/Mac/Android/IOS平台，支持Chrome/Firfox/Safari浏览器，自动适配终端环境
支持在微信中使用（Android）

WiLearning使用了WebRTC技术，服务器端使用Typescript + Nodejs + MediaSoup开发,App端使用Angular + Ionic.

安装注意事项

推荐在Ubuntu18.04下进行安装
要求Nodejs版本大于v12
理论上支持部署在Linux/Mac操作系统
服务器主机有公网IP + 域名 + SSL证书
客户端连接服务器地址定义在 app/src/app/config.ts ，编译代码前请先修改服务器地址，连接到默认地址将会出现“房间不存在”的错误！
服务器配置文件地址定义在 server/config/config.ts, 里面包含了端口设置等服务器相关的配置

常见问题

"房间不存在" --- 在app/src/app/config.ts修改服务器地址，重新编译app
"不显示视频" --- 网络配置错误，修改start.sh文件，将默认使用的eth0改成可用的网卡名

代码

git clone https://github.com/wistingcn/WiLearning

安装cnpm

node -v #版本需要大于v12
npm install -g cnpm

构建所有

./build.sh all

构建单个子系统

./build.sh [server/app/admin]
# 编译后的代码位于dist目录

运行

代码里提供了示例SSL证书,该证书对应的域名是rtc.liweix.com,实际运行时,请提供自己的证书,证书要与访问域名一致.

进入dist目录

cd dist

方法一：运行server.js

node server.js --cert ../certs/rtc.liweix.com.pem --key ../certs/rtc.liweix.com.key

# 如果获取公网IP地址失败,则可以使用--publicIp 手动提供公网IP地址
node server.js --cert ../certs/rtc.liweix.com.pem --key ../certs/rtc.liweix.com.key --publicIp x.x.x.x

# 默认使用网卡名称 eth0 ，如果你的网卡名不同，须用 --eth 指定
node server.js --cert ../certs/rtc.liweix.com.pem --key ../certs/rtc.liweix.com.key --eth <ifname>

方法二：直接运行start.sh(使用默认证书)

./start.sh

后台运行

使用pm2后台运行：

npx pm2 start start.sh

浏览器访问

WiLearning 支持Chrome、FireFox、Safari浏览器，推荐使用最新版本的Chrome浏览器。

在浏览器中打开admin地址

https://[你的公网IP地址]/admin/

在Admin界面创建房间,打开或复制房间地址,主持人可以开始/结束会议
多人登录到同一个房间即可开始视频会议

错误排查

Demo部署环境：Ubuntu 18.04.4 LTS, 在该环境测试通过
默认从eth0获取本地IP地址，如果系统没有eth0，将导致后续推流失败。可以通过--eth修改默认值
WebRTC出于安全性考虑，要求必须使用HTTPS，直接使用IP地址进行访问会报错
推荐使用自己的域名和证书，在aliyun可以申请免费证书
当访问出现问题时，在浏览器打开开发者工具，在控制台(Console)里查看出错原因
未能解决的问题，请提交issue，并附上问题截图

WiLearning 交流及技术支持

加QQ群：1043056267

进一步了解

本项目使用到的webrtc技术在作者的书中进行了详细说明：

《WebRTC技术详解：从0到1构建多人视频会议系统》，该书由机械工业出版社出版，各大网站均有出售

wilearning's People

Contributors

Stargazers

Watchers

Forkers

hoxtonk james133 jamping cishengbili zhengxiaochuan-3 wangwenjunfromlanzhou jls502 erasurecode guardianshell opengi yetaye buglayer qu-way ai2047 f2wong coolume beyondz jingxio twenis eteon caramelmario jzlinuxer radojko pl42 echofish bluesky15171 stevenmoks sparkcus lihq yetclass anytune jutyy xiaolihome tech-media fy444818604 smallfishincup beta5 blond2005 wangscript007 flyseaskying wujs netost chundonglinlin lawtatfaitony coderthread lixushenggis adelinopds ak47f16200 timothykimemia qq88797833 alzee conandark ximenkkk kaisansoft bokire fsll-tech geejay101 longvox shokfake ifnn yuebenshan 1045917067 jimmy-bj fungungun zxc524580210 winlinvip aloproducao tomcosta flame109 gpsbird ustc-mjc xwxshine nyaxs smileallyears skyplaying jdpxiaoming edwadjei pyx20838 zhangsipeng lnmcc ksarpotdar kamyu104 mrsz doche wenshui2008 asdlei99 jabez13410 kklldog yusteve alan-yuan frankz61 gaotianpeng myjeffxie 18320867985 muqiao9527 zjxtansuo xufangbo jinfei426 chris-shenzhen-china cj-zgw

wilearning's Issues

使用华为npm镜像仓库

npm config set registry https://mirrors.huaweicloud.com/repository/npm/
npm cache clean -f

./build.sh all 报错

您好，在执行 ./build.sh all 操作时遇到以下错误，请求帮助，谢谢

#node -v
v16.13.1
#npm -v
8.1.2

`WARNING in ./node_modules/_@[email protected]@@angular/core/ivy_ngcc/fesm2015/core.js 42527:19-40
System.import() is deprecated and will be removed soon. Use import() instead.
For more info visit https://webpack.js.org/guides/code-splitting/
@ ./src/main.ts 15:0-47 20:4-18
@ multi ./src/main.ts

WARNING in ./node_modules/_@[email protected]@@angular/core/ivy_ngcc/fesm2015/core.js 42554:19-106
System.import() is deprecated and will be removed soon. Use import() instead.
For more info visit https://webpack.js.org/guides/code-splitting/
@ ./src/main.ts 15:0-47 20:4-18
@ multi ./src/main.ts

[email protected] build
ng build --prod --base-href /app/

ERROR in node_modules/@types/node/assert.d.ts:2:68 - error TS1144: '{' or ';' expected.

2 function assert(value: any, message?: string | Error): asserts value;
~~~~~
node_modules/@types/node/assert.d.ts:53:68 - error TS1144: '{' or ';' expected.

53 function ok(value: any, message?: string | Error): asserts value;
~~~~~
node_modules/@types/node/assert.d.ts:62:94 - error TS1144: '{' or ';' expected.

62 function strictEqual(actual: any, expected: T, message?: string | Error): asserts actual is T;
~~~~~~
node_modules/@types/node/assert.d.ts:62:101 - error TS1005: ';' expected.

62 function strictEqual(actual: any, expected: T, message?: string | Error): asserts actual is T;
~~
node_modules/@types/node/assert.d.ts:62:104 - error TS1005: ';' expected.

62 function strictEqual(actual: any, expected: T, message?: string | Error): asserts actual is T;
~
node_modules/@types/node/assert.d.ts:64:98 - error TS1144: '{' or ';' expected.

64 function deepStrictEqual(actual: any, expected: T, message?: string | Error): asserts actual is T;
~~~~~~
node_modules/@types/node/assert.d.ts:64:105 - error TS1005: ';' expected.

64 function deepStrictEqual(actual: any, expected: T, message?: string | Error): asserts actual is T;
~~
node_modules/@types/node/assert.d.ts:64:108 - error TS1005: ';' expected.

64 function deepStrictEqual(actual: any, expected: T, message?: string | Error): asserts actual is T;
~
node_modules/@types/node/assert.d.ts:72:47 - error TS1144: '{' or ';' expected.

72 function ifError(value: any): asserts value is null | undefined;
~~~~~
node_modules/@types/node/assert.d.ts:72:53 - error TS1005: ';' expected.

72 function ifError(value: any): asserts value is null | undefined;
~~
node_modules/@types/node/assert.d.ts:72:56 - error TS1005: ';' expected.

72 function ifError(value: any): asserts value is null | undefined;
~~~~
node_modules/@types/node/assert.d.ts:99:61 - error TS1005: ';' expected.

99 (value: any, message?: string | Error): asserts value;
`