写在前面

我之前研究在 web 中直接播放 rtsp 视频流时，写过一篇文章：【前端】rtsp 与 rtmp 视频流的播放方法。阅读这篇文章对你的学习有很大帮助。在文章中我有过详细的分析和解读，并给出了结论：

【要想在 web 中实时播放 rtsp 视频流：借助服务端拉流转码将是必要的操作。】

实现

我用 node.js 实现了拉流转码的功能，并将其打包成 rtsp2web 发布到了 npm 上。

rtsp2web 使用方便、快捷、高效，对前端开发人员来说，非常的友好。

介绍

rtsp2web 是一个依赖 ffmpeg，能实时将传入的 rtsp 视频流转码成图像数据并通过 ws 推送到前端的智能工具包。

前端页面借助 jsmpeg.js 就可以很轻松的实现播放啦~

而且 rtsp2web 还有以下特点：

高性能，配置丰富。
并发，支持同时播放多路视频。
合并同源，多个视频窗口同时播放同一个rtsp视频源时，只会创建一个转码进程，不会创建多个。
智能释放资源，智能检测当前没有在使用的转码进程，将其关闭，并释放电脑资源。
上手简单，提供的示例代码完整可运行，无需繁琐复杂的技术负担，直接运行代码，快速解决视频流播放的问题；
延时非常低，视频流稳定，几乎是实时的，满足任何需求；不花钱，采用开源框架，无商业风险；
别的收费平台，需要暴露 RTSP 视频流链接给收费平台，rtsp2web 无需您提供 RTSP 视频流，您的保密和安全牢牢掌握在您手中；
高效兼容，大多数 nvr 或 ipc 或摄像头平台都支持输出 RTSP 视频流，rtsp2web 把 RTSP 视频流转换到页面可播放，减少对接工作，无论您是什么摄像头；
支持前端使用 jsmpeg.js、flv.js 等播放器，满足不同技术栈团队使用；
删繁就简，无需插件就可在浏览器显示视频画面，兼容各大浏览器厂商；
省时省力，同一页面可以播放不同厂家的视频，无需任何额外操作，轻松支持多路视频同时播放；
可以在公网上部署使用，但也可能因为你们公司网络的设置原因，你会面临一点小问题：还要学习网络穿透打洞，服务器部署能力，流量消耗，wss 等。

如何使用

使用 rtsp2web 是简单的；你只需：

准备ffmpeg

首先，你得确保你的电脑上安装了 ffmpeg。我已经将我的 windows 64位电脑上使用的 ffmpeg 上传到了资源库中，如果你的电脑上没有，你可以点击下载并解压安装。（不会可以找我）

【最新】windows电脑FFmpeg安装教程手把手详解

安装成功以后，你重新打开一个命令行终端，输入：ffmpeg -h，如果能输出 ffmpeg 的相关信息出来，则证明你的电脑安装 ffmpeg 成功。

运行rtsp2web

创建一个空的目录（目录名不能是rtsp2web），进入目录后，依次运行下面的命令：

npm init --yes
npm i rtsp2web

创建 index.js，内容如下：

// index.js

const RTSP2web = require('rtsp2web')

// 服务端长连接占据的端口号；端口号可以自定义
let port = 9999

new RTSP2web({
  port
})

运行命令： node index.js 启动视频流转码服务，即可。

当然，你也可以选择你习惯的进程管理工具来启动它。如：pm2 之类的工具。

到此，你的视频转码服务就已经运行起来了。

o(￣▽￣)ブ

参数说明（在 `new RTSP2web` 时，可配置的参数如下）：

参数	解释说明
port	转码推流服务占用的端口号；（type：Number）可以不传；默认值：9999
path	FFmpeg 命令在你机器上的启动名称，(type: String) 一般情况下不传；默认值：'ffmpeg'
audio	默认不传，有声音；默认值：true；即：输出音频。如果想禁止输出音频，可以配置 audio: false
freeTime	任一视频流空闲(未被使用)时间超过这个值，就会停止该视频流的转码，释放机器资源（type: Number；单位：秒）一般情况下可不传；默认值：20
checkTime	检测视频空闲的时间间隔（type: Number；单位：秒）一般情况下可不传；默认值：10
q	视频质量；取值范围：0-1000；数字越小，视频越清晰，带宽消耗越大默认值：8；
transportType	设置 RTSP 传输协议，默认值：无可选值：['tcp', 'udp', 'udp_multicast', 'http', 'https'] ps: 这里默认值是无，也就是 rtsp2web 会自动选择一种传输协议；但是，并不能保证一定成功，这个时候，rtsp2web 日志会打印错误信息或者长时间的等待，这个时候就需要你手动来配置这个参数了，`'tcp'`、`'udp'` 是最常见的选择；详情可以参阅文档最后的【常见问题解决办法】
webplayer	设置前端播放器（视频流转码器），默认不传，默认值：'jsmpeg' 可选值：['jsmpeg', 'flv']；如果设置为 `flv`，那么前端页面请使用 `flv.js` 播放器，详情请参考下面 `flv.js` 小节了解详细的使用方法
wss	配置 wss；配置格式如下： `wss: {key: 'keyPath', cert: 'certPath'}` 如果你是 pfx 的证书，那么配置格式如下： `wss: {pfx: 'pfxPath', passphrase: 'passphrasePath'}` 如果你想使用`wss`的话请配置这个选项，否则不要使用这个配置。

