⚠ 注意!我们已从OBS.Ninja更名为VDO.Ninja - 其他一切保持不变 ✨
什么是 VDO NINJA
VDO.Ninja使用点对点技术将远程摄像头引入OBS或其他工作室软件。
在大多数情况下,所有视频数据直接在对等节点之间传输,无需通过任何视频服务器。这可以实现高质量的视频和超低延迟。在少数情况下,视频数据可能会通过加密的TURN服务器传输,该服务器用于在无法直接连接时促进对等连接。
VDO.Ninja旨在允许内容创作者使用远程媒体流制作实时直播节目。它还可以将智能手机变成无线网络摄像头,配合额外的虚拟摄像头软件使用。
VDO.Ninja作为托管服务在https://vdo.ninja免费提供使用。App Store和Play Store上也有原生应用版本,但这些原生应用相比网页版功能较为简单。
如需实时支持,请加入我们的Discord:https://discord.vdo.ninja
请查看子版块获取更多信息:https://reddit.com/r/vdoninja
还可以查看用户文档:https://docs.vdo.ninja
如何使用
YouTube上有VDO.Ninja基本用法的视频演示和播放列表:https://www.youtube.com/watch?v=QaA_6aOP9z8&list=PLWodc2tCfAH1l_LDvEyxEqFf42hOBKqQM&index=1
这里还有一个涉及更多高级设置的视频系列:https://www.youtube.com/watch?v=mQ1Jdhf5aYg&list=PL8VJWj2-XLFpFu3G35Hdm1nKZ2xn9_0_8
查看子版块获取更多使用案例、高级功能和支持。高级功能包括高质量音频模式、自定义视频分辨率等。
这个仓库包含什么
这个仓库包含VDO.Ninja的Web客户端软件,以及许多利用其IFRAME API的示例应用。还提供了示例配置文件和设置可选TURN视频中继服务器的说明。VDO.Ninja本身的用户文档可在docs.vdo.ninja找到。
如何部署这个仓库
VDO.Ninja在https://vdo.ninja提供免费使用的托管服务,因此部署是可选的。如果你确实想自行部署服务,以下提供了详细信息。
托管私人/个人部署可以简单到在启用HTTPS的Web服务器上托管此仓库中的文件。这里有一个非常简单的方法视频指南:https://www.youtube.com/watch?v=uYLKkX2_flY
对于更高级的用户,你可以查看install.md文件,了解其他托管选项和部署其他系统组件的更多详细信息。我们为自行部署提供有限的技术支持,主要是因为这类请求非常耗时,但在install.md文件中提供了完全部署所有必需系统组件的详细信息。
如果自行托管,你可能还希望托管自己的视频中继TURN服务器。如何部署TURN服务器的说明列在turnserver.md文件中。通常只有约5%的远程访客需要TURN服务器,通常是那些通过4G LTE连接或在严格防火墙后面的用户,但大多数其他用户不需要。虽然VDO.Ninja确实托管了一些公共TURN服务器,但它们的运营成本相当高,所以请尽量避免滥用。如果你正在部署自己的VDO.Ninja版本,我希望你能够使用自己的TURN服务器(如果可能的话);如果你无法做到这一点,也是可以理解的。
对于希望离线托管VDO.Ninja的用户(没有互联网连接的情况),这里有一个包含本地和离线部署所需一切内容的仓库:https://github.com/steveseguin/offline_deployment。离线版本包括Docker选项,并且有一些社区创建的Docker可用于在线托管。我最终可能会提供一个为有更高要求的在线用户设计的官方Docker选项,但目前我缺乏时间和支持来维护这样一个项目。
开发版与发布版
这个仓库的develop分支有点像VDO.Ninja的预览版或每夜版。它应该是功能性的,但可能没有经过充分测试,或者可能有未完成的功能。develop版本与通常在vdo.ninja/alpha/上的版本密切相关,非常适合那些希望提交代码更改或获取实验性新功能的人。你也可以在Github页面上访问GitHub develop分支的托管版本:https://steveseguin.github.io/vdo.ninja/
VDO.Ninja的发布版本有自己的分支。这些最新的发布分支将根据需要更新以修复错误或关键问题,但除此之外保持不变。https://github.com/steveseguin/vdo.ninja/branches
由于实时视频制作的性质,通常不欢迎对应用程序进行意外更改,所以我不经常更新https://vdo.ninja/。此外,对主托管应用程序的持续更新使支持用户变得具有挑战性,因为很难判断问题是出在代码上还是用户身上。因此,VDO.Ninja对主要托管的生产版本进行不频繁的更新。希望获得新功能或风险承受能力更强的用户应该使用https://vdo.ninja/alpha/的alpha版本。
服务器端/API软件
由于VDO.Ninja使用点对点技术,在95%的情况下,视频连接直接在查看者和发布者之间建立。自行托管TURN服务器可能有助于提高性能,但不到1%的用户会通过使用TURN服务器看到视频质量的改善。TURN服务器也不会帮助降低带宽使用或CPU使用,所以通常你希望尽可能避免使用它们。
提供了如何部署TURN服务器的详细信息;请参阅:turnserver.md。对于那些能够托管自己的TURN服务器的人,如果可能的话,我们将非常感谢,因为TURN服务器目前是VDO.Ninja产生的最大成本。(当然,除了时间之外) 除了TURN服务器,VDO.Ninja还使用公共STUN服务器和托管的握手服务器。这些服务器用于促进对等连接的初始设置,通常在建立对等连接后不再需要。这些服务器可以免费访问和使用,即使是私人部署也是如此。从VDO.Ninja的17.3版本开始,您可以托管自己的握手服务器或使用第三方管理的服务器(如piesocket.com);详情请参见:https://github.com/steveseguin/websocket_server
VDO.Ninja的一个设计目标是无服务器化,我们已经接近99%实现这一目标。这一设计目标确保VDO.Ninja可以免费提供,同时提供更高级别的安全性和隐私保护。
遇到问题?不工作?
加入我和社区的Discord获取支持和更多信息:https://discord.vdo.ninja。如需更紧急的支持或其他查询,可以发邮件给我:steve@seguin.email。
sub-Reddit可在https://reddit.com/r/vdoninja访问。我通常会对那里发布的支持问题给出简短回复,但如需深入讨论,请加入Discord。
也请查看常见问题解答:https://docs.vdo.ninja 或在https://updates.vdo.ninja查看最新产品更新。
我在YouTube上维护了一个包含VDO.Ninja相关内容的播放列表:https://www.youtube.com/watch?v=vLpRzMjUDaE&list=PLWodc2tCfAH1WHjl4WAOOoRSscJ8CHACe,但YouTube上也有很多值得一看的社区创建的指南。
相关项目
VDO.Ninja的Electron Capture:
如果OBS浏览器源无法满足您的需求,这是在桌面上进行"窗口捕获"的更好方法。这是一个可下载的工具,旨在增强VDO.Ninja,但已扩展为对内容创作者有更多功能。 https://github.com/steveseguin/electroncapture
Social Stream Ninja
一个免费的Chrome扩展程序(现在也有独立应用版本),让您可以流式传输并展示来自YouTube、Twitch、Facebook等平台的聊天评论。精选评论将直接在OBS或VMix中作为叠加层显示,或作为评论流列表显示。它还包括一个功能更高级的停靠栏,如文字转语音、情感分析和保存到磁盘。无需色键,样式易于自定义,无需修改Chrome扩展程序本身。 http://socialstream.ninja
Rasbperry Ninja
使用Linux系统、Raspberry Pi、Nvidia Jetson、Mac,甚至Windows PC(WSL)来发布或查看使用Gstreamer和Python的WebRTC视频;无需浏览器。该项目可以使用系统的本地硬件编码器来实现高分辨率视频,甚至加速AV1编码。支持USB、CSI和HDMI视频源,并提供无需转码的直通选项。适用于OpenCV,可用于低延迟计算机视觉和机器学习应用。 http://raspberry.ninja
CAPTION.Ninja
一个免费的基于AI的闭路字幕工具,可为OBS Studio添加语音转文字叠加层。它是基于浏览器的,易于与OBS或VMix集成。同样由Steve开发!https://caption.ninja
隐私
我尽量避免数据收集,视频流通常设计为私密的,但使用风险自负。最好不要与不信任的人分享使用VDO.Ninja创建的链接。如果IP地址隐私是您关心的问题,我提供了如何部署TURN服务器的说明。请参见:turnserver.md
https://vdo.ninja 可能不可避免地使用一些免于欧盟法律要求通知其使用的cookie;它们是豁免的,因为它们是网络服务技术功能所必需的。我们的网络服务器由Cloudflare缓存,为VDO.Ninja的用户提供拒绝服务保护。
应要求,每周都在添加额外的安全功能。如果您需要增强的安全性和隐私,请询问这些选项。
反馈
欢迎提出想法、反馈、报告错误等。我正在将许多想法作为问题提交到Github。通常最欢迎通过电子邮件或Discord提供反馈。
许可
VDO.Ninja以"大部分"开源的形式提供;详情请参见LICENCE.md文件。
致谢
感谢到目前为止所有帮助支持这个项目的人。包括版主、提供支持的志愿者、贡献媒体资产的人、项目赞助商、报告问题的人、提供反馈的人以及任何代码提交者。