分形三维高级功能1/9-显示SolidWorks/CATIA/step/Creo等复杂格式

不同于obj/gltf/fbx等通用格式，为了保护自己的技术专利，主流的CAD软件公司在格式数据结构定义上通常采用闭源的方式，使得在网页上展示它们变得非常困难。 fractal 3D 可以支持在网页端流畅渲染几乎所有主流的 CAD 软件格式（参考格式支持清单）,使用的方法就是在将其转换成分形三维自主研发的e3dx格式。 通过本章的内容，你将掌握上传、转换并在网页显示这些复杂格式文件的方法。

文件转换的基本流程

你既可以选择直接通过http接口调用我们部署在云端的Saas转换服务，也可以选择在公司和组织的私有云/服务器集群中部署我们的文件转换服务。 如果你希望进一步了解私有化部署的具体方案和报价，请联系我们～

这里以SaaS模式为例，介绍一下文件转换的基本流程：

• 先将文件包装成FormData的形式发送至我们提供的上传接口，我们会将该文件对应的uuid通过返回值的形式告知你。

const formData = new FormData();
formData.append("file", file);

在转换过程中，你可以通过上一步返回的uuid 向分形三维的后台轮询该文件的转换状态，可能的状态包括：

• pending（挂起）

• succeed（成功）

• failed（失败）

// 上传文件到服务器
// 请注意这里是ts方便您了解类型， 如果直接放到html中需要去掉变量类型
// 这里的 FormData 以及 File 类型就是通用的 js 文件操作类型， 可在此处 https://developer.mozilla.org/en-US/docs/Web/API/File 以及 https://developer.mozilla.org/en-US/docs/Web/API/FormData 获取详情
async function uploadFile(file: File, onProgress: (progress: number) => void) {
    const formData = new FormData();
    formData.append('file', file);
    try {
        // 调用 uploadFile 方法，将包装好的 formData 上传到服务器
        const { data } = await axios.post('https://api.evercraft.co/3d/v1/file/upload', formData, {
            onUploadProgress(e) {
                const { loaded, total } = e;
                if (total) {
                    onProgress((loaded / total) * 100);
                }
            }
        });

        const { filename, uuid } = data.data;
        console.log(filename, uuid);
    } catch (error) {
        console.error(error);
    }
}

若转换文件成功，轮询的返回值中将包含e3dx文件的url。你既可以选择将其下载至本地的存储空间自行管理，也可以在下一次需要显示该文件时再次通过uuid向我们请求最新的url。

// 从服务器查询文件转换状态
async function pollingFileStatus() {
    // 使用 uploadFile 返回的 uuid 查询该文件的转换状态
    const { data } = await axios.get('https://api.evercraft.co/3d/v1/file', {
        params: { key: this._uuid }
    });

    const { status, url } = data;
    console.log(data);

    if (status === 'succeed') { // 转换成功
        url = `https://evercraft.co${url}`; // 拼接文件的 url
        status = 'succeed';
    } else if (status === 'pending' || status === 'running') { // 转换中
        status = 'pending';
    } else { // 转换失败
        status = 'failed';
    }

}

注意：每个e3dx文件的URL会在15分钟后失效，超过这个时间就必须通过uuid向分形三维后台请求新的url！

---

完整示例 请参考demos中的upload-and-show.html