LarkXR 4.0
快速入门指南
环境准备
CPU
GPU
内存
操作系统
声卡
DX 运行库
VC 运行库
文本编辑器
虚拟声卡驱动
虚拟手柄控制器驱动
虚拟摄像头驱动
设置永不睡眠_从不关闭显示器
设置自动登录
关闭杀毒软件与防火墙
关闭应用程序运行通知
安装与部署
单机版:文件结构概览
单机内网部署指南
单机外网访问指南
简易集群版:包结构与部署概览
集群内网(Windows)
集群外网(Windows)
LarkXR4.0 NAT(Win)
LarkXR4.0 NAT
LarkXR4.0 Turn:渲染节点内置 TURN 代理
Nginx 反向代理:将 LarkXR4.0 集群暴露到外网
专用 GPU 服务器:机架安装与初始化
上架的操作系统兼容性与注意事项
服务器端口映射:通过端口转发暴露 LarkXR4.0 集群
边缘集群部署:多地案例
高级集群部署:高可用与多主节点
应用适配
AR
SR
程序适配要求(VR)
客户端体验
浏览器
浏览器兼容性指南
语言支持
应用概览
启动应用
资源分配策略
PC 客户端:功能菜单指南
移动客户端:功能菜单指南
移动端触控手势模式
虚拟摇杆(遥控杆)设置
退出应用
AR 设备
AR APP
客户端支持
VR 头显
Pico Neo3
Quest
Steam VR
管理后台
登录管理后台
同步管理
同步概览
定制化
应用首页
进入应用
服务端设置
应用管理
程序包一览
添加安装包
编辑安装包
删除安装包
应用一览
添加应用
鼠标映射
分享
名词解释
名词解释(AR)
名词解释(VR)
数据中心
数据中心:资源监控
数据中心:使用统计
数据中心:客户端错误日志
用户管理
用户
如何修改登录密码
系统设定
授权方式
无操作超时
存储配置
安全措施
区域设置
自定义 Logo
端口映射
主题
限流
工作空间
接入管理
组别管理
分组管理
客户端监控
终端管理
SR 客户端管理
VR&AR 客户端管理
进程管理
运行应用
预启动管理
预启动应用
保活检测功能
存储
本地存储
OSS 存储
AWS S3
磁盘空间
配置最大同步数量
安全
Https - Windows
Https - Linux Docker
IP 黑白名单
CORS
上传 CORS
是否开启一览页面
修改用户名和密码
加密二次开发的 SDK ID
工作区访问加密
禁用统计视图
功能特性
数据通道
附加参数
视频输入
语音输入
互动模式使用方法
互动模式接口集成
手柄
MySQL8
Redis
技术实践
数据通道 + WebSDK
WebGL 数据通道
批量创建渲染服务
如何修改10002
如何修改10003
如何修改10004
如何修改16379端口
如何修改8089
如何修改8181端口
如何修改8182端口
如何修改8184端口
如何修改UDP端口
发布说明
产品发布说明
-
+
首页
名词解释(AR)
## 常规设置 - **程序包 ID**:对应的程序包 ID - **应用安装包**:选择待发布的应用安装包,仅支持 zip 格式。操作步骤:右键点击待压缩的文件夹,选择「发送到」,再选择「压缩(zipped)文件夹」。 - **应用名称**:填写待发布应用的名称,用于与其他应用区分,内容可自定义。 - **渲染类型**: - ① SR(独占模式):对于部分本地安装应用、用户目录、可能存在跨用户访问权限问题的应用,以及多屏场景,建议使用独占模式。该模式下,一台服务器只能运行一个仿真应用。 - ② SR(3D 共享模式 - 平行云方案):该类型要求应用为纯 3D 仿真程序,一台服务器可同时运行多个此类应用。 - ③ SR(2D 共享模式 - 平行云方案):适用于同时包含 2D 与 3D 元素的应用,主要用于满足含 2D 元素应用的多开需求。相比 3D 共享模式,并发更低,但在许多场景下可替代独占模式。该模式支持预启动、音频输出、数据通道、互动模式,不支持客户端分辨率调整、麦克风、摄像头等设备透传。注意事项包括:1)系统会自动创建用户,可能残留用户目录;2)正常用户名不应以 \_IMMERSHARE SCALE\_ 开头;3)需要 RDP 服务,建议修改默认 RDP 端口;4)在严格安全审核场景下,可在配置文件中禁用 2D 应用共享模式(修改管理节点配置文件:pxy.render-server.remote-desktop.enable=false);5)每个 2D 应用共享连接会消耗部分本机带宽,影响通常不大;6)进入应用比 3D 共享模式略慢;7)单机多 GPU 的资源调度基于操作系统对多 GPU 资源的轮询分配。 - ④ SR(3D 共享模式 - UE Pixel Streaming 方案):该模式下,一台服务器可同时运行多个仿真应用,且这些应用集成了 Pixel Streaming 方案。 - **公开访问**:公开应用可直接访问;私有应用需设置访问密码及密码有效期。 - **最大并发客户端数**:设置允许同时使用该应用的最大用户数,需根据服务器性能及仿真程序资源占用进行调整。若同时运行多个应用,总并发连接数应按建议值设置。 - **所属分组**:选择应用所属分组,渲染服务器将从所选分组中分配。 - **传递 TaskId**:是否传递 TaskId。应用启动后,会将 taskId 作为命令行参数附加;应用可通过命令行参数获取 taskId,用于 API 调用等操作。 ## 高级设置 ### [窗口初始化方式] - **原始尺寸(不超过终端屏幕)**:客户端窗口初始化为与服务端应用原始窗口相同的尺寸,无滚动条。 - **原始尺寸(超出终端屏幕带滚动条)**:客户端窗口初始化为与服务端应用原始窗口相同的尺寸,带滚动条。 - **尽量填满容器(保持宽高比)**:窗口在保持原始宽高比的前提下尽量填满 Frame 容器。 - **优先纵向填满(保持宽高比并带横向滚动条)**:纵向填满容器,并带横向滚动条。 - **优先横向填满(保持宽高比并带纵向滚动条)**:横向填满容器,并带纵向滚动条。 - **完全填满容器(拉伸)**:窗口完全填满 Frame 容器,可能发生拉伸。 ### [初始化分辨率方式] - **默认应用分辨率**:应用以默认分辨率启动,以适配客户端窗口并避免白边。 ### [全屏模式] - **用户手动触发**:用户通过按 Esc 键或点击全屏按钮触发全屏。 - **首次点击触发**:首次点击时触发全屏。 - **每次点击触发**:每次点击时触发全屏。 **[是否为 8K 应用?]**:选择 8K 应用后,可在普通 Chrome 浏览器中使用 8K 程序,需 HTTPS 环境。 **[初始背景颜色]**:设置六位或三位颜色代码,用于填充未铺满部分的背景色。 ### [初始鼠标模式] - **锁定模式**:鼠标锁定在屏幕上,限制在屏幕外点击。 - **非锁定模式**:鼠标可在屏幕外点击。 **[最大显存占用]**:设置应用的最大显存占用,0 表示不估算系统剩余显存容量。 **[QP 最大值、QP 最小值]**:编码器使用 QP 进行编码,调整 QP 值会影响画质与网络带宽压力。默认值 35 通常较为合适,可根据画面清晰度与网络状况微调。若网络状况良好,可适当降低 QP 最大值。 ## 仅适用于 Windows 版 LarkXR 4.0 - **[启用离屏渲染]** 勾选启用离屏渲染后,应用在后台运行且不在屏幕上显示,可有效降低服务器资源消耗。 - **[限制最大帧率]** 默认为「是」,将应用帧率限制为客户端设置的 30 或 60 帧。选择「否」则取消帧率限制,按客户端设置输出。 - **[互动模式下显示玩家列表]** 进入互动模式后,是否在左上角显示玩家列表。默认为「是」。 - **[使用手柄]** 若 SR 应用支持手柄操作,选择「是」以使用实体手柄。 - **[启用智能语音]** 在应用编辑器中启用智能语音功能。 - **[启用客户端音频输入]** 启用后,客户端可采集音频,并由服务端输出到麦克风。使用说明请参考[此处](https://www.pingxingyun.com/contribute/detail?topicId=10097&categoryId=3)。 - **[自动开启音频输入]** 选择「是」后,应用启动时自动打开麦克风。 - **[启用客户端视频输入]** 启用后,客户端可使用摄像头功能。使用说明请参考[此处](https://www.pingxingyun.com/contribute/detail?topicId=10112&categoryId=3)。 - **[自动开启视频输入]** 选择「是」后,应用启动时自动打开摄像头。 - **[启用直播推流]** 选择「是」后,应用启动后可使用直播推流功能。使用说明请参考[此处](https://immershare.com/docs/page/scale-client-live-streaming/)。 - **[关流方式]** 选择立即关闭:关闭网页即立即停止推流;延迟关闭:TaskInfo 默认延迟 20 秒关闭,支持断线后重连。 - **[延迟时间]** 选择「延迟关闭」时,设置断线重连的延迟关闭时间。 ## 移动端高级设置 - **[触控指令模式]** 上传应用时选择「触控模式」以使用原生触控指令,是否显示虚拟摇杆由用户决定。 - **[全屏模式]** 默认为「用户手动触发」,也可选择「首次点击触发」或「每次点击触发」。无论在 Android 还是苹果手机上,设置为全屏均可触发系统横屏模式。但对苹果手机,仅在开启旋转功能并将手机横置时,才会触发系统横屏旋转。 - **[强制横屏模式]** 进入应用后,是否强制横屏显示。此处的横屏指用户在客户端中将画面横向显示,而不触发系统横屏旋转。 - **[启动时显示虚拟摇杆]** 进入应用后,是否显示虚拟摇杆圆盘。 - **[触控缩放手势与滚轮映射]** 在触控设备上,双指缩放手势对应滚轮上下滚动。 - **[输入键盘类型]** 系统键盘:输入框获得焦点时弹出系统输入法;虚拟键盘:输入框获得焦点时弹出虚拟键盘。 - **[菜单类型]** 控制球:以控制球形式展示菜单;菜单栏:以菜单栏形式将菜单附着在客户端右侧边栏。详细展示请参考[前端使用说明 -> 功能菜单 -> 移动端]。
admin
2026年8月25日 17:11
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
开发者交流群
QQ群号:1011308692
Markdown文件
Word文件
PDF文档
PDF文档(打印)
分享
链接
类型
密码
更新密码
有效期