错误码

概述

错误码是软硬件系统在安装、运行过程中发生错误时，给操作者返回的错误代码信息。

在DTS数字孪生平台的使用和运维过程中，会涉及到如下的错误码：

• 业务错误码：用户在进行业务操作时，控制台界面上报的错误码。

错误码格式

错误码信息一般由错误编号和错误描述组成。

分类

| 错误码列表 | 软件许可业务 | 数据处理业务 | 三维渲染业务 | 云服务业务 | 二次开发业务 |

提示： 可通过“CTRL+F”唤出在页面中查找功能，快速定位错误码。

错误码列表

软件许可错误码列表

数据处理错误码列表

三维渲染错误码列表

云服务错误码列表

云服务客户端错误码列表

实例管理接口错误码列表

二次开发错误码

软件许可业务错误码

200：本机没有许可。

错误码描述

本机没有使用DTS软件的许可。

可能原因

本机没有申请授权或未配置共享其他电脑的授权。

处理建议

参照申请许可的视频说明：

https://www.bilibili.com/video/BV1vu41147W4/?spm\_id\_from=333.999.0.0

211：没有发现许可，已经达到最大的用户数。

错误码描述

DTS软件使用数超过许可数。

可能原因

• Explore程序未完全退出，又起了一个Explore；

• Cloud使用的并发数超过了能使用的许可认证数；

• 本机开启了授权共享，授权被其他机器占用。

处理建议

增加许可数或者减少软件使用数量。

100001 本机许可将要过期

错误码描述

DTS软件许可即将到期。

可能原因

授权时间即将到达时限。

处理建议

步骤1 点击“继续使用”。

步骤2 获取新的授权。

35：本机许可已过期

错误码描述

许可已经过期。

可能原因

授权时间已到达时限。

处理建议

获取新的授权。

38：本机许可被锁定

错误码描述

许可被锁定。

可能原因

机器上有反编译程序或者破解补丁触发加密系统保护机制，造成许可被锁定。

处理建议

获取新的授权。

机器信息不匹配

错误码描述

许可和机器信息不一致。

可能原因

试用许可是和机器绑定的，导出的机器信息和最终使用许可的机器不一致。

处理建议

导出本机的机器信息重新授权，在授权面板重新导入。

数据处理业务错误码

以下是根据您提供的错误码整理的标准化格式：

0：正确

错误码描述

操作成功完成。

可能原因

无错误。

处理建议

无需处理。

1：参数错误

错误码描述

参数错误，发布数据错误。

可能原因

数据发布的参数设置错误。

处理建议

请检查参数设置。

2：不支持此类型

错误码描述

不支持当前数据类型。

可能原因

输入的数据类型不符合要求。

处理建议

检查数据类型是否符合规范。

3：创建3dt文件失败

错误码描述

创建3dt文件时发生错误。

可能原因

文件生成过程中出现异常。

处理建议

检查文件路径和权限，确保有足够的存储空间。

4：读文件失败

错误码描述

读取文件时发生错误。

可能原因

文件损坏、路径错误或权限不足。

处理建议

检查文件是否存在且可读。

5：文件内容错误

错误码描述

文件内容不符合预期格式。

可能原因

文件被篡改或格式不正确。

处理建议

验证文件内容的完整性。

6：GDAL初始化失败

错误码描述

GDAL库初始化失败。

可能原因

GDAL环境未正确配置或依赖缺失。

处理建议

检查GDAL安装和环境变量配置。

7：文件未找到

错误码描述

指定的文件不存在。

可能原因

文件路径错误或文件被删除。

处理建议

确认文件路径是否正确。

8：没有一个文件是合法的

错误码描述

所有输入文件均无效。

可能原因

文件格式错误或内容不合法。

处理建议

检查文件是否符合要求。

9：模型的包围盒大小出错

错误码描述

模型包围盒尺寸异常。

可能原因

模型数据错误或坐标系问题。

处理建议

检查模型数据和坐标系设置。

10：模型的包围盒大小出错

错误码描述

模型包围盒尺寸异常。

可能原因

模型数据错误或坐标系问题。

处理建议

检查模型数据和坐标系设置。

11：发布根3dt失败

错误码描述

发布根3dt文件时失败。

可能原因

数据生成或权限问题。

处理建议

检查输出目录权限和存储空间。

12：发布子3dt失败

错误码描述

发布子3dt文件时失败。

可能原因

数据生成或权限问题。

处理建议

检查输出目录权限和存储空间。

13：obmxsdk权限或内部错误

错误码描述

obmxsdk权限或内部错误。

可能原因

SDK权限不足或内部异常。

处理建议

检查SDK权限和日志以定位问题。

14：Tile被整个裁切掉了

错误码描述

Tile数据被完全裁切。

可能原因

裁切范围设置错误。

