Block 資料組件
本手冊詳細介紹在 Unity 編輯器中 Block 資料組件提供的控制項功能和使用方法。
版本說明
自建圖版本 9.4 起，Block Mesh 資料格式由 eme 升級為 gltfx。
文中所有僅支援新版格式的功能均標註為 [>=9.4]。若您的資料版本低於 9.4，相關 UI 控制項將不會生效。
文中所有僅支援舊版格式的功能均標註為 [<9.4]。若您的資料版本為 9.4 及以上，相關 UI 控制項將不會生效。
初始狀態
組件初始狀態指工具剛被建立，未選擇任何服務並且未載入任何資料時，Block 資料組件的狀態。
Annotation Tool 及 Block Viewer for Unity Developer 上的 Block 資料組件.
| 編號 | 控制項名稱 | 控制項類型 | 功能說明 |
|---|---|---|---|
| 1 | 全域座標系選項 | 下拉式功能表 | 設定場景座標系與 Block 攜帶的 GNSS 資料的對齊邏輯： GPS (預設)：自動按 GNSS 資料對齊 Block。此時 Block 相對 Block 根節點位置不可移動。 None： 不使用 GNSS 資料對齊 Block。 此時 Block 相對 Block 根節點位置可以移動。 |
| 2 | 選擇根節點 | 選擇器 | 選擇場景中一個帶有 BlockRootController 組件的節點作為根節點。 |
| 3 | 新建根節點 | 按鈕 | 產生一個新的 Block 根節點，並將其設定為根節點。已載入的 Block 會被自動刪除。 |
| 4 | 清空快取檔案 | 按鈕 | 清空本機快取的所有 Block 資料。 |
Block Viewer 上的 Block 資料組件
| 編號 | 控制項名稱 | 控制項類型 | 功能說明 |
|---|---|---|---|
| 5 | 載入本機 Block | 按鈕 | 載入本機副檔名為 .eme 或 .gltfx 的 Block。 |
| 6 | 重設 | 按鈕 | 使當前 Block 組件恢復為初始狀態。 |
選定服務狀態
組件選定服務狀態指工具中選擇了一個服務（Mega Block 定位服務， Mega Block 儲存服務等）後 Block 資料組件的狀態。
| 編號 | 控制項名稱 | 控制項類型 | 功能說明 |
|---|---|---|---|
| 7 | 重新整理 Block 列表 | 按鈕 | 重新整理當前 Block 工具上的資訊，與雲端服務的資料同步。 |
| 8 | 選擇射線偵測精度 | 下拉式功能表 | [>=9.4]設定 Block 的 Mesh 用於射線偵測時的模型精度，降低精度會加快編輯器中的 LOD 載入速度，但會犧牲編輯時精度： Min LOD (預設)：使用最簡模型進行射線偵測。 None： 不載入碰撞模型，不進行射線偵測。 Match LOD：根據 LOD 載入碰撞模型。 |
| 9 | Mesh 分塊識別碼 | 開關 | [>=9.4]勾選後場景中會出現 Mesh 分塊識別碼。 |
| 10 | 選擇 Block 節點 | 按鈕 | 選擇場景中一個帶有 BlockController 組件的節點作為 Block 節點。 |
| 11 | 版本 | 文字 | 該 Block 的版本。 |
| 12 | 匯出 Block | 按鈕 | [>=9.4]彈出匯出功能表。 [<9.4]選擇匯出目錄，匯出 obj 格式的模型檔案。 |
| 13 | 載入 Block | 按鈕 | 在場景中載入的 Mesh。 |
匯出功能表[>=9.4]
新版本的匯出功能表中可修改匯出時的設定，包括匯出層級，是否到處貼圖，匯出檔案格式等。
| 編號 | 控制項名稱 | 控制項類型 | 功能說明 |
|---|---|---|---|
| 20 | 層級選擇 | 核取方塊 | 選擇要匯出的模型 LOD 精度，未勾選合併檔案時可多選，勾選合併檔案時只可單選。 |
| 21 | 匯出原始檔案 | 開關 | 以原始的 gltfx 格式匯出。 |
| 22 | 匯出貼圖 | 開關 | 是否匯出模型貼圖。 |
| 23 | 檔案格式 | 單選按鈕 | 切換匯出的單個檔案格式是 glb 還是 gltf。 |
| 24 | 合併檔案 | 開關 | 在匯出時合併該層級所有分塊。 |
| 25 | 匯出 | 按鈕 | 選擇匯出路徑，開始匯出。 |
匯出進度
點選 12 匯出 Block[<9.4] 或 25 匯出後出現的匯出進度條，用於檢視當前匯出狀態。
| 編號 | 控制項名稱 | 控制項類型 | 功能說明 |
|---|---|---|---|
| 26 | 匯出進度 | 進度條 | 選擇路徑後匯出時顯示的匯出進度條，到 100% 後完成。 |
載入進度[<9.4]
點選 13 載入 Blcok 按鈕後出現的進度條，用於檢視當前下載和/或載入狀態。
| 編號 | 控制項名稱 | 控制項類型 | 功能說明 |
|---|---|---|---|
| 27 | 下載進度 | 進度條 | 下載 Block 資料的進度條，到 100% 後觸發載入。 |
| 28 | 載入進度 | 進度條 | 載入 Block 資料的進度條，到 100% 後完成。 |
已載入模型狀態
組件載入模型狀態指已經透過點選 13 載入 Block 載入了至少一個 Block 的 Mesh 後 Block 資料組件的狀態。
| 編號 | 控制項名稱 | 控制項類型 | 功能說明 |
|---|---|---|---|
| 5 | 載入本機 Block | 按鈕 | 載入本機副檔名為 .eme 或 .gltfx 的 Block。 |
| 6 | 重設 | 按鈕 | 使當前 Block 組件恢復為初始狀態。 |
未載入全景標記狀態
組件載入了至少一個 Block 的 Mesh 但未載入全景標記狀態指未載入全景標記時 Block 資料組件的狀態。
| 編號 | 控制項名稱 | 控制項類型 | 功能說明 |
|---|---|---|---|
| 14 | 隱藏/顯示 | 按鈕 | 隱藏/顯示場景中的 Block Mesh。 |
| 15 | 刪除 Block | 按鈕 | 刪除當前已載入的 Block。 |
| 16 | 高清標記 | 文字 | HD 代表高清全景; SD 代表標清全景。 |
| 17 | 載入全景標記 | 按鈕 | 在當前場景中載入代表全景標記的黃色球形識別碼。 |
已載入全景標記狀態
組件載入了至少一個 Block 的 Mesh 且已載入全景標記狀態指已透過點選 17 載入全景標記時 Block 資料組件的狀態。
在這種狀態下可顯示、隱藏、刪除該 Block 關聯的全景識別碼並載入全景視窗。
| 編號 | 控制項名稱 | 控制項類型 | 功能說明 |
|---|---|---|---|
| 18 | 隱藏/顯示 | 按鈕 | 隱藏/顯示場景中的全景標記小球。 |
| 19 | 刪除 全景標記 | 按鈕 | 刪除當前已載入的全景標記。 |
場景中的控制項
在 Unity 編輯器的 SceneView 中存在一些由 Block 資料組件建立的控制項。
LOD 分塊識別碼[>=9.4]
在 9.4 及以上版本工具開啟 9 Mesh 分塊識別碼後顯示的識別碼，用於識別 LOD 的分塊，層級和狀態。
| 編號 | 控制項名稱 | 控制項類型 | 功能說明 |
|---|---|---|---|
| 29 | 分塊 LOD 識別碼 | Gizmo | 識別分塊， LOD 載入後根據層級和狀態顯示不同的顏色： 藍色：Min 層級，精度最低。 淺藍色： Medium 層級，精度中等。 綠色：Max 層級，精度最高。 紅色：載入過程出現異常（重試中）。 黃色：載入中。 |
LOD 載入識別碼[>=9.4]
LOD 載入識別碼是一個在介面上轉動的 UI 控制項，僅在 LOD 切換時出現。
| 編號 | 控制項名稱 | 控制項類型 | 功能說明 |
|---|---|---|---|
| 30 | LOD 載入識別碼 | UI | 出現時表示正在進行 LOD 載入。 |
全景標記
全景標記是在載入 Block Mesh 後點選 17 載入全景標記後場景中出現的標記，用於識別可以全景預覽的位置。
| 編號 | 控制項名稱 | 控制項類型 | 功能說明 |
|---|---|---|---|
| 31 | 全景標記 | 可互動物件 | 表示該位置可以進行全景預覽的黃色球形識別碼。 |
全景視窗
全景視窗是在載入 Block Mesh 和全景識別碼後點選 31 全景標記後出現的視窗，可在其中進行全景預覽和內容編輯。
| 編號 | 控制項名稱 | 控制項類型 | 功能說明 |
|---|---|---|---|
| 32 | 全景視窗 | SceneView | 可以在其中進行全景預覽的視窗。 |