前端代码

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta http-equiv="X-UA-Compatible" content="IE=edge">
  <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, minimum-scale=1, user-scalable=no,viewport-fit=cover">
  <script src="https://jsmpeg.com/jsmpeg.min.js" charset="utf-8"></script>
  <title>播放rtsp</title>
</head>
<body>
    <!-- canvas：视频播放容器 -->
    <canvas id="canvas-1" style="width: 600px;"></canvas>
</body>
<script>
  var rtsp = 'rtsp://wowzaec2demo.streamlock.net/vod/mp4:BigBuckBunny_115k.mp4'
  window.onload = () => {
    // 将rtsp视频流地址进行btoa处理一下
    new JSMpeg.Player("ws://localhost:9999/rtsp?url="+btoa(rtsp), {
       canvas: document.getElementById("canvas-1")
    })
  }
</script>
</html>

不管你的前端是用原生的 html 还是在 React、Vue 等框架中使用，操作起来都非常简单。

1、你需要先在全局的模板 html 文件头部引入 jsmpeg.js 或者 jsmpeg.min.js；

2、创建一个 canvas 容器，用来播放视频的；

3、创建视频源播放实例：

var rtsp = 'rtsp://wowzaec2demo.streamlock.net/vod/mp4:BigBuckBunny_115k.mp4'
// 将rtsp视频流地址进行btoa处理一下
new JSMpeg.Player("ws://localhost:9999/rtsp?url="+btoa(rtsp), {
  canvas: document.getElementById("canvas")
})

JSMpeg.Player 第一个参数是拼接转码链接 'ws://localhost:9999/rtsp?url=' + btoa(rtsp)；第二个参数是一个对象，对象属性包含 canvas。

参数说明

如上面的例子所示：在调用 new JSMpeg.Player() 时，第一个参数是接口地址拼接上rtsp地址，其实我们还可以使用 url 传参的方式传递更多的高阶参数。

参数	解释说明
-s	视频分辨率大小，不传即表示与源视频大小一致传值示例： 1920x1080、1280x720、640x360 降低分辨率会降低清晰度
-b:v	释义：码率，默认可以不设置，那就是使用源码率传值示例：2000k、100k、1k 码率调小，这样其实也间接让文件变小了码率调小，画质有可能会降低
scale	缩放；间接的，也能调整视频的分辨率；默认值： -1:-1；即与视频源大小保持一致；功能与 -s 参数相似；但是可以只传一个宽度或者高度，另一个参数用 -1 表示如： 1280:-1、-1:360，视频将会自适应现实降低分辨率会降低清晰度
vcodec	释义：视频编解码方式；请确保你了解该参数的意义，默认可以不传
contrast	释义：对比度，亮的地方更亮，暗的地方更暗。取值范围[-100.0, 100.0]，默认值为0。建议不调整，或者在[-2.0, 2.0]范围内进行小的调整
brightness	释义：亮度，如果觉得视频有点暗，可以进行小的调整。取值范围： [-1.0, 1.0]，默认值为0。
saturation	释义：饱和度，也就是说色彩更鲜艳，绿色更绿，蓝色更蓝...；取值范围：[0, 3.0]，默认值为1。
gamma	释义：关于显示器/视频的一个专业参数；取值范围：0.1-10.0，默认值为1。这个参数很专业，建议不传，不修改。

【详细参考例子：github.com/Neveryu/rts…】

支持 flv.js

flv.js 也是现在主流的播放器之一，而且 flv.js 播放器，默认就有进度条、在线回放、全屏、画中画、倍速播放等功能，有需要的可以选择 flv.js。

重要说明

【2023-06-18】随着大家对 rtsp2web 的使用与喜爱，也对 rtsp2web 提出了更高的要求和更多的功能需要；rtsp2web 一直在发展与进步中，如果你想了解 rtsp2web 最新的变化和使用文档，请参阅 rtsp2web 的官方文档，官方文档的内容更新的优先级最高。

课外知识

一、node install –unsafe-perm 是什么作用？

就是说 npm 出于安全考虑不支持以 root 用户运行，即使你用 root 用户身份运行了，npm 会自动转成一个叫 nobody 的用户来运行，而这个用户几乎没有任何权限。这样的话如果你脚本里有一些需要权限的操作，比如写文件（尤其是写 /root/.node-gyp），就会崩掉了。为了避免这种情况，要么按照 npm 的规矩来，专门建一个用于运行 npm 的高权限用户；要么加 –unsafe-perm 参数，这样就不会切换到 nobody 上，运行时是哪个用户就是哪个用户，即使是 root。

经常是安装 node-sass 的时候会很容易出现因为权限不够无法创建目录的问题官网文档： https://docs.npmjs.com/misc/config#unsafe-perm 。

二、在 nodejs 中，注意：最好不要使用 var 定义变量以避免引入全局变量，因为全局变量会污染命名空间，提高代码的耦合风险。

——————————【正文完】——————————

前端学习交流群，想进来面基的，可以加群： 832485817，685486827；

写在最后：约定优于配置 —— 软件开发的简约原则

写在最后

我的主页： neveryu.github.io/index.html

交流学习群：832485817

在web页面中直接播放rtsp视频流