名词解释


【通用设置】

  • 程序包Id:对应的程序包Id

  • 应用程序包:选择要发布的应用程序压缩包,只支持zip格式。操作步骤:右键单击要压缩的文件夹,选择【发送至】,然后选择【压缩(zipped)文件夹】。

  • 应用名称:填写要发布的应用程序名称,用于区分其他应用,内容任意。

  • 渲染类型

  • ① SR(独占模式):对于一些本地安装的应用的用户目录、可能存在跨用户访问权限问题的应用,以及多屏幕场景,建议使用独占模式。在这种模式下,一台服务器只能运行一个仿真应用。

  • ② SR(3D共享模式-平行云方案):此类型限制应用必须是纯三维仿真程序,并且一台服务器可以同时运行多个这样的应用。

  • ③ SR(2D共享模式-平行云方案):这种模式适用于既有2D又有3D元素的应用程序,主要解决带有2D元素的应用程序的多开需求。与3D共享模式相比,并发度较低,但在许多场景下可以替代独占模式。该模式支持预启动功能、音频输出、数据通道、互动模式,不支持客户端调整分辨率、麦克风、摄像头等设备透传。注意事项包括:1)系统会自动创建用户,用户目录下可能会有用户目录的残留;2)正常用户名不应以_LARKXR_开头;3)需要使用RDP服务,推荐修改默认的RDP端口;4)在安全审查严格时,可以在配置文件中关闭2D应用共享模式(修改管理节点配置文件:pxy.render-server.remote-desktop.enable=false);5)每个2D应用共享连接会占用一定的本地带宽,但影响不明显;6)进入应用的时间比3D共享模式稍慢;7)对于单机多卡的资源调度基于操作系统的轮询分配多个GPU资源。

  • 公开方式:公开应用可直接访问,私有应用需要设置访问口令及口令有效期。

  • 最大并发客户端:设置应用允许的最大同时使用人数,根据服务器性能和仿真程序资源占用情况进行调整。若同时运行多个应用,总并发连接数应综合考虑建议值进行设置。

  • 所属组别:选择应用所属的组别,分配时使用选中组别中的渲染服务器。

  • 是否传递TaskId:应用启动后会附加一个taskId作为命令行参数,应用可通过命令行参数获取taskId,用于接口调用等操作。

【高级设置】

【窗口初始化方式】

  • 按原始大小(不超过终端屏幕):客户端窗口初始化大小与服务器端应用的原始窗口大小相同,无滚动条。

  • 按原始大小(超过终端屏幕,出现滚动条):客户端窗口初始化大小与服务器端应用的原始窗口大小相同,出现滚动条。

  • 尽量填充容器(保持宽高比):窗口尽量填充Frame容器,保持原有宽高比。

  • 优先垂直方向填充(保持宽高比,水平方向允许出现滚动条):垂直方向填充容器,水平方向出现滚动条。

  • 优先水平方向填充(保持宽高比,垂直方向允许出现滚动条):水平方向填充容器,垂直方向出现滚动条。

  • 完全填充容器(拉伸):窗口完全填充Frame容器,可能进行拉伸。

【初始化分辨率方式】

  • 应用默认分辨率:应用启动时保持默认分辨率。
  • 适应客户端窗口:应用在服务器端启动时,将自动适配客户端窗口的分辨率。视频流的输出分辨率也将与客户端分辨率保持一致。这样的设计有效避免了客户端在使用过程中出现白边现象。需要注意的是,需要应用中能够动态响应窗口分辨率的设定。

【全屏模式】

  • 用户手动触发:用户按下Esc键或点击全屏按钮触发全屏。

  • 首次点击触发:首次点击时触发全屏。

  • 每次点击触发:每次点击都触发全屏。

【是否显示菜单】:默认情况下,功能菜单是需要显示的。如果该UI挡住了应用画面,可以隐藏功能菜单,隐藏后则将无法使用客户端提供的一些默认功能。请查阅前台使用说明中的功能菜单部分以获取详细的功能列表。

