mediasoup-demo 运行实战

2024-04-20 20:48
文章标签 实战 运行 demo mediasoup

本文主要是介绍mediasoup-demo 运行实战，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

mediasoup 是一个强大的 WebRTC SFU 服务。mediasoup-demo 则是 mediasoup 的一个很不错的入门演示程序。这里记录把 mediasoup-demo 跑起来的过程。操作系统平台以 Ubuntu 20.04 为例。mediasoup 主要以 JavaScript 开发，运行环境为 Node.js，它一般作为 Node.js 模块运行于 Node.js 应用中。

准备环境

mediasoup v3 的 安装指南 中有安装要求：

  • node version >= v12.0.0
  • python version >= 3.6 with PIP
  • GNU make

对于 Linux，OSX 和任何 *NIX 系统，还有额外的要求：

  • gcc 和 g++ >= 4.9 或 clang (包含 C++11 支持)
  • cc 和 c++ 命令 (符号连接) 指向对应的 gcc/g++ 或 clang/clang++ 可执行文件。

当系统软件库中的 node 版本不符合要求时，需要自己安装适当版本的 Node。Node 版本不合适，很有可能 demo 就运行不起来。笔者试了多个版本都没能把 mediasoup 跑起来，包括 v13.1.0、v13.10.0 和最新的长期支持版 v16.13.1，不过在 sequelize 的 GitHub issue 12419 ，看到有人提到用 v12.18.3 解决了笔者遇到的一些问题，笔者也选择了 v12.18.3 版。

下载 node 的预编译压缩包：

https://nodejs.org/dist/

如果系统中已经安装了其它版本的 node，在安装之前，还需要先移除之前安装的版本：

sudo rm -rf /usr/local/bin/npm /usr/local/share/man/man1/node* ~/.npm
sudo rm -rf /usr/local/lib/node*
sudo rm -rf /usr/local/bin/node*
sudo rm -rf /usr/local/include/node*sudo apt-get purge nodejs npm
sudo apt autoremove

解压并安装 node：