处理建议

调整裁切范围或检查数据。

100：模型创建lod失败，面数化简为0

错误码描述

模型LOD创建失败，面数简化为0。

可能原因

模型数据错误或LOD参数设置不当。

处理建议

检查模型数据和LOD参数。

101：创建lod后模型错误

错误码描述

创建LOD后模型数据错误。

可能原因

LOD生成过程中数据损坏。

处理建议

重新生成LOD或检查原始模型。

102：创建lod时计算法向后模型错误

错误码描述

计算法向后模型数据错误。

可能原因

法向计算过程中数据异常。

处理建议

检查模型数据完整性。

103：创建osgblod输入目录错误

错误码描述

输入目录错误。

可能原因

目录路径无效或权限不足。

处理建议

检查目录路径和权限。

104：创建osgblod时未找到osgb或osg文件

错误码描述

未找到osgb或osg文件。

可能原因

文件缺失或路径错误。

处理建议

确认文件路径和名称是否正确。

105：创建lod时生成atlas图失败

错误码描述

生成atlas图失败。

可能原因

纹理或模型数据错误。

处理建议

检查模型和纹理数据。

106：创建osgblod时模型按包围盒被切割没了

错误码描述

模型被包围盒切割后无有效数据。

可能原因

包围盒设置错误或模型数据异常。

处理建议

调整包围盒或检查模型数据。

107：创建osgblod时模型时模型包围盒出错

错误码描述

模型包围盒错误。

可能原因

模型数据或坐标系问题。

处理建议

检查模型数据和坐标系设置。

108：创建osgblod时根节点找不到

错误码描述

未找到根节点。

可能原因

模型数据结构错误。

处理建议

检查模型数据的完整性。

109：创建osgblod时没有符合条件的模型

错误码描述

无符合条件的模型。

可能原因

过滤条件设置过严或数据错误。

处理建议

调整过滤条件或检查数据。

110：创建osgblod时真实模型被切没了

错误码描述

真实模型被裁切后无有效数据。

可能原因

裁切范围设置错误。

处理建议

调整裁切范围或检查模型数据。

111：创建osgblod时根节点对应模型为空

错误码描述

根节点对应的模型为空。

可能原因

模型数据错误或生成异常。

处理建议

检查模型数据的生成过程。

112：创建osgblod时创建lod失败

错误码描述

创建LOD失败。

可能原因

模型数据或参数错误。

处理建议

检查模型数据和LOD参数。

113：创建osgblod时获取底层真正生成模型失败

错误码描述

获取底层模型失败。

可能原因

模型生成过程中出现异常。

处理建议

检查模型生成日志和参数。

114：生成3dt文件时出错

错误码描述

生成3dt文件时出错。

可能原因

文件生成过程中出现异常。

处理建议

检查文件路径和权限。

115：模型体素化失败

错误码描述

模型体素化失败。

可能原因

模型数据或参数错误。

处理建议

检查模型数据和体素化参数。

116：创建osgblod时,没有一个模型有合法的包围盒

错误码描述

所有模型包围盒均无效。

可能原因

模型数据或坐标系问题。

处理建议

检查模型数据和坐标系设置。

117：创建osgblod时,建树失败

错误码描述

构建树结构失败。

可能原因

模型数据或生成参数错误。

处理建议

检查模型数据和生成参数。

200：输出路径为空

错误码描述

输出路径未设置。

可能原因

参数缺失或为空。

处理建议

设置有效的输出路径。

201：影像路径为空

错误码描述

影像路径未设置。

可能原因

参数缺失或为空。

处理建议

设置有效的影像路径。

202：地形数据解析初始化失败

错误码描述

地形数据解析初始化失败。

可能原因

数据格式错误或解析异常。

处理建议

检查地形数据格式和完整性。

203：请检查dem的投影坐标系

错误码描述

DEM的投影坐标系可能错误。

可能原因

坐标系设置不当或数据问题。

处理建议

检查DEM的投影坐标系设置。

204：请确保dem没有偏移

错误码描述

DEM数据存在偏移。

可能原因

数据生成或处理过程中出现偏移。

处理建议

检查DEM数据的偏移情况。

205：请确保dem没有缩放

错误码描述

DEM数据存在缩放。

可能原因

数据生成或处理过程中出现缩放。

处理建议

检查DEM数据的缩放情况。

206：提供的dem被shp切没了

错误码描述

DEM数据被SHP裁切后无有效数据。

可能原因

裁切范围设置错误，或坐标系不统一。

处理建议

调整裁切范围或检查数据坐标系。

207：dem数据通道为0无法读取

错误码描述

DEM数据通道为0，无法读取。

可能原因

数据格式错误或损坏。

处理建议

检查DEM数据的完整性和格式。

208：dem数据包围盒错误

