Cesium 3dtile 数据格式调度源码解析

1 背景

Cesium的1.81-1.82版本的更新导致如果tileset.json的初始化字段中不包含geometricError属性字段即将进入下一个类型判断。
因为拿不到数据导致undefined，错误报在ModelUtility.computeBoundingSphere的位置。
具体错误如下

2 源码解析

这里简单解析，具体怎么玩转的，还是自己要调试一回。

2.1入口模块

Cesium3DTile模块的makeContent(tile, arrayBuffer)函数。此函数主要是用来装载3ditile的单个内容，言外之意就是Cesium在加载三维数据（3dtiles）时，每一个切片都会调用这个方法来获取元数据信息和流。

2.2 类型获取

preprocess3DTileContent模块，使用Most likely a XXX，本身设计上就不严谨。
解决背景中error的方法：将原来为json.geometricError，修改为json.root即可，本质是解析tileset.json的文件。
更早的版本还只是在使用getMagic来取固定字符串，然后匹配类型解决问题。

这可能就是跟ArcGIS这种大型商业软件的提供了稳定的数据处理工具的差距。
反过来，Cesium的优势也是ArcGIS不可比拟的，比如开源，比如免费，只是增加了学习成本，但这带来的却是正在的理解GIS体系和个人以及团队的知识积累，不再是简单的调用API了，更多的需要自己去思考如何解决这些实际存在的问题。

export default function preprocess3DTileContent(arrayBuffer) {
    
    
  var uint8Array = new Uint8Array(arrayBuffer);
  var contentType = getMagic(uint8Array);

  // We use glTF for JSON glTF files. For binary glTF, we rename this
  // to glb to disambiguate
  if (contentType === "glTF") {
    
    
    contentType = "glb";
  }

  if (Cesium3DTileContentType.isBinaryFormat(contentType)) {
    
    
    return {
    
    
      // For binary files, the enum value is the magic number
      contentType: contentType,
      binaryPayload: uint8Array,
    };
  }
  var json = getJsonContent(uint8Array);
  // 原来为json.geometricError,修改为json.root
  if (defined(json.root)) {
    
    
    // Most likely a tileset JSON
    return {
    
    
      contentType: Cesium3DTileContentType.EXTERNAL_TILESET,
      jsonPayload: json,
    };
  }

  if (defined(json.asset)) {
    
    
    // Most likely a glTF. Tileset JSON also has an "asset" property
    // so this check needs to happen second
    return {
    
    
      contentType: Cesium3DTileContentType.GLTF,
      jsonPayload: json,
    };
  }
  throw new RuntimeError("Invalid tile content.");
}

2.3 转换工厂

有了文件类型的判断，下一步就是根据类型进行对应的数据处理。
Cesium3DTileContentFactory模块。

var Cesium3DTileContentFactory = {
    
    
  b3dm: function (tileset, tile, resource, arrayBuffer, byteOffset) {
    
    
    return new Batched3DModel3DTileContent(
      tileset,
      tile,
      resource,
      arrayBuffer,
      byteOffset
    );
  },
  pnts: function (tileset, tile, resource, arrayBuffer, byteOffset) {
    
    
    return new PointCloud3DTileContent(
      tileset,
      tile,
      resource,
      arrayBuffer,
      byteOffset
    );
  },
  i3dm: function (tileset, tile, resource, arrayBuffer, byteOffset) {
    
    
    return new Instanced3DModel3DTileContent(
      tileset,
      tile,
      resource,
      arrayBuffer,
      byteOffset
    );
  },
  cmpt: function (tileset, tile, resource, arrayBuffer, byteOffset) {
    
    
    // Send in the factory in order to avoid a cyclical dependency
    return new Composite3DTileContent(
      tileset,
      tile,
      resource,
      arrayBuffer,
      byteOffset,
      Cesium3DTileContentFactory
    );
  },
  externalTileset: function (tileset, tile, resource, json) {
    
    
    return new Tileset3DTileContent(tileset, tile, resource, json);
  },
  geom: function (tileset, tile, resource, arrayBuffer, byteOffset) {
    
    
    return new Geometry3DTileContent(
      tileset,
      tile,
      resource,
      arrayBuffer,
      byteOffset
    );
  },
  vctr: function (tileset, tile, resource, arrayBuffer, byteOffset) {
    
    
    return new Vector3DTileContent(
      tileset,
      tile,
      resource,
      arrayBuffer,
      byteOffset
    );
  },
  subt: function (tileset, tile, resource, arrayBuffer, byteOffset) {
    
    
    return new Implicit3DTileContent(
      tileset,
      tile,
      resource,
      arrayBuffer,
      byteOffset
    );
  },
  glb: function (tileset, tile, resource, arrayBuffer, byteOffset) {
    
    
    var arrayBufferByteLength = arrayBuffer.byteLength;
    if (arrayBufferByteLength < 12) {
    
    
      throw new RuntimeError("Invalid glb content");
    }
    var dataView = new DataView(arrayBuffer, byteOffset);
    var byteLength = dataView.getUint32(8, true);
    var glb = new Uint8Array(arrayBuffer, byteOffset, byteLength);

    return new Gltf3DTileContent(tileset, tile, resource, glb);
  },
  gltf: function (tileset, tile, resource, json) {
    
    
    return new Gltf3DTileContent(tileset, tile, resource, json);
  },
};
export default Cesium3DTileContentFactory;

3 总结

多看源码，学就完事了