# 添加内容

Space Studio 右侧的 **Content Panel** 用于把 3D 模型、基础几何、灯光和标注放入地图坐标系。地图负责描述真实空间，Content 描述用户将在这个空间中看到和交互的数字内容。

## 打开 Content Panel

在 Ready 地图的 Space Studio 页面中，选择顶部 **Content**。右侧面板打开后，三维画布会自动让出空间。点击面板标题可以收起面板内容；拖动左侧边缘可以调整宽度。

## 添加对象

在 **Scene** 区域选择 **+ Add**：

- **Geometry**：Box、Sphere、Cylinder、Plane，适合占位、遮挡测试和简单视觉元素。
- **Light**：Ambient、Directional、Point，用于控制已导入模型的照明。
- **Model**：导入 `.glb` 或 `.gltf` 模型及其关联资源。
- **Annotation · Tag**：点击真实表面放置可读标注；需要地图已经加载可供拾取的表面 Mesh。

生产内容优先使用 GLB：模型、材质和纹理可以封装为单个文件，迁移时更不容易遗漏资源。导入前应控制贴图尺寸、材质数量和三角面数，避免移动端加载缓慢。

## 放置与编辑

选择 Scene 列表中的对象后，在 **TOOLS** 中使用：

- **Translate**：沿 X、Y、Z 轴移动。
- **Rotate**：绕坐标轴旋转。
- **Scale**：改变对象大小。
- **Undo / Redo**：在当前对象的编辑历史中撤销或重做。
- **Reset**：恢复该对象本轮编辑前的变换。

使用变换手柄完成大致放置后，再用对象属性中的数值精确校准。内容应以地图 Origin 为共同基准；不要通过整体移动地图去修正单个模型的位置。

## 管理 Scene

Scene 列表中的眼睛图标控制对象可见性，删除操作会从当前场景中移除对象。面板顶部的全局可见性和全部删除影响整个 Scene，执行前请确认范围。

对象可以形成父子关系。子对象的坐标相对于父对象，适合把灯光、标注或零件组织成一个整体；移动父对象时，子对象会一起移动。

## 保存

编辑完成后选择 Scene 标题旁的 **Save** 图标，把当前 Content 保存到服务器。没有保存的浏览器内修改在刷新或关闭页面后可能丢失。

保存后建议重新打开地图检查：

1. 所有对象是否仍位于正确位置。
2. 模型比例和朝向是否符合真实空间。
3. 灯光是否造成过曝或全黑材质。
4. Android WebXR、iOS App Clip 或微信小程序客户端是否能在目标设备上流畅加载。

完成后可从 Space Studio 顶部选择 **Launch**，按设备类型打开 AR 预览。