错误码描述

DEM数据包围盒错误。

可能原因

数据生成或坐标系问题。

处理建议

检查DEM数据和坐标系设置。

209：dem数据包围盒过小，请检查是否为投影坐标系

错误码描述

DEM包围盒过小，可能为地理坐标系。

可能原因

坐标系设置错误，不是投影坐标系。

处理建议

检查DEM的坐标系是否为投影坐标系。

210：未找到dom数据，请检查dom路径

错误码描述

未找到DOM影像数据。

可能原因

路径错误或文件缺失。

处理建议

检查DOM路径和文件是否存在。

211：未找到dem数据，请检查dem路径

错误码描述

未找到DEM高程数据。

可能原因

路径错误或文件缺失。

处理建议

检查DEM路径和文件是否存在。

212：dom数据包围盒错误

错误码描述

DOM数据包围盒错误。

可能原因

数据生成或坐标系问题。

处理建议

检查DOM数据和坐标系设置。

213：dom数据包围盒过小，请检查是否为投影坐标系

错误码描述

DOM包围盒过小，可能为地理坐标系。

可能原因

坐标系设置错误。

处理建议

检查DOM的坐标系是否为投影坐标系。

214：最终几何模型包围盒错误

错误码描述

最终几何模型包围盒错误。

可能原因

数据生成或坐标系问题。

处理建议

检查模型数据和坐标系设置。

215：最终几何模型包围盒长或宽小于100米，请检查是否为投影坐标系

错误码描述

模型包围盒过小，可能为地理坐标系。

可能原因

坐标系设置错误。

处理建议

检查模型的坐标系是否为投影坐标系。

216：dom和dem没有重叠区域，请检查两者坐标系

错误码描述

DOM和DEM无重叠区域。

可能原因

坐标系不一致或数据范围错误。

处理建议

检查DOM和DEM的坐标系和数据范围。

217：数据包围盒被外切线切没了，请检查数据和切线

错误码描述

数据被外切线裁切后无有效数据。

可能原因

切线设置错误或数据范围问题。

处理建议

调整切线或检查数据范围。

218：没有新增数据，无需重新发布

错误码描述

无新增数据，无需发布。

可能原因

数据未更新。

处理建议

确认是否有新增数据需要发布。

219：没有新增数据，无需重新发布

错误码描述

无新增数据，无需发布。

可能原因

数据未更新。

处理建议

确认是否有新增数据需要发布。

220：原数据发布失败，无法增量发布，请清空输出目录或选择新的输出目录

错误码描述

原数据发布失败，无法增量发布。

可能原因

原数据发布异常。

处理建议

清空输出目录或选择新的输出目录。

221：任务分配文件不存在，请勿删除输出目录下的临时文件

错误码描述

任务分配文件缺失。

可能原因

临时文件被删除。

处理建议

勿删除输出目录下的临时文件。

222：地形发布根节点为空，发布失败

错误码描述

地形发布根节点为空。

可能原因

数据生成异常。

处理建议

检查地形数据的生成过程。

223：获取单幅dom数据时失败

错误码描述

获取单幅DOM数据失败。

可能原因

数据读取异常。

处理建议

检查DOM数据的完整性和路径。

224：模型贴图x方向大小错误

错误码描述

模型贴图X方向大小错误。

可能原因

贴图尺寸不符合要求。

处理建议

检查贴图尺寸设置。

225：模型贴图y方向大小错误

错误码描述

模型贴图Y方向大小错误。

可能原因

贴图尺寸不符合要求。

处理建议

检查贴图尺寸设置。

226：dem文件打不开

错误码描述

DEM文件无法打开。

可能原因

文件损坏或权限不足。

处理建议

检查文件完整性和权限。

227：dem的X方向大于2万公里，请检查dem坐标系

错误码描述

DEM的X方向范围过大。

可能原因

坐标系设置错误。

处理建议

检查DEM的坐标系是否为投影坐标系。

228：dom的X方向大于2万公里，请检查dom坐标系

错误码描述

DOM的X方向范围过大。

可能原因

坐标系设置错误。

处理建议

检查DOM的坐标系是否为投影坐标系。

229：shp文件X方向大于2万公里，请检查shp文件坐标系

错误码描述

SHP文件的X方向范围过大。

可能原因

坐标系设置错误。

处理建议

检查SHP文件的坐标系是否为投影坐标系。

230：shp文件数据类型不支持

错误码描述

不支持的SHP文件数据类型。

可能原因

数据类型不符合要求。

处理建议

检查SHP文件的数据类型。

231：dem文件数据类型不支持

错误码描述

不支持的DEM文件数据类型。

可能原因

数据类型不符合要求。

处理建议

检查DEM文件的数据类型。

232：dom文件数据类型不支持

错误码描述

不支持的DOM文件数据类型。

