如何使用DataV-WS服務 - DataV

本文您介紹DataV-WS服務的詳細功能。

DataV-WS服務結構

DataV-WS服務整合了靜態檔案服務和WebSocket服務。靜態檔案服務主要用於本地模型地址的載入，WebSocket服務符合藍圖編輯器WebSocket節點規範，使用該服務後，無需額外開發，在藍圖編輯器中能夠直接使用該服務跨越多個同網段下的可視化應用進行通訊。

DataV-WS服務文檔目錄

文檔目錄

重要

請勿刪除DataV-WS服務下的assets目錄。

啟動與停止DataV-WS服務

Windows：
1. 下載DataV-WS服務安裝包。
2. 解壓後雙擊開啟datav_ws_win.exe檔案。
3. 開啟檔案後，看到如下指令，表示啟動成功。
```
Server listen on IP地址（如：127.0.0.1）:8181     
```
  重要
  啟動後請勿關閉cmd運行框。
4. 在DataV-WS服務開啟後，可完成WebSocket服務、模型服務和靜態資源服務的開發和示範等功能操作，詳情請參見配置DataV-WS服務。
linux/mac：
1. 執行如下命令，下載DataV-WS服務應用。
```
wget http://sh-conf.oss-cn-shanghai.aliyuncs.com/doc_files/datav_ws.zip                      
```
2. 解壓安裝包，開啟終端，進入到服務所在目錄，如datav-ws。
3. 執行如下命令，服務預設在8181連接埠啟動。
```
chmod 777 *
sh exec.sh start
```
  說明
  - 您可以通過sh exec.sh stop命令，停止服務。
  - 您可以通過sh exec.sh restart命令，重啟服務。
4. 在DataV-WS服務開啟後，可完成WebSocket服務、模型服務和靜態資源服務的開發和示範等功能操作，詳情請參見配置DataV-WS服務。

配置DataV-WS服務

可配置的服務包括WebSocket、模型服務和靜態資源服務。

配置WebSocket服務。
- 開發階段：
  1. 在本地啟動DataV-WS服務，詳情請參見啟動與停止DataV-WS服務。
  2. 登入DataV控制台。
  3. 建立空白可視化應用。
  4. 單擊畫布編輯器頁面左上方，單擊藍圖編輯器表徵圖，切換到藍圖編輯器配置頁面。
  5. 在藍圖編輯器配置頁面，將左側邏輯節點欄內的WebSocket節點拖至畫布中。
  6. 設定藍圖編輯器內WebSocket節點的socket服務地址為：ws://127.0.0.1:8181。
- 示範階段：
  1. 在示範機器上或同網段機器啟動DataV-WS服務，詳情請參見啟動與停止DataV-WS服務。
  2. 根據示範機器的IP地址，在示範機器的藍圖編輯器內添加一個WebSocket節點，並變更WebSocket節點的socket服務地址為：ws://機器IP地址:8181，即可完成多個同網段可視化應用的互相通訊功能。
配置模型服務。
- 開發階段：
  1. 在本地啟動DataV-WS服務，詳情請參見啟動與停止DataV-WS服務。
  2. 將模型放入DataV-WS服務中的assets檔案夾內。
  3. 登入DataV控制台。
  4. 建立空白可視化應用。
  5. 參見畫布編輯器添加資產，在畫布編輯器頁面搭建所需要的DataV 3D引擎組件，並選擇添加模型載入器子組件。
    說明
    DataV 3D引擎為產品非萬用群組件。如有使用該組件的需求，請聯絡DataV銷售人員進行線下購買後再使用。
  6. 設定模型載入器組件內的模型地址為：http://IP地址:8181/模型檔案名稱。
- 示範階段：
  1. 將在開發階段產生的datav_ws檔案夾複製到同網段示範機器上。
  2. 在可視化應用示範機器上啟動DataV-WS服務，詳情請參見啟動與停止DataV-WS服務。
  3. 開啟需要示範的可視化應用即可擷取服務上的模型內容。
配置靜態資源服務。
1. 在本地啟動DataV-WS服務，詳情請參見啟動與停止DataV-WS服務。
2. 將靜態資源（如圖片）放入DataV-WS服務中的assets檔案夾內。
3. 登入DataV控制台。
4. 建立空白可視化應用。
5. 參見畫布編輯器添加資產，在畫布編輯器頁面搭建所需要的單張圖片組件。
6. 設定單張圖片組件背景圖編輯框的檔案地址為：http://IP地址:8181/p2544435894.webp，即可直接擷取服務上的圖片內容。

DataV：如何使用DataV-WS服務