# 文件上传

想要在场景中添加模型资源,首先要把本地的文件上传到BIMFACE并进行轻量化处理。

需要注意的是,本套开发指南侧重于场景的编辑应用,因此在文件准备方面偏向模型文件,不涉及图纸文件。若想了解更全面的模型、图纸文件上传转换操作,可参考模型浏览模块的开发指南 (opens new window)

为便于开发者快速学习,我们提供了BIMFACE示例模型,点击链接下载。

开发指南的教程内容不涉及对模型源文件的浏览和修改,可以不安装相关软件。

你可以通过控制台或调用服务端API两种方式来实现。

# 方法一:通过控制台发起上传文件

# 1. 进入控制台

登录BIMFACE,通过页面右上角进入控制台 (opens new window)

3

# 2. 上传文件

进入控制台后,选择对应项目。(需要注意的是,项目内的模型资源仅在当前项目内可用,不支持跨项目使用资源。文件上传前,请确认文件名称中不包含特殊字符 / \n  * <> | " : ?,否则文件无法上传成功。)BIMFACE控制台支持按文件和按文件夹两种方式上传。以按文件上传为例,在“文件管理”页面中,选中文件夹后点击顶部“上传文件”按钮,将弹出上传文件的模态窗口。

点击“添加文件”,选择待上传的模型文件后,即自动开始上传工作。

4

说明:
(1) 仅支持上传BIMFACE开放的格式 (opens new window),目前BIMFACE已经向所有用户开放成熟的格式。如有其他格式需求,请联系BIMFACE运营人员。你可以通过加入BIMFACE-官方技术支持群来联系运营人员。
(2) 按文件夹上传有以下限制:
1)若上传文件夹与当前目录中的文件夹重名,则新上传的文件夹合并至已有的重名文件夹中。
2)若合并后文件夹中存在相同文件名,则新上传的文件名会添加后缀进行区分。
3)单次文件夹总大小限制为20G。
4)文件大小按应用支持的文件大小限制,默认为1G。
5)文件个数限制为150个。
6)文件夹深度限制为10级。

# 3. 完成上传

上传完成后,文件的上传状态会刷新为“上传成功”,至此即完成了文件的上传操作。

5

# 方法二:通过服务端API发起上传文件

发起上传文件的API:查看详情 (opens new window)