外观
加载gltf模型不出现
约 569 字
问题的现象
按示例代码加载 glTF 模型后,在地球上看不到模型。
排查1:模型 URL 地址是否异常
- 将 URL 地址复制到浏览器地址栏中访问测试,确认 network 中成功请求了模型;
- 查看 F12 提示,确认是否存在跨域错误。
排查2:加载 glTF 的参数存在问题
- 坐标值不在当前视域内,可以执行 flyTo 定位过去查看;
- 模型比例大小问题,可修改模型缩放 scale 参数,或缩小视角进行浏览;
- 在 style 中添加一个文本标注,便于快速定位模型应该出现的位置;
- 先注释掉其他无关参数,测试是否是某些参数引起的问题,或参考API文档设置参数。
const primitive = new mars3d.graphic.ModelPrimitive({
position: [116.349194, 30.864603, 376.58],
style: {
url: "//data.mars3d.cn/gltf/mars/qiche.gltf",
scale: 1,
minimumPixelSize: 50, // 最小像素值,可以避免太小看不见
label: { text: "我应该出现在这里", font_size: 20 }, // 加个label快速确定位置
},
});
graphicLayer.addGraphic(primitive);
primitive.flyTo();// 视角定位到目标位置排查3:如果有渲染失败错误
- 如果出现渲染错误弹窗,可能是处理的材质或部分特性在当前 Cesium 版本中不受支持,可使用最新版本数据处理工具重新转换 glTF,或尝试切换不同 Cesium 版本加载测试。
排查4:是否因开启深度检测而被遮挡
- 可能是模型高度位于地面以下,请检查设置的坐标值是否异常;
- 可以通过右键菜单操作,或执行代码
map.scene.globe.depthTestAgainstTerrain = false关闭深度检测后缩放视角查看。
排查5:在官方示例中输入 URL 加载标绘验证
- 在Gltf模型编辑页面中验证是否能够成功标绘加载。

排查6:模型格式转换中是否存在问题
- 剩余的可能性就是 glTF 数据本身存在问题,需要重新转换处理;
- 可通过其他引擎加载预览该 glTF,确认是否异常;
- 可尝试更换转换工具处理数据后再测试加载。