可能原因

数据类型不符合要求。

处理建议

检查DOM文件的数据类型。

233：道路与地形无交集，无需发布道路模型

错误码描述

道路与地形无交集。

可能原因

数据范围或坐标系不一致。

处理建议

检查道路和地形的数据范围和坐标系。

234：发地形时，建树失败

错误码描述

地形建树失败。

可能原因

数据生成异常。

处理建议

检查地形数据的生成过程。

235：发地形时，解析临时文件失败

错误码描述

解析地形临时文件失败。

可能原因

文件损坏或格式错误。

处理建议

检查临时文件的完整性和格式。

236：发地形时，创建根3dt失败

错误码描述

创建地形根3dt失败。

可能原因

数据生成异常。

处理建议

检查地形数据的生成过程。

237：发地形时，创建子3dt失败

错误码描述

创建地形子3dt失败。

可能原因

数据生成异常。

处理建议

检查地形数据的生成过程。

238：外裁路径不存在

错误码描述

外裁路径不存在。

可能原因

路径错误或未设置。

处理建议

检查外裁路径设置。

239：模型的坐标或半径大于2万公里，请检查模型坐标和大小

错误码描述

模型坐标或半径过大。

可能原因

坐标系设置错误或模型尺寸异常。

处理建议

检查模型的坐标系和尺寸。

240：没有符合条件的dom

错误码描述

无符合条件的DOM数据。

可能原因

数据范围或过滤条件问题。

处理建议

检查DOM数据范围和过滤条件。

241：shp文件的颜色字段设置错误，请检查-shpColorFieldName=是否正确

错误码描述

SHP文件颜色字段设置错误。

可能原因

参数设置错误或字段不存在。

处理建议

检查-shpColorFieldName参数设置。

242：dtm文件数据类型不支持

错误码描述

不支持的DTM文件数据类型。

可能原因

数据类型不符合要求。

处理建议

检查DTM文件的数据类型。

243：dtm的json文件读取失败

错误码描述

DTM的JSON文件读取失败。

可能原因

文件损坏或格式错误。

处理建议

检查JSON文件的完整性和格式。

244：海洋范围的shp文件读取失败

错误码描述

海洋范围SHP文件读取失败。

可能原因

文件损坏或格式错误。

处理建议

检查SHP文件的完整性和格式。

245：河水与地形无交集，无需发布河水模型

错误码描述

河水与地形无交集。

可能原因

数据范围或坐标系不一致。

处理建议

检查河水和地形的数据范围和坐标系。

300：资源的dem的路径为空

错误码描述

资源DEM路径未设置。

可能原因

参数缺失或为空。

处理建议

设置有效的DEM路径。

301：发布资源时，读取shp文件结果为空

错误码描述

读取资源SHP文件结果为空。

可能原因

文件内容为空或读取异常。

处理建议

检查SHP文件内容和路径。

302：发布资源时，读取资源信息失败

错误码描述

读取资源信息失败。

可能原因

文件损坏或格式错误。

处理建议

检查资源文件的完整性和格式。

400：找不到源坐标系或者目标坐标系

错误码描述

未找到源或目标坐标系。

可能原因

坐标系名称错误或未定义。

处理建议

检查坐标系名称和定义。

401：源坐标系初始化失败，不能识别

错误码描述

源坐标系初始化失败。

可能原因

坐标系定义错误或格式不支持。

处理建议

检查源坐标系的定义和格式。

402：目标坐标系初始化失败，不能识别

错误码描述

目标坐标系初始化失败。

可能原因

坐标系定义错误或格式不支持。

处理建议

检查目标坐标系的定义和格式。

403：无法从源坐标系转换到目标坐标系

错误码描述

坐标系转换失败。

可能原因

坐标系不兼容或转换参数错误。

处理建议

检查坐标系兼容性和转换参数。

404：无法将转换中心点从源坐标系转换到目标坐标系

错误码描述

转换中心点坐标系转换失败。

可能原因

中心点坐标或坐标系问题。

处理建议

检查中心点坐标和坐标系设置。

405：无法将模型数据从源坐标系转换到目标坐标系

错误码描述

模型数据坐标系转换失败。

可能原因

模型数据或坐标系问题。

处理建议

检查模型数据和坐标系设置。

500：vtpk中找不到支持类型的数据

错误码描述

VTPK中无支持的数据类型。

可能原因

数据格式不符合要求。

处理建议

检查VTPK数据格式。

501：vtpk中的json文件无法解析

错误码描述

VTPK的JSON文件解析失败。

可能原因

文件损坏或格式错误。

处理建议

检查JSON文件的完整性和格式。

502：vtpk未生成有效数据，发布失败

错误码描述

VTPK未生成有效数据。

可能原因

数据生成异常。

处理建议