【是否为8K应用】:选择8K应用后,可在普通Chrome浏览器中使用8K程序,需https环境。

【初始背景色】:设置六位或三位颜色编号,用于填充未占满部分的背景色。

**【初始化鼠标模式】****:

  • 锁定模式:鼠标锁定在画面中,限制点击画面外内容。

  • 非锁定模式:鼠标可点击画面外内容。

【最大显存用量】:设置应用最大显存用量,0表示不预估系统剩余显存容量。

【QP最大值,QP最小值】:编码器使用QP进行编码,调整QP值影响画面质量和网络带宽压力。默认35通常适合,可根据画面清晰度和网络条件微调。若网络条件好,可以将QP最大值调小。

【开启中文输入】:可以直接利用客户端的输入法,将中文输入到应用里面。

仅适用于Windows版LarkXR

  • 【是否启用离屏渲染】

选择启用离屏渲染后,应用程序将在后台运行,不在屏幕上显示,有效减少服务器资源消耗。

  • 【最高编码帧率】

默认情况下,视频编码的帧率取决于客户端选择的帧率设置。例如,如果前端选择了60帧率,视频编码将以最高60帧的速度进行编码。若选择其他参数,客户端中传递的帧率(接口参数中的frameRate参数)将失效。

  • 【是否限制最大帧率】

默认为“是”,限制应用的帧率为客户端设置的30或60帧。选择“否”则不限制帧率,按照客户端设置输出。

  • 【互动模式中是否显示玩家列表】

进入互动模式后,确定是否在左上角显示玩家列表。默认为“是”。

  • 【是否使用手柄】

若SR应用支持手柄操作,请勾选“是”以使用物理手柄。

  • 【是否启用智能语音】

在应用编辑中开启智能语音功能。

  • 【是否启用客户端音频输入】

启用后,客户端可采集音频,服务器端输出至麦克风。使用方法请参考这里

  • 【是否自动开启音频输入】

选择“是”后,应用启动时自动开启麦克风。

  • 【是否启用客户端视频输入】

启用后,客户端可使用摄像头功能。使用方法请参考这里

  • 【是否自动开启视频输入】

选择“是”后,应用启动时自动开启摄像头。

  • 【开启直播推流】

选择“是”后,应用启动后可使用直播推流功能。使用方法请参考这里.

  • 【流路关闭方式】

选择即时关闭:网页关闭推流即结束;延时关闭:TaskInfo默认延迟20秒关闭,可支持断线重连。

  • 【延迟时间】

当选择“延时关闭”时,可设置延迟关闭时间,支持断线重连。

【移动端高级设置】

  • 【触摸指令模式】

在上传应用时,选择“触屏模式”以使用原生触摸指令,是否显示虚拟摇杆由用户决定。

  • 【全屏模式】

默认为“用户手动触发”,也可选择“首次点击触发”或“每次点击触发”。无论是安卓手机还是苹果手机,当设置全屏时,都可以触发系统横屏。然而,对于苹果手机,仅当允许旋转功能开启且手机横过来时,才会触发系统的横屏旋转。

  • 【是否强制横屏】

进入应用后,是否强制横屏显示。在这种情况下,横屏指的是用户在客户端中将画面横过来,而不会触发系统的横屏旋转。

  • 【是否初始显示虚拟遥杆】

进入应用后,是否显示虚拟遥杆圆盘。

  • 【触屏放大手势与滚轮映射】

在触屏设备中,双指放大操作对应于滚轮上下滚动操作。

  • 【输入键盘类型】

系统键盘:输入框获取焦点弹出系统输入法;虚拟键盘:输入框获取焦点弹出虚拟键盘。

  • 【菜单类型】

控制球:以控制球形式展示菜单;菜单栏:菜单以菜单栏形式附加到客户端右侧边栏。详细展示请参考【前台使用说明->功能菜单->移动端】。


admin April 17, 2025, 1:17 p.m. 收藏文档

开发者交流群

QQ群号:1011308692