Компонент данных block
В этом руководстве подробно описаны функции и методы использования элементов управления, предоставляемых компонентом данных block в редакторе Unity.
Версия примечания
Начиная с версии 9.4 самостоятельного построения карты, формат данных Block Mesh был обновлен с eme до gltfx.
Все функции, поддерживающие только новый формат, помечены как [>=9.4]. Если ваша версия данных ниже 9.4, соответствующие элементы управления UI не будут работать.
Все функции, поддерживающие только старый формат, помечены как [<9.4]. Если ваша версия данных 9.4 или выше, соответствующие элементы управления UI не будут работать.
Начальное состояние
Начальное состояние компонента относится к состоянию компонента данных block, когда инструмент только что создан, не выбрана ни одна служба и не загружены никакие данные.

Компонент данных block в Annotation Tool и Block Viewer for Unity Developer.
| Номер | Название элемента управления | Тип элемента управления | Описание функции |
|---|---|---|---|
| 1 | Опция глобальной системы координат | Выпадающее меню | Устанавливает логику выравнивания системной координаты сцены с данными GNSS, которые несет block: GPS (по умолчанию): автоматически выравнивает block по данным GNSS. В этом случае положение block относительно корневого узла block не может быть перемещено. None: не использовать данные GNSS для выравнивания block. В этом случае положение block относительно корневого узла block может быть перемещено. |
| 2 | Выбрать корневой узел | Селектор | Выбрать узел в сцене с компонентом BlockRootController в качестве корневого узла. |
| 3 | Создать новый корневой узел | Кнопка | Создает новый корневой узел block и устанавливает его в качестве корневого узла. Загруженный block будет автоматически удален. |
| 4 | Очистить кэшированные файлы | Кнопка | Очистить все локально кэшированные данные block. |

Компонент данных block в Block Viewer
| Номер | Название элемента управления | Тип элемента управления | Описание функции |
|---|---|---|---|
| 5 | Загрузить локальный block | Кнопка | Загрузить локальный block с расширением .eme или .gltfx. |
| 6 | Сброс | Кнопка | Восстанавливает текущий компонент block в начальное состояние. |
Состояние выбранной службы
Состояние компонента с выбранной службой относится к состоянию компонента данных block после выбора службы (служба позиционирования Mega Block, служба хранения Mega Block и т.д.) в инструменте.

| Номер | Название элемента управления | Тип элемента управления | Описание функции |
|---|---|---|---|
| 7 | Обновить список block | Кнопка | Обновить информацию на текущем инструменте block, синхронизируя данные с облачной службой. |
| 8 | Выбрать точность raycast | Выпадающее меню | [>=9.4]Установить точность модели mesh block при использовании для raycast. Снижение точности ускорит загрузку LOD в редакторе, но пожертвует точностью при редактировании: Min LOD (по умолчанию): использовать самую простую модель для raycast. None: не загружать модель коллизий, не выполнять raycast. 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 Загрузить block, для просмотра текущего состояния загрузки и/или скачивания.

| Номер | Название элемента управления | Тип элемента управления | Описание функции |
|---|---|---|---|
| 27 | Прогресс скачивания | Прогресс-бар | Прогресс-бар скачивания данных block, по достижении 100% запускается загрузка. |
| 28 | Прогресс загрузки | Прогресс-бар | Прогресс-бар загрузки данных block, завершается при достижении 100%. |
Состояние загруженной модели
Состояние компонента с загруженной моделью относится к состоянию компонента данных block после загрузки mesh хотя бы одного block путем нажатия 13 Загрузить block.
| Номер | Название элемента управления | Тип элемента управления | Описание функции |
|---|---|---|---|
| 5 | Загрузить локальный block | Кнопка | Загрузить локальный block с расширением .eme или .gltfx. |
| 6 | Сброс | Кнопка | Восстанавливает текущий компонент block в начальное состояние. |
Состояние без загруженных панорамных маркеров
Состояние компонента, когда загружен mesh хотя бы одного block, но не загружены панорамные маркеры, относится к состоянию компонента данных block без загруженных панорамных маркеров.

| Номер | Название элемента управления | Тип элемента управления | Описание функции |
|---|---|---|---|
| 14 | Скрыть/Показать | Кнопка | Скрыть/Показать mesh block в сцене. |
| 15 | Удалить block | Кнопка | Удалить текущий загруженный block. |
| 16 | Маркер качества | Текст | HD означает панораму высокого качества; SD означает панораму стандартного качества. |
| 17 | Загрузить панорамный маркер | Кнопка | Загрузить в текущую сцену желтый сферический индикатор, представляющий панорамный маркер. |
Состояние с загруженными панорамными маркерами
Состояние компонента, когда загружен mesh хотя бы одного block и загружены панорамные маркеры путем нажатия 17 Загрузить панорамный маркер, относится к состоянию компонента данных block.
В этом состоянии можно показать, скрыть, удалить связанные с этим block панорамные индикаторы и загрузить панорамное окно.

| Номер | Название элемента управления | Тип элемента управления | Описание функции |
|---|---|---|---|
| 18 | Скрыть/Показать | Кнопка | Скрыть/Показать желтые сферические индикаторы панорамных маркеров в сцене. |
| 19 | Удалить панорамный маркер | Кнопка | Удалить текущий загруженный панорамный маркер. |
Элементы управления в сцене
В SceneView редактора Unity существуют элементы управления, созданные компонентом данных 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. |
Панорамный маркер
Панорамный маркер — это индикатор, появляющийся в сцене после загрузки mesh block и нажатия 17 Загрузить панорамный маркер. Он помечает позиции, доступные для панорамного просмотра.

| Номер | Название элемента управления | Тип элемента управления | Описание функции |
|---|---|---|---|
| 31 | Панорамный маркер | Интерактивный объект | Желтый сферический индикатор, обозначающий позицию, доступную для панорамного просмотра. |
Панорамное окно
Панорамное окно — это окно, появляющееся после загрузки mesh block и панорамных маркеров при нажатии на 31 Панорамный маркер. В нем можно выполнять панорамный просмотр и редактировать содержимое.

| Номер | Название элемента управления | Тип элемента управления | Описание функции |
|---|---|---|---|
| 32 | Панорамное окно | SceneView | Окно, в котором можно выполнять панорамный просмотр. |