LarkSR帮助手册3.2.23+
环境准备
硬件环境
CPU
内存
GPU
声卡
软件环境
操作系统
Chrome浏览器
VC运行库
DX Runtime
文本编辑器
虚拟声卡驱动
虚拟摄像头驱动
虚拟手柄驱动
系统设置
关闭防病毒和防火墙
关闭应用运行通知
设置开机自动登录
设置从不休眠-从不关闭显示器
使用加密狗的设置
安装部署
系统构成
单机版
简易集群版(Windows)
简易集群版(Linux Docker)
三维程序适配
程序适配要求
部署详解
单机内网
单机外网
集群内网(Windows)
集群外网(Windows)
集群外网(Linux Docker)
部署案例
Nginx反向代理
高级集群部署
turn服务器转发
服务器端口映射
GPU专用服务器
服务器上架指南
操作系统注意事项
运行LarkXR
浏览器
浏览器支持
前台使用说明
语言支持
应用一览
使用说明
进入应用
使用说明_副本1
视频交互
使用说明_副本2
语音交互
语音使用说明
直播推流
使用方式
文字输入
输入法使用说明
区域探测
区域使用说明
分配策略
详细说明
摇杆设置
手势说明
触摸模式使用说明
功能菜单
PC端
移动端
退出应用
退出使用说明
后台使用说明
登录页
数据中心
资源监控
使用统计
客户端异常监控
应用管理
应用管理
分享
触屏键鼠映射
预启动应用一览
进程管理
进程管理
同步管理
同步管理
终端管理
SR终端管理
组别管理
组别管理
系统设定
接入管理
参数设置
授权方式
无操作时限
存储
安全
区域设置
定制Logo
短信通知
监控数据存活设置
端口映射
分配策略
限流配置
主题
用户管理
用户管理
修改密码
修改密码
品牌定制化
Web端
服务端
应用存储
单机版存储
本地存储
AWS S3存储
OBS存储
OSS存储
Minio存储
集群版存储
本地存储_副本1
AWS S3存储_副本1
OBS存储_副本1
OSS存储_副本1
Minio存储_副本1
通用功能
磁盘空间
功能组件
数据通道
附加参数
智能语音
视频输入
语音输入
手柄接入
互动模式
使用方式_副本1
前台页面使用
互动模式接口对接
安全设置
功能服务组件
Nacos
Redis
MariaDB
Minio
数据库监控
屏蔽此功能
更改用户名密码
Https访问
Windows
Linux Docker
客户端访问凭证
加密15分钟
一次性加密
IP黑白名单
黑名单
白名单
允许跨域
系统允许跨域
允许跨域上传应用
常见问题
常见问题一览
更新记录
产品更新记录
升级3.3注意事项
-
+
首页
产品更新记录
#### 2025-02-19 ##### LarkXR V3.2.23.7 优化:websdk、webgl渲染、摄像头相关问题 修复:Bug #### 2024-02-10 ##### LarkXR V3.2.23.6 优化VR监控页面、预启动应用初始调整大小窗口问题、WebGL附加参数 #### 2024-10-09 ##### LarkXR V3.2.23.5 优化细微功能 修复Bug #### 2024-07-27 ##### LarkXR V3.2.23.4 优化VR性能 修复Bug #### 2024-06-24 ##### LarkXR V3.2.23.3 预启动功能支持配置多应用 2D共享模式和独占模式增加输入法适配 优化及Bug修复 #### 2024-05-10 ##### LarkXR V3.2.23.2 修复相关Bug #### 2024-03-03 ##### LarkXR V3.2.23.1 优化在使用4090显卡时2D共享模式并发路数过低的问题(极限状态最多能开10路,需要修改配置文件) 优化Unity应用的多点触控问题 优化后台UI 修复相关Bug #### 2024-02-05 ##### LarkXR V3.2.23.0 优化8K应用的云渲染方案,普通浏览器即可正常使用 优化集群节点资源监控页面 优化预启动功能 优化客户端UI 修复相关Bug #### 2023-12-22 ##### LarkXR V3.2.22.0 增加2D应用共享渲染模式 修复Bug #### 2023-12-14 ##### LarkXR V3.2.21.4 修复:预启动场景下没使用应用配置的编码质量参数问题 #### 2023-12-12 ##### LarkXR V3.2.21.3 修改:机器码生成策略 修复:修复KVM虚拟机缺少支持的指令集问题 #### 2023-12-08 ##### LarkXR V3.2.21.2_fix 修复:声网SDK兼容性 修复:延迟关闭下,网络异常断开后,重连无法操作键盘鼠标的问题 (管理节点版本号依然使用3.2.21.2) #### 2023-11-17 ##### LarkXR V3.2.21.2 修复:Windows11上渲染服务器启动应用时会启动记事本程序的问题 修复:独占模式,采用触屏操作的应用,连续移动不好用的问题 修改:Web客户端页面上,文本输入框的输入结束后,位置不做归零处理原地隐藏,避免个别时候每次输入上下跳动的问题 修复:非主动同步应用夜间删除问题 优化:taskInfo/closeTasks 接口,出错时返回错误code码,方便用户捕获 修复:WindowsServer2016兼容性问题(2023-11-28) #### 2023-10-20 ##### LarkXR V3.2.21.1 采用新架构的管理器 增加:中文繁体支持 增加:分配请求时检查GPU显存使用率和当前应用所需最大显存用量的处理 增加:重启的服务器接口 增加:分享链接的密码设置及有效期限 增加:动态修改云端应用分辨率 增加:鸟瞰图功能 增加:重启应用功能 增加:TaskInfo的延迟关闭方式,从而可以支持业务系统的断线重连 增加:应用配置页面增加【初始化分辨率方式】配置选项,可以让应用适应客户端分辨率 增加:删除节点时,同时删除组别绑定信息 优化:cry engine 5引擎的兼容问题 修改:暂时去除了8K的支持(后面改用新的方案) 修复:一些Bug #### 2023-09-15 ##### LarkXR V3.2.20.11 修复:未设置授权码时,访问8181页面,显示系统关闭一览页的消息。 修改:更新同步Task接口 修复:管理后台授权设置页面先设置加密狗后切换授权显示错误问题 修改:文字修改:开启直播推流、开启文字输入事件提示 修复:渲染服务器预启动应用退出后,后续客户端进入时无法分配 修复:渲染服务器,appliId相同,但是应用路径不一样导致的异常 #### 2023-09-11 ##### LarkXR V3.2.20.10 修复:单机版同步Task的savePath问题错误 修复:Web客户端异常提示框不显示的问题 #### 2023-09-08 ##### LarkXR V3.2.20.9 修改:启动页去除application loading显示 修改:客户端页面控制球,摇杆等控件在appSize消息事件后显示 修复:个别手机型号飞书进入应用UI层被覆盖(在websdk中修改) 修复:ios手机端飞书 从8181页面进入应用不能跳转 #### 2023-8-30 ##### LarkXR V3.2.20.8 修复鼠标悬浮按钮后样式变化问题 #### 2023-8-23 ##### LarkXR V3.2.20.6 修复重启后task不强制关闭 修复重启后预启动应用第一次使用数据通道连接失败 #### 2023-8-2 ##### LarkXR V3.2.20.2 部分bug修复 #### 2023-7-28 ##### LarkXR V3.2.20.1 调整:更换新Logo 优化:重构渲染服务器优化性能 完善:支持客户端多路视频采集输入 增加:增加与应用并发数量相匹配的设备ID管理功能用于设备授权 增加:后台启动VR应用支持传递附加参数 完善:优化后台数据统计展示及导出 增加:增加客户端样式定制功能 优化:分配策略 #### 2023-7-7 ##### LarkXR V3.2.11.9 修复Bug 更换新Logo #### 2023-6-1 ##### LarkSR V3.2.11.7 优化:客户端在iOS上输入文字时获取焦点及失去焦点的问题 修复:iOS上系统键盘不能删除输入文字的问题 修复:客户端打开虚拟键盘状态下,云端输入框聚焦 使用虚拟键盘打字(点击屏幕)会一直调起系统键盘 修复:预启动时usingCnt大于runningCnt的问题 修复:首次安装时限流初始化失败的问题(flywaydb插近初始化数据库在其他Bean实例化之后,限流Bean的初始化访问数据库失败) 修复: 手机端初始未展示盘,首次关闭虚拟键盘,圆盘自动显示问题 修复:getCandidateServerList方法内缓存取出类型强转错误的问题 完善:使用共享存储场景下可以配置只有一个同步,其他节点不同步 修改:配置Turn转发时getTask接口不返回渲染节点的IP,另外配置了外网IP的时候,不返回内外IP,主要是考虑少暴露IP #### 2023-5-19 ##### LarkSR V3.2.11.4 增加:预启动场景退出时重启应用的功能 优化:请求分配算法性能 增加:启动应用等接口增加限流功能 增加:渲染服务器增加OpenXR支持 增加:渲染服务器增加IntelGPU支持 增加:移动端中文输入虚拟键盘 修复部分Bug #### 2023-3-22 ##### LarkSR V3.2.10.0 新增:自动清除离线节点 新增:AWS S3存储类型 新增:TURN服务器转发功能 调整:数据库监控画面(druid)配置项移动到配置文件中 调整:云授权校验时间间隔从2分钟改为4分钟 修复:多管理节点时的授权码校验错误 修复:同一个任务生成多个任务订单的问题 修复:Web客户端国际化完善(静态页面)、页面增加国际化设定缓存 修复:偶发首次同步失败的问题 修复:授权码变更为通用授权,页面必须刷新才能识别的问题 修复:普通用户访问终端管理”提示没有权限的问题 #### 2023-1-10 ##### LarkSR V3.2.9.3 优化:探测外网IP抖动问题,可以继续探测获取到IP后可以再上线 优化:管理节点可以探测外网IP用于向nacos注册 优化:修改容器中机器码的获取方式 优化:键鼠映射画面增加清除自定义圆盘设置 优化:虚拟摄像头性能,提高打开关闭速度 优化:虚拟摄像头分辨率提高到1920x1080 优化:数据通道在特殊场景下会崩溃的问题 优化:增加删除所有离线节点功能 优化:授权校验服务检查集群节点数量,只检查上线节点数量 优化:Tomcat连接参数,数据库连接池参数,用于高并发 修复:部分应用获取默认麦克风设备导致客户端音频透传功能失效的问题 修复:本地存储时,agent服务访问admin节点配置adminKey的方式,同步失败的问题 修复:节点冻结后,再上线,实际并发数计算错误 修复:订单时长统计出现负数的问题 修复:独占模式下分组提示内部异常的问题 修复:多管理节点时提示未设置授权码问题 修复:清除所有的自定义键鼠设置之后,默认的圆盘不显示 修复:上传绿色免安装版转换成服务器已安装之后,进入应用提示“Application synchronize failed”的问题 修复:节点离线删除后,再上线资源监控数据显示失败的问题 #### 2022-11-15 ##### LarkSR V3.2.9.1 增加:选择调度策略的系统设置 优化:节点离线/磁盘不可访问等抖动节点监控报警发送短信通知 优化:淘宝浏览器退到后台timer失效,连接始终不端口的问题。 优化:用户并发高的时候,对附加参数表的查询会导致数据库负载过高的问题 修改:冻结节点不同步应用 修改:agent服务不再注册到nacos注册中心、去掉了检查admin服务是否注册到nacos 修复:数据通道给客户端的消息偶发丢失的问题 修复:独占模式下不能正常使用竖屏显示器的问题 修复:admin服务没启动,agent启动失败的问题 修复:使用共享存储偶发403问题 修复:管理后台配置https后需要设置允许跨域才能上传应用的bug #### 2022-09-29 ##### LarkSR V3.2.8.2 增加简易分配策略(不考虑同步,不考虑异构因子)。默认关闭 开放:/taskInfo/getRunCntAndServerCnt接口,获取服务器运行数和服务器数量 修改:升级Redisson客户端版本到3.17.6 修改:合并Auth服务和Admin服务 修改:没探测到外网IP,没有GPU型号的节点都给设为抖动状态 修复:管理节点同时也作为渲染节点和其他渲染节点组成集群,并且和渲染节点使用共享磁盘的场景, 修复:调整flywaydb插件版本 修复:不清理缓存中不存在状态上报时间的僵尸task的问题 修复:当磁盘空间不足或者共享盘连接失败的情况下,应用同步状态为1,但不能同步应用,即便恢复后当前为1的应用也不能同步,而且其他应用也不能同步的问题 修复:使用共享存储时,当有其他节点开始同步那么当前节点同步恢复到等待传输 修复:渲染服务器在极端网络状况下码率降到很低不回升的问题 修复:渲染服务器在WindowsServer-2016上的声音问题 修复:渲染节点应用不删除的问题 修复:离线节点task不清除的问题 修复:节点数多的时候(>20)节点数统计数量不正确的问题 修复:直连模式下使用ssl协议 #### 2022-08-19 ##### LarkSR V3.2.7.1 增加:直播推流功能 增加:移动端键鼠映射功能 增加:批量停止应用功能 增加:批量重启节点功能 增加:预启动自动调整启动数量的功能 增加:获取运行数量接口增加返回分组内的运行数量的处理 增加:启动管理器检查properties配置文件编码格式功能 优化:进入应用时,推流第一帧画面报错,不计费的处理 优化:依赖库版本,提升安全性 优化:删除应用相关Job的执行时间改为夜间 优化:MariaDB目录变更 修复:由于从windows复制路径导致的前面包含一个特殊不可见字符导致启动失败的问题 修复:配置OSS和OBS导致auth服务启动失败的问题 修复:绑定客户端页面分页查询出现重复数据 修复:绑定渲染服务器分页失败 修复:独占模式下指定分配节点Ip的场景下,提示渲染资源不足的问题 修复:开启保存VR监控数据时,VR性能监控画面不显示数据的问题 修复:中英文问题 修复:主节点和渲染节点共用一个nas存储触发同步问题(主节点增加配置项:pxy.storage.type.local.disk-share-node-list。 渲染节点增加配置项: pxy.storage.type.local.disk-share-with-local-center) 修复:redis中分配数量出现负值的问题 修复:Linux环境对是否本地安装应用判断错误的问题 修复:解压zip时某种情况下没返回解压失败的标识 修复:根据IP计算最近分区时如果IP解析不出城市导致异常的问题 修复:独占模式进入应用时提示GPU资源不足 #### 2022-07-22 ##### LarkSR V3.2.6.2 1)修改:共享模式下某些特殊应用会有DX和OpenGL混合渲染的情况,从而导致闪屏 2)修改:WebRTC码率参数,解决偶发画面不清晰的问题 3)修复:协同模式从控无操作权限的问题 #### 2022-06-30 ##### LarkSR V3.2.6.1 1)增加VR客户端音频输入功能 2)增加SR模式视频输入功能 3)增加自动开启和摄像头麦克风配置 4)渲染节点支持点多磁盘存储 5)增加多管理节点监控功能 6)增加Ws代理的后端心跳机制,增强推流稳定性 7)增加批量冻结/解冻结/删除节点,可通过节点名称模糊查询 8)Nacos客户端依赖升级到2.X 9)修复进入应用指定编码参数不生效的问题 10)修复使用共享存储应用下架后,再上架提示403问题 11)修复音频拦截导致的应用卡死问题 12)修复应用路径配置不正确导致渲染服务器崩溃的问题 #### 2022-05-23 ##### LarkSR V3.2.5.3 修改:前端web客户端对数据通道发送数据结尾的处理 修改:渲染服务器启动对声卡有依赖的问题 #### 2022-05-10 ##### LarkSR V3.2.5.2 1) 增加:智能语音服务 2) 增加:客户端音频输入功能,音频到云端麦克风输出 3) 增加:两种附加参数传递给三维应用的命令行传参形式(GNU长参形式和短横线形式) 4) 增加:针对附加参数中有特殊字符的场景,增加对主动编码URL参数的处理功能 5) 增加:客户端文本输入事件提示开关 6) 优化:task出错时信息来源 7) 优化:支持预启动应用参数变更 8) 优化:数据通道(字符串类型将不再包含\0长度) 9) 修复:进入应用跳转接口异常时不展示错误页面的问题 10)修复:启动管理器启用Minio服务时,auth服务启动失败问题 11)修改:安装磁盘和存储应用磁盘相同时的磁盘信息只保留一份 12)修改:中心服务器启动管理退出时停止服务的处理逻辑错误 13)修改:应用一览错误消息不提示 14)修改:下架的应用被删除,上架之后提示code403的问题 15)修复:普通用户自己修改密码后管理员再修改密码提示错误消息 16)修复:某些情况下loading文字显示不全的问题 17)修复:授权关闭水印时,资源监控画面远程桌面功能失效 18)修复:上报资源实例时,使用new File()直接获NAS存储的磁盘空间偶发延迟特别大导致节点下线的问题 19)修复:苹果浏览器错误提示消息乱码问题 #### 2022-04-20 ##### LarkSR V3.2.4.5 修改:解决预启动模式偶发卡4/5的的问题 修改:分配调度优先级变更:由原来组别>预启动>指定ip,变更为组别>指定ip>预启动 修改:预启动分配调度顺序变更:由原来按注册顺序分配,变更为随机分配 增加:并发数数据持久化功能 #### 2022-04-08 ##### LarkSR V3.2.4.4 管理服务器 1)Task管理: 修复:由异常退出(比如断电,服务器异常宕机)引发的Task关闭,Task运行结束时间为异常退出的时间。 2)应用管理: 增加:AR应用是否使用透明遮罩设置 增加:服务后台管理运行中的应用功能 优化:添加修改应用时鼠标操作指令默认值为鼠标模式,并修改触碰模式的值为touch 修复:更新本地安装的程序包时提示“zipFile is not null”的问题 修复:以zip格式解压后,抛出异常再以7z的格式解压一遍 修复:更新应用封面图提示“server error”的问题 修复:存储类型为华为OBS,上传失败的bug,同步失败Bug 3)集群应用同步分发、删除逻辑 增加:支持共享NAS存储 增加:使用NAS时获取剩余存储空间的方法 增加:半主动同步功能,对于并发量访问不高的应用,降低同步应用的磁盘空间占用 修复:清除已经不存在同步Task的应用程序包时,无论节点是否在线,已存在的同步应用都需要被视有用的 修复:获取syncTask失败时删除应用的Bug 修复:应用下架,同步task没有删除,应用被删除的Bug 4)分配调度: 增加:智能语音对话授权检查及应用是否启用智能语音服务 增加:客户端成功启动应用(播放服务端视频流)的通知接口 优化:计算最近分区时,在已经同步的分区中进行选择 修复:分配节点时,排除没有同步记录的节点 5)系统设定: 增加:内外网流媒体端口映射功能(仅用于UDP端口,路由器端口不一致的情况) 修复:加密狗设置显示水印失败问题 6)配置项: 增加:解压后是否删除Zip文件的处理及配置开关 增加:智能语音服务的返回音频格式、是否分片返给数据通道的配置 修改:pxy.render-server.listen-port和pxy.render-server.ssl-port配置名称 7)区域管理 增加:设置定向分区功能,可指定多个用户 修复:渲染服务停止,该区域所有节点都下线,区域不执行删除的bug 修复:后台直接删除区域,提示“内部异常”的bug 8)增加:Jdk1.9+关于Spring-beans*.jar的漏洞补丁(Spring RCE 0day) Web客户端 1) 修复 iframeposter 日志问题 2) 修复背景颜色设置失效问题 3) 修复互动模式左上角分享 URL问题 WebSDK 1)添加智能语音相关接口支持 2)动态设置是否强制横屏显示内容 **渲染服务器** 1)增加智能语音服务 2)增加数据通道智能语音回调 3)增加预启动类型应用通知 4)提高opengl采集稳定性 5)修复某些环境,独占模式会卡5/5的问题 #### 2022-01-26 ##### LarkSR V3.2.3.0 增加像素流送的渲染类型 增加执行文件列表存储,以便于编辑时可重新选择 增加分区内同步开关,修改agent关于同步的配置项 Web客户端使用WebSDK重构 Web客户端增加task相关信息的抛出 优化上传应用,直观看出剩余时间,当前传输速率 修复第一次输入验证码总提示错误的bug 修复iOS平台断开重连播放声音提示框的Bug #### 2021-12-21 ##### LarkSR V3.2.1.2 Log4j2版本 2.15.0升级到2.17.0 #### 2021-12-14 ##### LarkSR V3.2.1.1 服务端: 修复封面图上传到oss相关Bug:开放公共读访问权限、可上传jpg格式图片、修改图片链接以http开头 /client/search接口增加组别名称返回值 接口[/sysSetting/uploadCustomizeStartLogo]的返回值从message改为result 修复集群分区域部署,使用对象存储时,同步异常的问题 修复Log4j2 远程执行代码漏洞 #### 2021-12-06 ##### LarkSR V3.2.0.7 服务端: 修复:三方接口上传图片和上传应用的跨越问题 修复:单机版本地存储更新应用和更换ip时,进入应用一直显示同步中的问题 修复:使用加密狗授权时提示“Data Error: licence type invalid.”的错误 修复:达到应用最大并发数时提示“can't parse argument number”的问题 修复:多显卡时,其中一个显卡达到阈值,提示渲染资源不足的问题 修复:安卓微信浏览器偶发没有声音的问题 修复:上传大文件登录失效的问题 优化:资源不足的阈值可自定义,并友好提示“资源使用率以达到设置的阈值” 优化:中心管理节点启动时自动添加本机IP网段为白名单,无需在管理后台添加 优化:升级Oshi依赖库支持Windows11 增加:预启动的禁用功能 增加:移动端的手柄圆盘默认底图的修改 增加:控制球背景图的修改(需授权中同意开启) 渲染服务器: 修复:类似QT应用多层嵌套窗体传递鼠标消息的处理逻辑 修复:多卡环境下d3d应用由于对显卡设备重排序导致多显卡分配失败的问题 修复:预启动应用卡4/5的问题(修复帧率获取失败) 优化:应用命令行参数过长导致SR应用崩溃的问题 优化:数据通道SDK接口,增加对预启动应用的TaskId传递方法 增加:第三方客户端接入协议 #### 2021-10-23 ##### LarkSR V3.2.0.6 3.1系列升级到3.2系列 1. 系统进行重大架构及部署方式的调整,支持高可用部署 2. 数据库升级到MariaDB-10.5.10 3. 增加大应用的预启动功能 4. 优化应用的存储方案(支持本地存储、Minio存储、阿里云OSS存储、华为云OBS存储) 5. 优化渲染节点的应用同步功能。 6. 增加了定制Logo的设置功能 7. 增加了渲染服务器资源使用率监控数据 8. 增加了访问控制的黑白名单功能,方便系统集成 9. 增加了后台操作审计日志,升级了第三方依赖库,修复安全漏洞 10. 增加鼠标样式同步功能 11. 增加渲染节点冻结功能 12. 增加上传接口的访问控制方式 13. 完善RTT探测功能 14. 增加距离分配请求的策略 15. 完善客户区分的管理权限
pxy_js
2025年3月12日 15:05
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
开发者交流群
QQ群号:1011308692
Markdown文件
Word文件
PDF文档
PDF文档(打印)
分享
链接
类型
密码
更新密码
有效期