Choose your operating system:
Windows
macOS
Linux
此页面将讲述像素流送系统诸多部分所公开的选项、设置和命令行参数。
支持的图形硬件
用像素流送插件运行虚幻引擎应用程序的电脑必须具备以下类型的图形硬件之一:
支持硬件加速视频编码(NVENC)的NVIDIA GPU硬件。详情请见NVIDIA的支持硬件列表。
支持高级媒体框架(AMF)的AMD GPU硬件。
如尝试使用像素流送插件时收到错误消息 未找到兼容的GPU,或未能加载其编码器库(No compatible GPU found, or failed to load their respective encoder libraries),原因很可能是GPU不支持NVENC或AMF。
支持的操作系统
像素流送插件与信令和Web服务器已在Windows 8和Windows 10上进行测试。
其尚未在其他操作系统上进行测试,包括Windows 7。
支持的客户端浏览器
像素流送播放可在支持WebRTC协议上的主流浏览器上使用。举例而言,经过测试,其无需额外配置便可兼容以下浏览器的最新版本:
Google Chrome(桌面版和移动版)
Mozilla Firefox(桌面版和移动版)
Apple Safari(桌面版和移动版)
其他浏览器(如Microsoft Edge和Opera)则需要附件组件或插件,并且可能无法用于所有系统。
默认网络端口
像素流送系统的组件使用如下所述的默认端口进行通信。需要确认这些端口已在运行每个组件的主机上打开。
组件 |
端口 |
---|---|
|
|
|
|
虚幻引擎控制台命令
Encoder 命令控制像素流送插件将虚幻引擎渲染帧编码为视频帧的方式。
命令 |
描述 |
---|---|
|
允许的最大比特率,以bps为单位。 |
|
编码器的目标分辨率大小,格式为 |
|
让编码器使用后置缓冲大小(即为渲染游戏视口的代销),而非 Encoder.TargetSize 设置的自定义大小。 |
虚幻引擎命令行参数
启动虚幻引擎应用程序时在命令行上设置这些属性。
参数 |
描述 |
---|---|
|
决定播放器网页是否能使用 |
|
强制虚幻引擎使用软件混合音频,以便像素流送插件采集音频。 |
|
必需。 指定运行信令和Web服务器的计算机的IP地址或域名。 |
|
必需。 指定信令和Web服务器用于监听来自虚幻引擎应用程序通信的端口。
信令和Web服务器的默认值为 |
|
像素流送插件应从播放器网页中继至虚幻引擎的输入中过滤掉的键盘键的列表,以逗号分隔。如果在浏览器中按下其中一个键,此事件将不会被中继至虚幻引擎的输入控制器。 |
|
设置虚幻引擎应用从信令和网页服务器接收的信息的最大长度,以字节为单位。 |
|
以headless模式运行虚幻引擎应用程序,本地机上不带任何可见的渲染。应用程序不会显示任何窗口,也不会以全屏渲染。 |
|
指定后,覆盖默认的编码器帧率。 |
|
编码器可编码的帧的最大宽度。 |
|
编码器可编码的帧的最大高度。 |
|
指定后,覆盖编码器的默认平均比特率。 |
|
决定H.264的压缩级别:5.2或5.1。如果不设置此参数,解码器将使用5.2级别,可以解码高清分辨率,如3840x2160(4K)。
如果要解码较低的分辨率,可以将此参数设置为 |
信令服务器配置参数
设置这些参数的方法有两种:
运行
run.bat
或node cirrus.js
启动信令和Web服务器时在命令行上进行设置。在此情况中,在每个参数前添加--
前缀,然后在其后添加空格,然后再加上需要设置的值。例如--httpPort 81
。在配置文件中设置。信令和Web服务器(
cirrus.js
)默认在同个文件夹中查找一个名为config.json
的文件。在此情况中,将把需要对其进行设置的每个参数和值设为文件中定义的JSON对象中的一个键值对。如果已启动信令和Web服务器至少一次,则参数已列出在Engine/Source/Programs/PixelStreaming/WebServers/SignallingWebServer/config.json
文件中。
参数 |
描述 |
---|---|
|
运行信令和Web服务器的电脑的公开IP。 |
|
信令和Web服务器用于与客户端浏览器进行HTTP连接的端口。 |
|
信令和Web服务器上聆听来自虚幻引擎应用传入连接的端口。 |
|
指定虚幻引擎应用和浏览器需要了解自身外部IP地址时进行查询的所有STUN和TURN服务器的主机名或IP地址。 值的格式必须为一个字符串,即使使用JSON配置文件来提供参数也同样如此。前后必须使用双引号,在字符串中使用反斜杠来断开引用。如下所示: |
|
服务器将提供的默认页面的文件名,以连接不请求特定URL的客户端浏览器。 |
|
指定信令和Web服务器应服务的额外文件夹。 |
|
决定信令和Web服务器是否将日志消息写入 |
|
将此参数设为 true,使信令服务器仅接受 httpsPort 上的HTTPS连接。 |
|
聆听HTTPS连接的端口。只在 UseHttps 启用时使用。 |
|
确定信令和Web服务器是否将其当前状态发送到配对服务器,以帮助客户端浏览器寻找当前未使用的信令服务器和虚幻引擎应用。 |
|
信令和Web服务器应接触的配对服务器的IP地址。 |
|
配对服务器聆听来自信令和Web服务器消息的端口。 |
|
指定配置文件的路径和文件名(信令服务器将把此文件用于获取上述属性的值)。只能在命令行上进行设置。 |
配对服务器命令行参数
运行服务器的 run.bat
文件、或运行 node.exe matchmaker.js
启动配对服务器,在命令行上提供这些参数。
参数 |
描述 |
---|---|
|
设置聆听来自客户端HTTP连接的配对服务器端口数量。 |
|
设置聆听来自Cirrus信令服务器的传入消息的配对服务器端口数量。 |