像素流参考

本文将介绍像素流系统各个部分公开的选项、设置和命令行参数。

下文提到的许多设置和参数在新的Pixel Streaming 2插件中已被修改或移除。请参阅Pixel Streaming 2概览文档以了解详情。

支持的图形硬件

要运行带有像素流插件的虚幻引擎应用程序，计算机必须具有以下类型的图形硬件之一：

• 支持硬件加速视频编码（NVENC）的NVIDIA GPU硬件。请参阅NVIDIA的支持设备对照表。
• 支持高级媒体框架（AMF）的AMD GPU硬件。
• 支持使用VideoToolbox框架的Macintosh硬件。

如果你在尝试使用像素流插件时，收到错误消息 找不到兼容的GPU，或无法加载各自的编码器库（No compatible GPU found, or failed to load their respective encoder libraries） ，很可能你的GPU不支持NVENC或AMF。

支持的操作系统

像素流插件支持Windows、Linux和Mac平台。不支持OSX。

但是，像素流插件以及随附的信令和Web服务器仅在Windows 10、Ubuntu 18.04/20.04和MacOS Ventura 13.5.1上进行了测试。尚未在其他操作系统上测试，包括Windows 7或8。

支持的客户端浏览器

像素流播放适用于支持WebRTC协议的现代浏览器。例如，它经过了测试，已知可在以下浏览器的最新版本中运行，无需额外配置：

• Google Chrome（台式机和移动设备）
• Microsoft Edge（台式机）
• Mozilla Firefox（台式机和移动设备）
• Apple Safari（台式机和移动设备）

Microsoft Edge和Opera等其他浏览器可能需要附加组件或插件，并且可能在某些系统上运行不了。

支持的编码器

对于1080p流媒体，随着比特率提高到20mbps以上，所有编码器的质量都将类似。此处列出的编码速度是估算值，取自RTX 3060和AMD 3900X。但AV1例外，它是在NVIDIA RTX 6000 Ada上测试的。 如果你的编码硬件支持，我们推荐使用AV1编码解码器，因为它可以在更低的比特率下生成更高质量的视频。

默认网络端口

像素流系统的组件使用下面指定的默认端口通信。你需要确保在运行每个组件的主机上打开这些端口。

像素流控制台命令和启动参数

本小节中含有对使用像素流的应用程序非常实用的控制台命令和启动参数。

所需的启动参数

启动使用像素流的虚幻引擎应用程序时，必须指定以下启动参数：

标准的像素流应用程序启动如下：

MyPixelStreamingApplication.exe -PixelStreamingIP=127.0.0.1 -PixelStreamingPort=8888
Copy full snippet

MyPixelStreamingApplication.exe -PixelStreamingIP=127.0.0.1 -PixelStreamingPort=8888

或：

MyPixelStreamingApplication.exe -PixelStreamingURL="ws://127.0.0.1:8888"
Copy full snippet

MyPixelStreamingApplication.exe -PixelStreamingURL="ws://127.0.0.1:8888"

虚幻引擎启动参数

以下参数并非专用于像素流。但是，这些参数可能会适用于许多像素流应用程序，尤其是在云部署中。

可选的控制台命令启动参数

你可以在运行时将以下设置指定为控制台变量，或在启动时指定为程序参数。

未指定这些设置时，系统将为使用的每种设置提供默认值。大多数用户不需要更改这些设置。事实上，这些值中有许多值由WebRTC内部控制，覆盖它们可能会导致性能下降。

像素流插件配置

更改以下设置将配置像素流插件。

编码器配置

更改以下设置将配置像素流插件使用的底层视频编码器。

WebRTC配置

更改以下设置将配置像素流插件内部使用的WebRTC库。

信令服务器配置参数

有两种参数设置方法：

• 在命令行上，当你通过运行 start_with_stun.bat 启动信令和Web服务器时。在这种情况下，在每个参数名称前加上 --（两个连接号），然后在它后面加上空格，后面是你要设置的值。例如：--player_port 81。
• 在配置文件中。默认情况下，信令和Web服务器（cirrus.js）会在同一文件夹中查找名为 config.json 的文件。在这种情况下，将每个参数和你要为其设置的值设置为文件中定义的JSON对象中的键值对。如果你已经至少启动过一次信令和Web服务器，请参阅此处的参数。

关于信令服务器的完整参数列表，请参阅此处的像素流送基础设施中的相关页面。

匹配器服务器命令行参数

当你通过运行 run.bat 文件启动匹配器服务器，或通过运行 node.exe matchmaker.js 启动它时，请在命令行上提供这些参数。

SFU服务器参数