微服务参数#
Unreal 渲染器微服务提供各种配置参数，这些参数及其描述可以在 UCS 微服务清单 和下面的概述中找到
参数名称 |
描述 |
UCS 参数名称 |
类型 |
UCS 默认值 |
环境变量名称 |
|---|---|---|---|---|---|
HTTP 服务器端口 |
HTTP API 服务器提供服务的端口。 |
httpServer.port |
整数 |
8021 |
IAUEMS_HTTP_SERVER_PORT |
信令服务器流媒体端口 |
信令和 Web 服务器监听来自 Unreal Engine 应用程序的传入连接的端口。 |
signallingServer.streamerPort |
整数 |
8888 |
IAUEMS_SIGNALLING_SERVER_STREAMER_PORT |
信令服务器 HTTP 端口 |
信令和 Web 服务器用于与客户端浏览器进行 HTTP 连接的端口。 |
signallingServer.httpPort |
整数 |
8080 |
IAUEMS_SIGNALLING_SERVER_HTTP_PORT |
信令服务器 HTTP 节点端口 |
信令和 Web 服务器用于与客户端浏览器进行 HTTP 连接的节点端口。 |
signallingServer.httpNodePort |
整数 |
30080 |
|
信令服务器对等连接选项 |
指定当 Unreal Engine 应用程序和浏览器需要发现它们自己的外部 IP 地址时，要查询的任何 STUN 和 TURN 服务器的主机名或 IP 地址。 |
signallingServer.peerConnectionOptions |
字符串 |
{ “iceServers”:[ { “urls”: [“turn:127.0.0.1:3478”], “username”: “user”, “credential”: “password” } ], “iceTransportPolicy”: “relay”} |
IAUEMS_SIGNALLING_SERVER_PEER_CONNECTION_OPTIONS |
Unreal Engine 版本 |
UE 应用程序中使用的 Unreal Engine 的简短发行版本号，例如“5.3”。 |
unrealEngine.version |
数字 |
5.3 |
|
资源下载远程资源路径 Unreal Engine 项目 |
Unreal Engine 打包项目的远程路径。 |
resourceDownload.remoteResourcePath.unrealEngineProject |
字符串 |
||
资源下载远程资源路径 MetaHuman PAK |
[可选] 打包的 MetaHuman PAK 文件的远程路径，用于替换项目中的 MetaHuman 资产。 |
resourceDownload.remoteResourcePath.metahumanPak |
字符串 |
||
资源下载远程资源路径场景 PAK |
[可选] 打包的场景 PAK 文件的远程路径，用于替换项目中的场景资产。 |
resourceDownload.remoteResourcePath.scenePak |
字符串 |
||
资源下载目标 |
远程资源下载到的文件夹。 |
resourceDownload.destination |
字符串 |
/home/unreal-renderer |
IAUEMS_RESOURCE_DOWNLOAD_DESTINATION |
资源下载 SecretName |
将挂载到资源下载 init 容器中以提供凭据的密钥的名称。例如，对于 NGC，为 “NGC_CLI_API_KEY”。 |
resourceDownload.secretName |
字符串 |
||
资源下载镜像 |
资源下载 init 容器的镜像名称。例如，“nvcr.io/nvidia/ace/ngc-resource-downloader:1.1.4” |
resourceDownload.image |
字符串 |
||
资源下载持久卷大小 |
存储 UE 资源及其所有依赖项所需的卷大小。 |
resourceDownload.persistentVolumeSize |
字符串 |
5000Mi |
|
窗口宽度 |
渲染的视频宽度。 |
window.width |
整数 |
1280 |
IAUEMS_WINDOW_WIDTH |
窗口高度 |
渲染的视频高度。 |
window.height |
整数 |
720 |
IAUEMS_WINDOW_HEIGHT |
部署内存请求 |
容器的资源内存请求。 |
deployment.memoryRequest |
字符串 |
1Gi |
|
部署内存限制 |
容器的资源内存限制。 |
deployment.memoryLimit |
字符串 |
4Gi |
|
部署 GPU 禁用分配 |
设置为 true 时，GPU 分配将从硬编码切换为动态分配。 |
deployment.gpuDisableAlloc |
布尔值 |
False |
GPU_DISABLE_ALLOC |
部署 GPU 分配限制 |
控制单个 GPU 上运行的副本数。 |
deployment.gpuAllocLimit |
整数 |
1 |
GPU_ALLOC_LIMIT |
附加参数 |
提供传递给启动命令的附加参数（例如 -logcmds=”LogACERuntime VeryVerbose”）。 |
params.deployment.additionalStartupArgs |
字符串 |
||
传播 API 路由 |
API 路由，其他组件在此路由上提供其 API (http://<host>:<port>/<route>)。 |
propagateApi.route |
字符串 |
/ue/ |
IAUEMS_PROPAGATE_API_ROUTE |
ACE 插件配置连接尝试次数 |
到动画数据源微服务的最大连接尝试次数。 |
acePluginConfig.numConnectionAttempts |
整数 |
900 |
IAUEMS_ACE_PLUGIN_CONFIG_NUM_CONNECTION_ATTEMPTS |
ACE 插件配置重试间隔秒数 |
到动画数据源微服务的连接重试间隔时间（秒）。 |
acePluginConfig.timeBetweenRetrySeconds |
数字 |
1 |
IAUEMS_ACE_PLUGIN_CONFIG_TIME_BETWEEN_RETRY_SECONDS |
ACE 插件配置缓冲长度（秒） |
开始播放前要缓冲多少秒接收到的动画数据。 |
acePluginConfig.bufferLengthInSeconds |
数字 |
0.1 |
IAUEMS_ACE_PLUGIN_CONFIG_BUFFER_LENGTH_IN_SECONDS |
IAUEMS_SIGNALLING_SERVER_STREAMER_HOST |
|||||
IAUEMS_ANIM_SOURCE_HOST |
|||||
IAUEMS_ANIM_SOURCE_PORT |
|||||
IAUEMS_PROP_API_HOST |
|||||
IAUEMS_PROP_API_PORT |
|||||
CUDA_DISABLE_CONTROL |
|||||
IAUEMS_STREAMER_ID |
默认情况下，UCS 应用程序配置微服务以从 NGC 下载头像场景。但是，还有其他下载资源的方法，您也可以创建自己的资源下载器 init 容器，如资源下载器部分所述。