检查VTPK数据的生成过程。

600：dem优化失败

错误码描述

DEM优化失败。

可能原因

数据或参数问题。

处理建议

检查DEM数据和优化参数。

65535：未定义的错误码

错误码描述

未定义的错误码。

可能原因

未知错误或未分类错误。

处理建议

联系技术支持并提供详细日志。

三维渲染业务错误码

1：Invalid_Param

错误码描述

Invalid_Param 非法参数

可能原因

非法参数，例如送入的3dt路径为非法字符组成的无意义路径。

处理建议

检查参数的正确性。

2：Layer_Already_Exist

错误码描述

Layer_Already_Exist 图层已存在。

可能原因

图层已存在，试图多次添加同一3dt文件。

处理建议

检查3DT是否已经添加成功。

3：LocalFile_NotExist

错误码描述

LocalFile_NotExist 文件不存在

可能原因

文件不存在

处理建议

需要验证3dt文件是否存在。

4：FileKey_NotSupport

错误码描述

FileKey_NotSupport 密钥不匹配

可能原因

密钥不匹配

处理建议

3dt文件发布的授权与当前运行环境授权不一致，调整授权环境状态后数据重发。

5：FileFormat_NotSupport

错误码描述

FileFormat_NotSupport 文件格式不支持。

可能原因

不是合法3dt文件格式。

处理建议

请检查数据格式。

6：AvailableScene_NotExist

错误码描述

AvailableScene_NotExist 文件中无可用场景

可能原因

3dt文件中无可用场景。

处理建议

3dt文件中无可用场景，常出现在美工3dt中，需注意按照相应规范，进行数据重发。

7：FileCorrupted

错误码描述

FileCorrupted 文件已损毁

可能原因

文件已损毁

处理建议

通常情况出现在频繁数据拷贝的情形下，可追溯文件来源，找到未损坏版本或进行数据重新处理

8：NeedPrefessinalLicense

错误码描述

NeedPrefessinalLicense 需要专业版授权

可能原因

需要专业版授权，标准版不支持。

处理建议

建议升级授权等级。

9：ExceedStandardQuota

错误码描述

ExceedStandardQuota 超出标准版配额

可能原因

超出标准版配额。

处理建议

建议升级授权等级。

10：NetworkTimeOut

错误码描述

NetworkTimeOut 连接网络3DT服务超时

可能原因

服务相关网络环境及配置错误。

处理建议

建议检测服务相关网络环境及配置。

云服务业务错误码

Cloud在连接视频流的时候，由于某种原因，可能会连接失败，如果在初始化DigitalTwinPlayer的时候，指定了{ui: startupInfo: true} ，则会在页面上显示错误代码及简单的错误原因，例如：

下面详细介绍Cloud云服务可能收到的错误代码及原因。

客户端业务错误码

Cloud在连接视频流的时候，由于某种原因，可能会连接失败，如果在初始化DigitalTwinPlayer的时候，指定了{ui: startupInfo: true} ，则会在页面上显示错误代码及简单的错误原因，例如：

下面详细介绍Cloud可能收到的错误代码及原因。

1006: abnormal

错误码描述

异常关闭

可能原因

用于期望收到状态码时连接非正常关闭，也就是说没有发送关闭帧。一般非正常的情况比较复杂，例如websocket 连接在nginx 配置的 proxy_read_timeout 内没有收到数据，nginx主动发起的连接断开（不是客户端主动断开，也不是服务端主动断开的）

处理建议

尝试重新链接。

1008 : invalid_message

错误码描述

无效的消息

可能原因

在调用实例管理接口时，发送了错误的数据格式，导致服务端对数据的解析失败时，便会收到此类型的错误。

处理建议

检查发送的消息格式是否正确。

4000 : out_of_control

错误码描述

不受控制

可能原因

Cloud的每个实例都是由NodeService进程维护的（包括启动、停止、设置参数等），如果NodeService进程异常退出，此时再调用实例管理接口对实例进行启动、停止等操作时，便会收到4000的错误。

处理建议

检查NodeService进程是否异常退出，如果退出，尝试重新启动。

4001 : instance_disconnected

错误码描述

实例断开

可能原因

客户端已正常连接上视频流，在浏览的过程中，实例异常退出，此时客户端便会收到此错误。

处理建议

稍候尝试重新连接。

4002 : instance_not_found

错误码描述

实例未找到

可能原因

客户端在向服务器请求连接指定实例的视频流时，服务器未找到指定的实例，客户端便会收到此错误。例如：

处理建议

检查指定的实例ID是否有效。

4003 : instance_start_failed

错误码描述

实例启动失败

可能原因

客户端连接视频流时，分配的实例尚未启动，在实例启动过程中，由于某些原因启动失败，客户端便会收到此错误。关于实例启动的错误代码，请参考下面的内容。

