模拟组件快速开始
适用于当前手册所述工作流。安装包及组件版本请参照版本与下载。
01 快速上手：生成并播放 12 台模拟机
首次使用可从 3 行 × 4 列的小编队开始，熟悉界面和播放方式。
- 启动 Serein Scope，从组件库找到“YSerein Swarm Simulator”，加载并打开工作区。
- 在左侧“编队会话 → 网格编队”中设置行数 3、列数 4，按需要设置间距，点击“一键生成”。
- 在右侧“机群属性”与中央画面确认出现 12 台模拟机。
- 将“播放来源”设为“箱式舞步”，箱子行列保持 3 × 4，确认界面显示已就绪。
- 点击“播放舞步”，观察时间、运动阶段和模拟机位置；需要暂停时再次点击播放按钮。
- 点击“停止”回到起始时刻。需要重新创建时，点击“清除全部模拟机”并确认，等待对象归零后再生成。
第一次使用先认清
| 操作 | 作用 |
|---|---|
| 一键生成 | 创建模拟设备，并显示其模拟状态。 |
| 播放舞步 | 推进当前播放来源的模拟预览。 |
| 停止 | 停止当前预览并回到起始时刻。 |
| 清除全部模拟机 | 停止播放并释放当前模拟设备，同时卸载当前导入舞步。 |
联调提醒：播放、暂停、跳转与停止可能改变地面站看到的模拟位置。需要观察真实指令结果时，先暂停自动预览。
02 组件安装、加载与更新
Scope 管理组件的安装、加载、工作区和移除。安装组件包后，还需要加载并打开对应工作区。
- 在 Scope 的“文件”菜单选择“导入组件包…”，或进入插件管理使用“导入插件包”。
- 选择完整的 Swarm 模拟组件包；支持交付的组件压缩包或 .sscomponent 组件文件。
- 在组件卡片中核对名称“YSerein Swarm Simulator”。
- 点击“加载插件”；已经加载时，点击“打开工作区”或“进入工作区”。
- 确认中央出现模拟预览，左右和下方出现对应的会话、属性与诊断面板。
| 动作 | 含义 |
|---|---|
| 安装 / 导入 | 将组件加入本机组件库。 |
| 加载插件 | 使组件可用于当前 Scope 会话。 |
| 打开工作区 | 进入该组件的操作界面。 |
| 关闭工作区 | 关闭当前组件操作会话。 |
| 卸载组件 | 停止使用已加载的组件；按提示先关闭相关工作区。 |
| 移除插件 | 从本机组件库移除对应安装项。 |
更新已有组件
先结束当前模拟会话，再关闭相关工作区并按提示卸载组件。导入新组件包，按界面提示处理同名组件，然后重新加载。应保留完整的组件包和配套文件，避免只替换其中某个文件。
交付包区分：YSerein Swarm 与独立模拟器的安装包，不会自动更新 Scope 内嵌模拟组件。Scope 组件更新请使用对应的组件包。
03 工作区与面板
中央查看运动与空间关系，左侧创建和控制会话，右侧查看模拟设备，下方查看诊断。
| 面板 | 主要内容 |
|---|---|
| 编队会话 | 导入舞步、选择播放来源、播放 / 暂停 / 停止、通信协议、网格生成、箱式设置与清除。 |
| 3D 模拟机编队 / 3D 舞步预览 | 显示当前来源的对象与运动；提供“重置视角”。 |
| 机群属性 | 模拟设备列表、选中设备的配置和状态编辑。 |
| 回放诊断 | 模拟对象数量、播放状态、命令接收与遥测目标。 |
| 底部播放栏 | 来源切换、播放、时间轴、时间显示和倍速。 |
显示与布局
- 左侧和右侧内容较长时滚动查看；可以拖动宿主面板分隔线调整空间。
- 面板被隐藏时，使用 Scope 的对应面板按钮或菜单恢复显示。
- 需要恢复面板布局时，使用“恢复当前页面默认布局”；中央组件布局可使用“恢复当前组件模板”。
- 窗口较窄时，底部的时间、倍速或对象数量可能收起。放宽窗口，或使用左侧会话中的播放控制。
数量的含义：“模拟对象”表示组件当前创建的设备数量。地面站是否发现、是否在线、是否完成初始化，需要在地面站分别确认。