tar -xf node-v12.18.3-linux-x64.tar.xz
sudo mv node-v12.18.3-linux-x64/bin/* /usr/local/bin/
sudo mv node-v12.18.3-linux-x64/lib/node_modules/ /usr/local/lib/

安装 mediasoup-demo

下载 mediasoup-demo，克隆 mediasoup-demo 工程

$ git clone https://github.com/versatica/mediasoup-demo.git
$ cd mediasoup-demo
$ git checkout v3

设置 mediasoup-demo server：

mediasoup-demo$ cd server
server$ npm install

拷贝 config.example.js 到 config.js，并对它做一些定制化的修改：

$ cp config.example.js config.js

这一步是必须的，否则 mediasoup-demo 运行将出错。所需要做的配置包括域名，监听的 IP 地址，HTTPS 证书和私钥的路径

域名、监听 HTTPS 的 IP/端口、证书路径及私钥路径：

	domain : process.env.DOMAIN || 'localhost',// Signaling settings (protoo WebSocket server and HTTP API server).https  :{listenIp   : '0.0.0.0',// NOTE: Don't change listenPort (client app assumes 4443).listenPort : process.env.PROTOO_LISTEN_PORT || 4443,// NOTE: Set your own valid certificate files.tls        :{cert : process.env.HTTPS_CERT_FULLCHAIN || `${__dirname}/certs/fullchain.pem`,key  : process.env.HTTPS_CERT_PRIVKEY || `${__dirname}/certs/privkey.pem`}},

这些配置可以通过修改 config.js 实现，也可以通过设置环境变量实现。这里不修改这些配置，将 TLS 证书和私钥放进 mediasoup-demo/server/certs/ 并按照这里的配置重命名。如果已经有网站域名，网站已经开了 HTTPS，且打算将 mediasoup-demo 跑在网站同一台机器上，可以将证书和私钥拷贝过来，或者用环境变量 HTTPS_CERT_FULLCHAIN 和 HTTPS_CERT_PRIVKEY 分别指向证书和私钥的路径：

export HTTPS_CERT_FULLCHAIN="XXX"
export HTTPS_CERT_PRIVKEY="YYY"

否则，可以用工具 https://github.com/aggresss/playground-cpp/blob/master/certs/autogen.sh 生成临时的自签名证书，运行这个脚本生成如下文件：

playground-cpp/certs$ git status
位于分支 master
您的分支与上游分支 'origin/master' 一致。尚未暂存以备提交的变更：（使用 "git add <文件>..." 更新要提交的内容）（使用 "git restore <文件>..." 丢弃工作区的改动）修改：     ca.crt修改：     ca.csr修改：     ca.key修改：     ca.srl修改：     client.crt修改：     client.csr修改：     client.key修改：     md5.txt修改：     server.crt修改：     server.csr修改：     server.key

server.key 是私钥，server.crt 是证书。将这两个文件拷贝到 mediasoup-demo 下：

playground-cpp/certs$ mkdir -p ~/mediasoup-demo/server/certs/ 
playground-cpp/certs$ mv server.key ~/mediasoup-demo/server/certs/privkey.pem 
playground-cpp/certs$ mv server.crt ~/mediasoup-demo/server/certs/fullchain.pem

没有私钥和证书，运行服务器应用时会报错找不到证书：

  mediasoup-demo-server:INFO running an HTTPS server... +6ms
(node:396580) UnhandledPromiseRejectionWarning: Error: ENOENT: no such file or directory, open '~/mediasoup-demo/server/certs/fullchain.pem'at Object.openSync (fs.js:462:3)at Object.readFileSync (fs.js:364:35)at runHttpsServer (~/mediasoup-demo/server/server.js:431:13)at run (~/mediasoup-demo/server/server.js:74:8)at processTicksAndRejections (internal/process/task_queues.js:97:5)
(node:396580) UnhandledPromiseRejectionWarning: Unhandled promise rejection. This error originated either by throwing inside of an async function without a catch block, or by rejecting a promise which was not handled with .catch(). To terminate the node process on unhandled promise rejection, use the CLI flag `--unhandled-rejections=strict` (see https://nodejs.org/api/cli.html#cli_unhandled_rejections_mode). (rejection id: 2)
(node:396580) [DEP0018] DeprecationWarning: Unhandled promise rejections are deprecated. In the future, promise rejections that are not handled will terminate the Node.js process with a non-zero exit code.

运行浏览器应用时会报错找不到私钥：

[16:02:19] Finished '<anonymous>' after 27 ms
[16:02:19] Finished 'live' after 14 s
internal/fs/utils.js:269throw err;^Error: ENOENT: no such file or directory, open '~/mediasoup-demo/server/certs/privkey.pem'at Object.openSync (fs.js:462:3)at Object.readFileSync (fs.js:364:35)at getKey (~/mediasoup-demo/app/node_modules/browser-sync/dist/server/utils.js:38:15)at getHttpsServerDefaults (~/mediasoup-demo/app/node_modules/browser-sync/dist/server/utils.js:45:14)at Object.getHttpsOptions (~/mediasoup-demo/app/node_modules/browser-sync/dist/server/utils.js:67:41)at ~/mediasoup-demo/app/node_modules/browser-sync/dist/server/utils.js:81:44at Object.getServer (~/mediasoup-demo/app/node_modules/browser-sync/dist/server/utils.js:85:15)at createServer (~/mediasoup-demo/app/node_modules/browser-sync/dist/server/static-server.js:71:24)at createServer (~/mediasoup-demo/app/node_modules/browser-sync/dist/server/index.js:72:42)at module.exports.plugin (~/mediasoup-demo/app/node_modules/browser-sync/dist/server/index.js:12:20) {errno: -2,syscall: 'open',code: 'ENOENT',path: '~/mediasoup-demo/server/certs/privkey.pem'
}
npm ERR! code ELIFECYCLE
npm ERR! errno 1
npm ERR! mediasoup-demo-app@3.0.0 start: `gulp live`
npm ERR! Exit status 1
npm ERR! 
npm ERR! Failed at the mediasoup-demo-app@3.0.0 start script.
npm ERR! This is probably not a problem with npm. There is likely additional logging output above.npm ERR! A complete log of this run can be found in:
npm ERR!     ~/.npm/_logs/2021-12-24T08_02_19_135Z-debug.log

还有一个必须要配置的是 RTC 传输选项中的监听 IP MEDIASOUP_LISTEN_IP：

		webRtcTransportOptions :{listenIps :[{ip          : process.env.MEDIASOUP_LISTEN_IP || '1.2.3.4',announcedIp : process.env.MEDIASOUP_ANNOUNCED_IP}],initialAvailableOutgoingBitrate : 1000000,minimumAvailableOutgoingBitrate : 600000,maxSctpMessageSize              : 262144,// Additional options that are not part of WebRtcTransportOptions.maxIncomingBitrate              : 1500000},

这个选项同样既可以通过修改 config.js 配置，也可以通过设置环境变量配置。监听的 IP 地址需要设置为机器本地 IP 地址。否则，浏览器应用运行和服务器通信时，服务器将报错：

  mediasoup:Router createWebRtcTransport() +3smediasoup:Channel request() [method:router.createWebRtcTransport, id:5] +3smediasoup:ERROR:Channel [pid:396733 RTC::PortManager::Bind() | throwing MediaSoupError: port bind failed due to address not available [transport:udp, ip:'1.2.3.4', port:42251, attempt:1/10000] +0msmediasoup:ERROR:Channel [pid:396733 Worker::OnChannelRequest() | throwing MediaSoupError: port bind failed due to address not available [transport:udp, ip:'1.2.3.4', port:42251, attempt:1/10000] [method:router.createWebRtcTransport] +4msmediasoup:WARN:Channel request failed [method:router.createWebRtcTransport, id:5]:  [method:router.createWebRtcTransport] +0msmediasoup-demo-server:ERROR:Room request failed:Error:  [method:router.createWebRtcTransport] at Channel.processMessage (/home/hanpfei/data/opensource/mediasoup-demo/server/node_modules/mediasoup/node/lib/Channel.js:195:37) at Socket.<anonymous> (/home/hanpfei/data/opensource/mediasoup-demo/server/node_modules/mediasoup/node/lib/Channel.js:69:34)     at Socket.emit (events.js:315:20)     at Socket.EventEmitter.emit (domain.js:483:12)     at addChunk (_stream_readable.js:295:12)     at readableAddChunk (_stream_readable.js:271:9)     at Socket.Readable.push (_stream_readable.js:212:10)     at Pipe.onStreamRead (internal/stream_base_commons.js:186:23) +0msmediasoup-demo-server:Room protoo Peer "close" event [peerId:ucayshrc] +27msmediasoup-demo-server:INFO:Room last Peer in the room left, closing the room [roomId:rvpgogc7] +3smediasoup-demo-server:Room close() +2msmediasoup:Router close() +28msmediasoup:Channel request() [method:router.close, id:6] +27msmediasoup:Transport routerClosed() +3smediasoup:DataProducer transportClosed() +3smediasoup:RtpObserver routerClosed() +3smediasoup:Channel request succeeded [method:router.close, id:6] +4ms

报错提示，由于 IP 地址不可用，绑定端口失败。

设置 mediasoup-demo 浏览器应用：

$ cd app
$ npm install

本地运行 mediasoup-demo

在终端中运行 Node.js 服务器应用：

mediasoup-demo$ cd server
mediasoup-demo/server$ npm start

在一个不同的终端中编译并运行浏览器应用程序：

mediasoup-demo$ cd app
mediasoup-demo/app$ npm start

然后就可以通过浏览器访问 mediasoup 了，如：

https://192.168.217.129:3000/?info=true&roomId=rvpgogc7

1640340445057.jpg

mediasoup-demo 这个运行起来之后，网络拓扑是这样的：

无标题演示文稿.png

mediasoup-demo/server 是 WebRTC 的 SFU 服务器，mediasoup-demo/app 是客户端浏览器应用服务器，用于提供网页和 JS 文件等资源。

参考资料

Npm can’t find module “semver” error in Ubuntu 19.04
mediasoup-demo 实践
https://github.com/versatica/mediasoup-demo/blob/v3/README.md
https://mediasoup.discourse.group/t/mediasouperror-port-bind-failed-due-to-address-not-available-udp-1-2-3-4-attempt-1/32/6
https://github.com/mkhahani/mediasoup-sample-app/issues/1

这篇关于mediasoup-demo 运行实战的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/921282。

相关文章

MySQL 多列 IN 查询之语法、性能与实战技巧(最新整理)

MySQL 多列 IN 查询之语法、性能与实战技巧(最新整理)

《MySQL多列IN查询之语法、性能与实战技巧(最新整理)》本文详解MySQL多列IN查询,对比传统OR写法,强调其简洁高效,适合批量匹配复合键,通过联合索引、分批次优化提升性能,兼容多种数据库... 目录一、基础语法：多列 IN 的两种写法1. 直接值列表2. 子查询二、对比传统 OR 的写法三、性能分析
阅读更多...
Python办公自动化实战之打造智能邮件发送工具

Python办公自动化实战之打造智能邮件发送工具

《Python办公自动化实战之打造智能邮件发送工具》在数字化办公场景中,邮件自动化是提升工作效率的关键技能,本文将演示如何使用Python的smtplib和email库构建一个支持图文混排,多附件,多... 目录前言一、基础配置：搭建邮件发送框架1.1 邮箱服务准备1.2 核心库导入1.3 基础发送函数二、
阅读更多...
PowerShell中15个提升运维效率关键命令实战指南

PowerShell中15个提升运维效率关键命令实战指南

《PowerShell中15个提升运维效率关键命令实战指南》作为网络安全专业人员的必备技能,PowerShell在系统管理、日志分析、威胁检测和自动化响应方面展现出强大能力,下面我们就来看看15个提升... 目录一、PowerShell在网络安全中的战略价值二、网络安全关键场景命令实战1. 系统安全基线核查
阅读更多...
从原理到实战深入理解Java 断言assert

从原理到实战深入理解Java 断言assert

《从原理到实战深入理解Java断言assert》本文深入解析Java断言机制,涵盖语法、工作原理、启用方式及与异常的区别,推荐用于开发阶段的条件检查与状态验证,并强调生产环境应使用参数验证工具类替代... 目录深入理解 Java 断言（assert）：从原理到实战引言：为什么需要断言？一、断言基础1.1 语
阅读更多...
Java MQTT实战应用

Java MQTT实战应用

《JavaMQTT实战应用》本文详解MQTT协议,涵盖其发布/订阅机制、低功耗高效特性、三种服务质量等级（QoS0/1/2）,以及客户端、代理、主题的核心概念,最后提供Linux部署教程、Sprin... 目录一、MQTT协议二、MQTT优点三、三种服务质量等级四、客户端、代理、主题1. 客户端（Clien
阅读更多...
在Spring Boot中集成RabbitMQ的实战记录

在Spring Boot中集成RabbitMQ的实战记录

《在SpringBoot中集成RabbitMQ的实战记录》本文介绍SpringBoot集成RabbitMQ的步骤,涵盖配置连接、消息发送与接收,并对比两种定义Exchange与队列的方式:手动声明(... 目录前言准备工作1. 安装 RabbitMQ2. 消息发送者（Producer）配置1. 创建 Spr
阅读更多...
深度解析Spring Boot拦截器Interceptor与过滤器Filter的区别与实战指南

深度解析Spring Boot拦截器Interceptor与过滤器Filter的区别与实战指南

《深度解析SpringBoot拦截器Interceptor与过滤器Filter的区别与实战指南》本文深度解析SpringBoot中拦截器与过滤器的区别,涵盖执行顺序、依赖关系、异常处理等核心差异,并... 目录Spring Boot拦截器（Interceptor）与过滤器（Filter）深度解析：区别、实现
阅读更多...
深度解析Spring AOP @Aspect 原理、实战与最佳实践教程

深度解析Spring AOP @Aspect 原理、实战与最佳实践教程

《深度解析SpringAOP@Aspect原理、实战与最佳实践教程》文章系统讲解了SpringAOP核心概念、实现方式及原理,涵盖横切关注点分离、代理机制（JDK/CGLIB）、切入点类型、性能... 目录1. @ASPect 核心概念1.1 AOP 编程范式1.2 @Aspect 关键特性2. 完整代码实
阅读更多...
MySQL中的索引结构和分类实战案例详解

MySQL中的索引结构和分类实战案例详解

《MySQL中的索引结构和分类实战案例详解》本文详解MySQL索引结构与分类,涵盖B树、B+树、哈希及全文索引,分析其原理与优劣势,并结合实战案例探讨创建、管理及优化技巧,助力提升查询性能,感兴趣的朋... 目录一、索引概述1.1 索引的定义与作用1.2 索引的基本原理二、索引结构详解2.1 B树索引2.2
阅读更多...
从入门到精通MySQL 数据库索引(实战案例)

从入门到精通MySQL 数据库索引(实战案例)

《从入门到精通MySQL数据库索引(实战案例)》索引是数据库的目录,提升查询速度,主要类型包括BTree、Hash、全文、空间索引,需根据场景选择,建议用于高频查询、关联字段、排序等,避免重复率高或... 目录一、索引是什么？能干嘛？核心作用：二、索引的 4 种主要类型（附通俗例子）1. BTree 索引（
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2