处理建议

根据具体错误码进行处理。

4004 : webrtc_connection_error

错误码描述

WebRTC连接失败

可能原因

客户端连接视频流时，WebRTC协商失败（可能的原因：浏览器版本太低、浏览器不支持H264视频解码等），服务器便会向客户端发送此错误码。

处理建议

升级浏览器版本。

4005 : one_client_allowed

错误码描述

只允许一个客户端连接

可能原因

如果实例设置了只允许一个客户端访问，当第2个客户端连接的时候就会收到此错误码。

处理建议

步骤1 关闭之前打开的浏览器连接然后重连；

步骤2 修改CloudMaster里的实例配置 。

4006 : timeout

错误码描述

超时

可能原因

当客户端连接视频流时，如果分配的实例尚未启动，便会临时启动，客户端会等待实例启动后继续连接，如果30秒内实例尚未启动成功，客户端便会收到超时的错误码而断开连接。

实例之所以30秒内尚未启动的原因可能有：

• 由于加载的工程巨大，导致30秒内尚未加载完成；

• 实例启动过程中由于BUG导致进程卡死；

• 实例启动过程中由于某种原因弹出来模态对话框（例如：授权到期的提示框、进程崩溃的提示框等）

处理建议

步骤1 重新刷新浏览器。

步骤2 调试运行，看看渲染进程是否打开工程的时候卡在某个阶段了。

4007 : iid_required

错误码描述

必须指定iid参数

可能原因

Cloud的连接分两种：带视频流的WebRTC连接和不带视频流的WebRTC连接。

带视频流的连接，可以不用指定iid参数，服务器会自动分配可用的实例给客户端。

对于不带视频流的连接，必须指定iid参数，也就是说必须明确指定要连接哪个实例。如果没有指定iid参数，便会收到此错误码。

处理建议

传送链接附带IID参数。

4008 : locked

错误码描述

实例已锁定

可能原因

在调用实例管理接口对实例进行切换工程文件（acp）操作时（实例管理接口：SetInstanceParams），如果实例已设置为锁定工程， 便会收到此错误码。 因为客户端无法对已锁定的实例进行切换工程的操作。

要规避此错误，要么选择一个未锁定的实例，要么先对实例进行解锁操作。

处理建议

取消实例锁定，或者换一个未锁定工程的实例。

4009 : invalid_project

错误码描述

工程无效

可能原因

当客户端指定了一个CloudMaster工程列表里不存在的pid参数时，便会收到此错误码。

也就是说初始化DigitalTwinPlayer时指定的pid参数，必须是工程列表里已存在的工程ID。

!

处理建议

检查指定的工程是否有效。

4010 : no_free_instance

错误码描述

无可用实例

可能原因

客户端连接视频流时 ，如果没有指定iid参数，服务器会自动分配当前可用的实例， 当没有可用的实例分配时，便会断卡客户端连接.

服务器的自动分配策略如下：

• 已启动、没有连接、非正忙的实例

• 未启动（优先查找未启动的，因为一个页面同时初始化2个视频流时，如果先查找正在启动的，会导致2个连接同一个实例）

• 正在启动的实例

• 查找不限制连接数的实例

• 未锁定的实例（可以切换工程的）

• 如果上面的条件都不满足，就返回正忙的实力，让用户选择是否手动重启

处理建议

步骤1 增加实例数（比如升级显卡、增加显卡等）

步骤2 取消实例锁定

步骤3 尝试刷新浏览器

4100 : kicked

错误码描述

实例被踢出

可能原因

通过CloudMaster的“实例管理”或者“连接信息”右键菜单断开用户连接， 或者通过实例管理接口二次开发断开用户连接时， 客户端便会收到此错误码。

处理建议

刷新浏览器

4101 : syncing_data

错误码描述

正在同步数据

可能原因

服务器正在进行数据同步操作，此时客户端去连接，便会收到此错误码。

数据同步的过程中是不接受客户端连接的。

处理建议

等待数据同步结束。

4102 : instance_killed_by_user

错误码描述

实例被用户终止

可能原因：

实例的断开有正常断开和异常退出2种情况。 4102属于正常退出，是用户主动停止实例的运行， 主要发生在以下几种情况：

• 通过CloudMaster或者调用实例管理接口 停止实例运行

• 通过CloudMaster修改正在运行的实例的IID，也会发送此错误码

  处理建议

刷新浏览器。

4103 : invalid_password

错误码描述

无效的密码

可能原因

每个实例都可以在高级参数里设置一个访问密码，如果设置了访问密码，客户端在初始化DigitalTwinPlayer的时候需要指定password属性，如果未指定或者密码错误，便会收到此错误码。

处理建议

检查指定的密码是否正确。

4105 : nodeservice_stopped

