标记

2025年7月22日大约 2 分钟

标记是一种用于在三维场景中添加文本标识的标绘节点。它可以在指定位置显示文本，帮助用户快速识别和理解场景中的重要信息点。

在标记节点的 组件配置 以及 标记文本配置 用以配置通用的标记样式模板，所有子元素都会应用该样式。

在 图层面板 中 标记节点 下会根据当前的子元素数据展示对应的子元素节点，可点击对应子元素节点修改子元素的名称、位置等信息。

属性

可添加多个组件补充标绘的内容和展示效果，支持图片、视频以及模型的内容。

点击右侧 + 按钮可添加组件，点击组件名称右侧的 x 按钮可删除对应组件。

图片内容： 可选择 素材库 中的图片或直接输入图片的 URL 地址。
尺寸： 设置图片在场景中的宽度（W）和高度（H）。单位为 米。
朝向： 控制图片的朝向方式。
- 默认： 图片朝向不随相机视角变化而变化。
- 始终朝向屏幕： 图片始终正对屏幕。
- 水平朝向屏幕： 图片在水平方向上始终朝向屏幕，垂直方向保持不变。
- 垂直朝向屏幕： 图片在垂直方向上始终朝向屏幕，水平方向保持不变。

视频内容： 可选择 素材库 中的视频文件或直接输入视频的 URL 地址。
尺寸： 设置视频在场景中的宽度（W）和高度（H）。单位为 米。
朝向： 控制视频的朝向方式。
- 默认： 视频朝向不随相机视角变化而变化。
- 始终朝向屏幕： 视频始终正对屏幕。
- 水平朝向屏幕： 视频在水平方向上始终朝向屏幕，垂直方向保持不变。
- 垂直朝向屏幕： 视频在垂直方向上始终朝向屏幕，水平方向保持不变。
播放速率： 控制视频的播放速度倍率。数值为 1 表示正常播放速度，大于 1 表示加速播放，小于 1 表示减速播放。

资产： 展示当前使用的资产库模型预览图。可从 资产库 中拖拽模型到预览图区域进行模型替换。

地址： 通过地址链接的方式加载外部模型。

标记文本用于在标记上显示文字信息。在场景中展示的文本内容为 子元素 的名称。

启用轮播动画功能可以让可见的子元素按照设定的时间间隔依次显示，实现动态轮播效果。轮播过程中触发 悬浮 或 选中 状态时会暂停轮播，取消 悬浮 或 选中 状态时会继续轮播动画的播放。

提示

在编辑器中开启轮播动画不会执行相应的轮播动画，可在 预览 页面查看对应的展示效果。

可根据实际需求，为节点添加自定义属性。可通过配置 自定义数据 添加节点的自定义静态数据，进而与外部进行业务与数据的交互。

例如场景的楼宇模型中有多个摄像头模型，给摄像头模型配置对应的视频流 ID，在外部监听场景的点击事件，可获取到点击的摄像头配置的视频流 ID 播放对应的摄像头视频，实现点击摄像头播放对应视频的功能。

自定义属性列表： 点击右侧的 + 号图标或面板底部的 添加属性 按钮，均可在列表末尾添加一个新的自定义属性。
- 名称： 自定义属性字段名。
- 字段值类型： 字段值支持三种类型字符、数值、布尔。

子元素用于管理多个实例，每个子元素可以设置独立的名称和位置。

在根节点添加 自定义属性 后，可在子元素上配置 自定义属性 的值。自定义属性的数据将会以键值对的形式在子元素的数据中提供。

支持配置多个节点状态，可切换不同状态展示不同效果。

初始状态： 用于设置节点的默认状态，切换状态可在 3D 场景编辑器内查看到节点的实时效果。
悬浮状态： 用于设置节点处于鼠标悬浮时的状态。当标绘内容开启 可选中 选项时，鼠标悬浮到子元素上时该子元素切换到 悬浮状态 的展示效果，鼠标移开时该子元素恢复到 初始状态 的展示效果。
选中状态： 用于设置节点处于选中时的状态。当标绘内容开启 可选中 选项时，鼠标左键 点击子元素时该子元素切换到 选中状态 的展示效果，鼠标再次点击该子元素则恢复到 初始状态 的展示效果。同一个标绘节点下的不同子元素之间只会保持一个选中状态。
状态列表： 可添加多个节点状态。
- ID： 当前状态的唯一标识，可通过 ID 值切换当前节点状态。
- 名称： 当前状态的名称。