C#開發BIMFACE系列46 服務端API之離線資料包下載及結構詳解

張傳寧發表於2021-10-15

C#服務端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 }

View Code

介面返回的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複製並貼上到瀏覽器的位址列中，按下Enter鍵

下載到本地的檔案是一個.zip壓縮包

壓縮包的名稱是隨機命名的Guid值，並無實際意義。手動解壓縮後，目錄結構如下

C#開發BIMFACE系列46 服務端API之離線資料包下載及結構詳解

壓縮包內部檔案結構解析

離線資料包是一組靜態資原始檔，並不需要特定的雲端程式提供執行時環境，因此可以像部署網頁的css、js、image一樣部署在靜態Web伺服器上。注意：在部署前，必須把壓縮檔案解壓。為了加速訪問，離線資料包中的很多檔案都進行了gzip壓縮。

1、584e7191686a5f8307cdd973b77a1520 目錄

目錄名稱是隨機命名的Guid值，並無實際意義。子目錄結構如下