错误码描述

NodeService已停止

可能原因

客户端在连接上视频流正常浏览的过程中，通过CloudMaster停止服务， 客户端便会收到此错误码。

处理建议

重新启动服务即可。

4107 : instance_is_busy

错误码描述：

实例正忙

可能原因：

客户端连接上视频流后，如果后台渲染进程正在执行一个比较耗时（主线程执行超过3秒）的接口调用，客户端便会收到此错误码。

处理建议

等待响应或重启实例。

4108 : ip_no_access

错误码描述：

IP没有权限

可能原因：

在使用白名单功能时，Token过期时间到了以后，刷新页面重连的时候，如果不通过验证服务器而直接连CIM服务器，会出现“4108 没有授权”的错误提示。

./media/image14.png

C:\8F9C6225\F718C03D-C7B9-472D-812F-F2D1508F8770.files\image008.png

在Token有效期内，刷新页面直连CIM服务器没有问题。

处理建议

重新通过验证服务器授权。

4109 : unknown_client

错误码描述：

无效的客户端

可能原因：

Cloud服务器有3种类型的客户端连接: Manager、Streamer、Player

• Manager：管理者，又分3种：CloudMaster、NodeService，普通的实例管理功能二次开发

• Streamer：渲染进程

• Player：客户端（浏览器）

实例管理接口的二次开发在连接websocket的时候，必须使用如下的URL: ws://ip:port/manager，也就是说必须指定/manager，如果未指定或者指定了一个别的类型，便会连接失败，收到此错误码。

处理建议

链接WebSocket时，指定如下格式的URL：ws://ip:port/manager

4110 : num_of_instances_exceeded

错误码描述：

超出可访问的实例数

可能原因：

CloudMaster可设置一个客户端能同时访问多少个实例，当访问的实例个数超过设置的值时，便会收到此类型的错误。

处理建议

关闭其他链接，减少访问的客户端数量。或修改实例同时访问的链接数限制。

4111 : instance_not_auth

错误码描述：

实例未授权

可能原因：

客户端在连接linux平台的渲染服务器时，如果所分配的实例未授权，此客户端无法连接，同时收到此错误码。

处理建议

检查当前实例的授权。并且检查软授权连接数是否超过设置。

4112 : permission_denied

错误码描述：

没有权限

可能原因：

CloudMaster的新版本增加了客户端的授权机制

如果开启了此功能，当客户端初始化DigitalTwinPlayer连接CloudServer的时候就会进行授权检查，如果检查通过，可继续连接， 如果检查不通过（未授权），则连接会断开。

当勾选“启动客户端访问授权”后，访问视频流页面出现上图所示的4112错误时，可能的原因：

• 初始化DigitalTwinPlayer的时候，没有在urlExtralInfo里设置uid属性；

• 用户的后台系统没有调用实例管理接口添加客户端通行许可。

处理建议

清空配置文件。

4113 : instance_was_preempted

错误码描述

实例被抢占

可能原因

当一个浏览器客户端连接上一个未锁定的实例正在浏览云渲染的时候，另一个客户端把此实例切换到另外一个工程， 先前的客户端便会收到4113（实例被抢占）的错误码提示。

处理建议

增加可以供多个用户浏览的实例。

或锁定之前浏览的工程，避免其他人切换。

实例管理接口业务错误码

1 : PermissionDenied

错误码描述

没有权限

可能原因

实例管理接口需要权限才能调用，如果没有权限，就会收到此错误。

处理建议

检查是否拥有权限。

2 : NoFreeInstance

错误码描述

没有空闲实例

可能原因

发生于实例管理接口的调用。

当调用实例管理接口获取一个空闲的实例时，如果此时没有空闲实例，便会返回此错误码。

处理建议

稍后重试。

3 : InstanceNotFound

错误码描述

实例未找到

可能原因

当调用实例管理接口对指定实例进行操作时（启动、停止、设置参数等），如果服务器未找到指定的实例，就会返回此错误码。

处理建议

检查参数是否正确

4 : InstanceNotRunning

错误码描述

实例未运行

可能原因

尚未使用

处理建议

重启软件。

5 : InvalidParameters

错误码描述

无效参数

可能原因

当通过CloudMaster修改实例ID时，如果传递的参数无效，就会收到此错误码。

处理建议

检查参数是否正确。

6 : ManagerNotFound

错误码描述

没有找到实例的宿主

可能原因

Cloud的每个实例都是由NodeService进程维护的（包括启动、停止、设置参数等），如果NodeService进程异常退出，此时再调用实例管理接口对实例进行启动、停止等操作时，便会收到此错误码。

处理建议

重新启动NodeService进程。

7 : PlayerNotFound

错误码描述

未找到Player

可能原因

在调用实例管理接口提出客户端时，如果指定的客户端不存在，就会收到此错误码。

