C#开发BIMFACE系列46 服务端API之离线数据包下载及结构详解

BIMFACE二次开发系列目录【已更新最新开发文章，点击查看详细】

在前一篇博客《C#开发BIMFACE系列45 服务端API之创建离线数据包》中通过调用接口成功的创建一个离线数据包

离线数据包是存储在BIMFACE公有云服务器上的，所以使用之前需要将其下载到本地。本文将介绍通过接口下载离线数据包的操作过程。

获取离线数据包下载地址

调用接口的实现代码

 1 /// <summary>

 2 ///  获取数据包下载地址

 3 /// </summary>

 4 /// <param name="accessToken">【必填】令牌</param>

 5 /// <param name="objectId">【必填】模型Id 或 模型集成Id 或 模型对比Id</param>

 6 /// <param name="modelType">【必填】模型类别</param>

 7 /// <param name="databagVersion">数据包版本；对于offline、vr数据包，如果只有一个，则下载唯一的数据包，如果多个，则必须指定数据包版本</param>

 8 /// <param name="type">数据包类型，如offline、vr、igms</param>

 9 /// <returns></returns>

10 private GetUrlSwaggerDisplay GetDatabagDownloadUrl(string accessToken, long objectId, ModelType modelType, string databagVersion = "", string type = "offline")

11 {

12     //GET https://api.bimface.com/data/databag/downloadUrl

13     string url = BIMFaceConstants.API_HOST + "/data/databag/downloadUrl?" + modelType.ToString() + "=" + objectId;

14     if (databagVersion.IsNotNullAndWhiteSpace())

15     {

16         url += "&databagVersion=" + databagVersion;

17     }

18     if (type.IsNotNullAndWhiteSpace())

19     {

20         url += "&type=" + type;

21     }

22

23     BIMFaceHttpHeaders headers = new BIMFaceHttpHeaders();

24     headers.AddOAuth2Header(accessToken);

25

26     try

27     {

28         GetUrlSwaggerDisplay response;

29         HttpManager httpManager = new HttpManager(headers);

30         HttpResult httpResult = httpManager.Get(url);

31         if (httpResult.Status == HttpResult.STATUS_SUCCESS)

32         {

33             response = httpResult.Text.DeserializeJsonToObject<GetUrlSwaggerDisplay>();

34         }

35         else

36         {

37             response = new GetUrlSwaggerDisplay

38             {

39                 Message = httpResult.RefText

40             };

41         }

42

43         return response;

44     }

45     catch (Exception ex)

46     {

47         throw new BIMFaceException("[获取数据包下载地址]发生异常！", ex);

48     }

49 }

接口返回的data参数值即为离线数据包的下载地址

https://bf-prod-databag.oss-cn-beijing.aliyuncs.com/4ab9f2df0a8fa218e8ecec619c7090df/4ab9f2df0a8fa218e8ecec619c7090df.zip?Expires=1634202927&OSSAccessKeyId=LTAI4FeTn1BWYhirPskmAUWm&Signature=OE4TZwfjTMZfKvLUbx%2FORkpTxvk%3D

可以看出离线数据库是一个.zip压缩包文件，

Expires：地址的有效时间。

OSSAccessKeyId：BIMFACE在阿里云开发者账号key值。

Signature：签名，已加密。

获取到下载地址后即可下载文件即可，三个参数都不用处理。

下载离线数据包

两种方式下载

编程下载
手动在浏览器中下载

一般来说离线数据包应用在模型/图纸数量不多，且内容不变的场景中，所以手动下载即可。即使使用编程下载到本地电脑指定位置之后还是要手动解压缩、部署等动作，所以推荐手动下载的方式。

将上述url复制并粘贴到浏览器的地址栏中，按下回车键

C#开发BIMFACE系列46 服务端API之离线数据包下载及结构详解

下载到本地的文件是一个.zip压缩包

C#开发BIMFACE系列46 服务端API之离线数据包下载及结构详解

压缩包的名称是随机命名的Guid值，并无实际意义。手动解压缩后，目录结构如下

C#开发BIMFACE系列46 服务端API之离线数据包下载及结构详解

压缩包内部文件结构解析

离线数据包是一组静态资源文件，并不需要特定的云端程序提供运行时环境，因此可以像部署网页的css、js、image一样部署在静态Web服务器上。注意：在部署前，必须把压缩文件解压。为了加速访问，离线数据包中的很多文件都进行了gzip压缩。

1、584e7191686a5f8307cdd973b77a1520 目录

目录名称是随机命名的Guid值，并无实际意义。子目录结构如下