处理建议

检查参数是否正确。

8 : Failed

错误码描述

失败

可能原因

实例管理接口调用失败

处理建议

步骤1 检查参数是否正确；

步骤2 检查工程是否同步成功。

9 : InstanceNotAuthorized

错误码描述

实例未授权

可能原因

当调用实例管理接口启动linux平台上的实例时，如果实例未授权，就会收到此错误。

处理建议

步骤1 检查CloudServer是否配置了授权参数；

步骤2 检查授权连接数是否用尽。

800 : StartInstance_ExeNotExist

错误码描述

实例启动失败-未找到可执行文件

可能原因

未找到RenderAgent.exe，可能被杀毒软件误杀，或者被误删

处理建议

检查安装文件是否完整，或尝试重新安装。

801 : StartInstance_ProjectPathNotExist

错误码描述

实例启动失败-工程不存在

可能原因

调用实例管理接口启动实例时，指定了一个不存在的工程文件

处理建议

步骤1 重新同步工程列表。

步骤2 检查指定的工程文件是否有效。

803 : StartInstance_ProcessStartFailed

错误码描述

实例启动失败-进程启动失败

可能原因

RenderAgent.exe进程启动失败，可能是系统原因，比如系统虚拟内存不足，中了病毒等。

处理建议

检查系统配置。

804 : StartInstance_Locked

错误码描述

实例启动失败-实例已锁定

可能原因

对已锁定的实例执行切换工程的操作，就会收到此错误。

处理建议

取消实例锁定；

或者换一个未锁定工程的实例。

805 : StartInstance_StartPendding

错误码描述

实例启动失败-启动中

可能原因：

实例正在启动，需要等待。

处理建议

等待响应。

806 : StartInstance_Timeout

错误码描述

实例启动失败-超时

可能原因

实例启动超时（30秒）

处理建议

步骤1 重新刷新浏览器；

步骤2 检查参数是否正确；

步骤3 调试运行，查看。

二次开发业务错误码

1：InvalidParameters 参数错误

错误码描述

InvalidParameters 参数错误

可能原因

输入的参数错误。

处理建议

检查参数的正确性。

2：InternalError 内部错误

错误码描述

InternalError 内部错误

可能原因

内部错误

处理建议

收集问题进行反馈，由开发工程师排查原因。

3：ResourceNotFound 数据不存在

错误码描述

ResourceNotFound 数据不存在

可能原因

数据不存在。

处理建议

检查数据是否存在。

4：AcpProjWKTNotSet 工程未设置坐标系

错误码描述

AcpProjWKTNotSet 工程未设置坐标系

可能原因

工程未设置坐标系。

处理建议

步骤1 新建ACP工程。

步骤2 设置合适坐标系。

5：CoordinateConversionFailed 坐标转换失败

错误码描述

CoordinateConversionFailed 坐标转换失败

可能原因

坐标越界或不符合规范。

处理建议

检查坐标的有效性。

6：IDExists 指定ID的对象已经存在了

错误码描述

IDExists 指定ID的对象已经存在了

可能原因

指定ID的对象已经存在了。

处理建议

检查指定ID的对象是否已经存在。

7：InvalidRequestType 无效的请求类型

错误码描述

InvalidRequestType 无效的请求类型

可能原因

无效的请求命令。

处理建议

检查请求命令的正确性。

8：InvalidRequestString 无效的请求（包含了InvalidRequestType）

错误码描述

InvalidRequestString 无效的请求（包含了InvalidRequestType）

可能原因

无效的请求参数。

处理建议

检查请求参数的正确性。

9：NoCommand CommandFactory没有创建对应的Command

错误码描述

NoCommand CommandFactory没有创建对应的Command

可能原因

没有创建对应的Command

处理建议

检查请求命令的正确性。

10：DataTypeNotSupport 不支持这种类型的数据

错误码描述

DataTypeNotSupport 不支持这种类型的数据

可能原因

操作不支持此类型的数据，比如压平操作只能是OSGB和Terrain。

处理建议

更换操作的对象类型。

11：InvalidOperation 无效的操作

错误码描述

InvalidOperation 无效的操作

可能原因

无效的操作。

处理建议

检查操作的有效性。

12：ProjectNotOpened 工程尚未打开，此时不能进行API调用！

错误码描述

ProjectNotOpened 工程尚未打开，此时不能进行API调用！

可能原因

工程尚未打开。

处理建议

稍后等工程完全开启后执行API调用。

13：Unauthorized 未授权

错误码描述

Unauthorized 未授权

可能原因

未获得授权

处理建议

检查授权是否正确。

14：IDAlreadyExists ID已经存在

错误码描述

IDAlreadyExists ID已经存在。

可能原因

ID已经存在。

处理建议

更换ID。