熟悉工作区
先用准备好的地形启动仿真,了解各个面板,再向载具发送控制指令。
登录并打开第一个世界
- 在WWW-POSIM注册,打开验证邮件并登录。如果没有收到邮件,检查垃圾邮件或重新发送。安装版也需要验证邮箱。
- 在应用中选择启动仿真器;在网站上打开个人工作区。服务器资源繁忙时可能需要排队。
- 打开工作区,选择预生成地形和KMOU waterfront · 1 × 1 km。
- 在区域地形 → 载具中选择WAM-V、深度0 m和Autopilot。
- 选择启动生成的世界,等待载具和最新位置数据出现。应用的初始设置窗口会一直保留到世界启动成功。

| 入口 | 用途 |
|---|---|
| 演示世界 | 启动WAM-V或BlueROV2;其他预览会标明可用状态。 |
| 预生成地形 | 汇总已就绪、可下载以及已经生成完成的地形。 |
| 练习场 | 在可用时准备练习任务。 |
| 自定义世界 | 打开区域地形、载具编辑器、RViz工具和存储管理。 |
| 位置 → 载具 → 检查 | 选择地形、载具和初始位姿,在启动前检查配置。 |
Autopilot与ROS 2直接控制在启动前选择。要切换控制方式,请用另一种方式启动世界。ArduPilot模式切换是另一项操作。坐标和深度必须在字段允许范围内。练习随机种子为0~1,000,000的整数,留空则自动生成布局。自由探索和管理员基准运行不使用自定义练习种子。
Mac应用首次选择准备好的地形时会下载并显示进度。之后可离线使用,并保留固定的内容修订版。下载失败时检查网络后重新选择。WAM-V演示使用香港地形:珊瑚色浮标位于前方16 m、左侧5 m,青柠色浮标位于前方30 m、右侧8 m。可以用前视相机和LiDAR观察。
认识界面

| 区域 | 内容 |
|---|---|
| 顶栏 | 载具、地形、实时状态、工作区、语言,以及放大场景和显示面板的按钮。启用使用时长管理时还会显示会话。 |
| 中央 | 载具、世界和地图视图。 |
| 左侧 | 场景设置环境与显示;传感器和ROS话题查看测量数据。 |
| 右侧 | ArduPilot或ROS 2控制,下方为载具仪表和曲线。 |
| 下方地图 | 地面控制显示地理位置、航点和任务操作。 |
点击标题或+/−展开、折叠。内容在可用高度内滚动,必要时其他区域会自动收起。面板显示或隐藏侧栏;专注场景放大场景,同时保留地图入口。仿真会继续运行。初始入口还提供返回主页和退出登录。
| 视图或操作 | 效果 |
|---|---|
| 载具 | 跟随载具,可绕其旋转并缩放。 |
| 世界 | 以倾斜视角观察附近环境,缩放与旋转有范围限制。 |
| 地图 | 北向上的地理地图和仿真位置,拖动可平移。 |
| 拖动、右键拖动、滚轮 | 按当前视图提示平移、环绕或缩放。 |
| 清除轨迹 | 清除画面中的规划路线与实际轨迹;从当前位置继续记录,并保留任务报告。 |
底部罗盘表示观察相机的朝向,不是载具航向。固定箭头指向相机前方,方位字母转动以标出北方。时间为仿真时间,1.00×表示与实际时间等速。
规划路线为黄色,实际轨迹为青绿色,最多显示1,024段,随后替换最旧的部分。新引导任务会清除Gazebo轨迹。场景中宽5 mm的轨迹线不会出现在传感器图像里。
场景、波浪与海流

| 分区 | 操作 |
|---|---|
| 波浪 | 选择0~4级海况并应用。高级设置可修改风速、风向和波陡。 |
| 海流 | 启用海流,选择均匀流或深度剖面,再点击应用海流并等待求解器确认。 |
| 海上交通 | 根据近期AIS报告显示船舶,取决于覆盖范围和仿真速度。 |
| 场景渲染器 | 在可用时选择Browser或Gazebo,并打开水下外观设置。 |
| 显示 | 海底、海面、网格、坐标轴,以及当前视图支持的照明和水体、地图不透明度。 |
| 图形性能 | 显示浏览器渲染的实测统计。 |
自由工作区默认海况2。预设风速为0、1、3、6、8 m/s,波陡为1。这些是风驱动近似设置,并不保证达到指定波高。信息按钮说明WMO波高范围。练习任务保留分配的环境条件。
修改海流前先停止任务或ROS控制。剖面从0 m深度开始,最多8个节点,流速0~1 m/s。水平拖动节点修改速度,用表格编辑深度与方向。方向表示水流流向,0°为东、90°为北。每个物理步都会按各连杆的实际深度对流速向量做线性插值;最深节点以下保持该节点的流速。海流改变相对水速与阻力,波浪仍由独立模型计算。
安装版默认打开Gazebo。选择Browser可以减轻Gazebo场景相机的负担;物理、传感器相机和GPU LiDAR仍由Gazebo计算。选择在当前视图打开期间有效。BlueROV2跟随相机会平滑运动并显示海面;支持的视图可通过竖直拖动转到载具下方观察。
水下外观
打开场景 → 场景渲染器 → 水下外观。设置会实时作用于Gazebo场景和相机彩色图像,包括RGBD彩色通道。深度数值与碰撞几何保持不变。
- 沙地纹理、雾化、颜色吸收、随深度减弱的日光和海底光纹:默认开启。
- 网格、等深线、悬浮颗粒:默认关闭;网格间距10 m,等深线间距5 m。
- BlueROV2 KMOU演示默认开启悬浮粒子,关闭随深度变化的阳光衰减。安装版应用中保存的设置优先于这些演示默认值。
- 水体光学开关统一切换光学效果,纹理与测量线仍可单独设置。
- 安装版保存已经确认的偏好;服务器会话从默认值开始。评分期间不能修改。
Gazebo呈现全部效果,Browser共享沙地细节和海底线设置。视觉模型使用平坦的平均海平面和PBR表面。无光照材质与自定义水面着色器有各自的外观。颗粒与光纹是视觉近似。有效可视距离除了几何裁剪范围,还受雾化、衰减和遮挡影响。参阅技术规格和海洋动力学与渲染。
传感器与ROS话题

在传感器中展开载具,选择相机、LiDAR或IMU。可用传感器取决于模型。向下的检查相机可用于观察海底。
| 控件 | 功能 |
|---|---|
| 开始/停止传输 | 控制该图像流的接收,仿真继续运行。 |
| 放大/保存帧 | 放大图像或保存收到的帧。 |
| 传感器频率 | 请求支持的传输频率;实测指示显示实际接收频率。 |
| 数字缩放/重置 | 放大收到的图像或恢复原倍率。 |
| ROS话题 → 搜索 → 话题 | 打开消息,通过订阅或取消订阅控制接收。 |
| 字段/曲线/原始数据/绘制 | 根据消息类型和坐标系显示数值字段或支持的空间消息。 |
场景相机是外部观察者。传感器相机遵循在载具上的安装位姿,因此两者可能朝向不同方向。
图像流状态
连接中或等待中表示传感器或传输通道正在准备。也请检查接收时间。标记为过期或重连中的保留图像不是新测量。先确认世界已就绪、传感器选择正确。
香港公开演示使用共享H.264视频,需要初始缓冲。个人相机请求JPEG图像;ROS压缩图像使用另一条传输路径。保存帧在演示中截取正在显示的视频画面,在个人面板中保存收到的图像文件。传感器Hz、视频FPS和实时因子是不同指标。参阅仿真、渲染与传感器架构和使用 RViz 和 Foxglove 查看数据。
ArduPilot与手动控制


先检查遥测、解锁状态和标题中的实际模式。将手动输入回中,结束或中止任务后再切换模式。选择运行模式并应用,然后核对返回值。下拉框表示请求,不代表模式已生效。
解锁通过准备检查后启用推进;锁定禁用推进并取消任务。选择模式本身不会解锁载具。指令被拒绝时阅读错误和连接详情;相机有画面不代表控制已就绪。
| 载具 | 菜单模式 |
|---|---|
| WAM-V · ArduRover | MANUAL:直接控制油门和转向。HOLD:推进归中,但惯性、波浪和海流仍可能使其移动。STEERING:反馈辅助的速度和转向控制。 |
| BlueROV2 · ArduSub | MANUAL:直接控制。STABILIZE:稳定姿态,深度由手动控制。ALT_HOLD:增加定深,不保持水平位置。 |
已检查的任务会在启动时请求GUIDED并解锁。该模式由任务管理,不是手动菜单选项。参阅自动驾驶任务。

启用摇杆输入,选择鼠标/触摸或游戏手柄。WAM-V提供油门与转向,BlueROV2还提供横移和升降。以低增益和回中输入开始。停止输入取消当前按压,松开后重新按下才能继续。失去焦点、上锁、更换输入源或指令被拒绝也会结束按压。
使用手柄时,按住LB/L1再操作摇杆。松开发送中立输入,不会自动上锁,也不能使运动中的载具瞬间停止。BlueROV2的Y/三角形请求ALT_HOLD,A/叉号请求STABILIZE。请核对返回的模式。完整映射见手动操作与游戏手柄。
地图与任务
新建水下航点的默认深度为 2 m。常规范围为 0–10 m;对于受支持的观测场景,请查看服务器显示的任务深度限制。

检查路线前先填完整坐标和深度。水面航点深度为0 m,地图中每个航点停留1秒。编辑时空白字段会保持空白。
| 操作 | 效果 |
|---|---|
| 单击/右击 | 添加航点/删除附近航点。拖动、滚轮或双指缩放操作地图。 |
| 返回起点/清除 | 设置返航/清除可编辑航点。 |
| 检查路径 | 生成经过地形检查的预览,核对路径、余量和阻止原因。 |
| 执行路线 | 启动已检查路线,通过准备检查后解锁。 |
| 停止/继续/中止 | 保持等待目标/继续/取消并上锁。 |
再次运行前要重新检查,因为载具可能已经移动。地图航点优先于预设场景;使用预设前先清除航点。检查针对地形和船体净空,不保证动态船舶避碰或COLREG合规。参阅自动驾驶任务。
载具仪表

固定蓝色标记表示载具,移动地平线表示横滚和俯仰。航向采用0°北、90°东、180°南、270°西。深度为相对海面零点的−Z,水下为正,水上为负;它不是离海底的距离。
曲线保存最近100个收到的位姿样本,可选深度、航向、俯仰、横滚、速度或推力输入。深度、姿态和速度来自仿真器。速度以载具坐标表示,X向前、Y向左、Z向上,单位m/s。推力是N单位的请求指令,不是实测力。缺失或过期数据表现为空段或—。深度与姿态使用同一样本和时间,演示中会与视频同步。
仿真速度与物理步长
选择后立即提交请求,请等待应用确认。
| 设置 | 取值 |
|---|---|
| 请求速度 | 0.25×、0.5×、1×、2×、4× |
| 物理步长 | 5、10、20 ms;世界已使用30 ms时也会显示30 ms |
| 实际 | 仿真时间除以实际时间,可能低于请求值 |
载具必须上锁,任务、手动和ROS控制输入均已停止,地形也必须准备完成。超过1×时AIS不可用。Windows和Linux默认20 ms,Mac原生版默认10 ms。练习任务保留要求的10 ms。参阅自定义世界。
位置与连接
N/E/D表示相对本地原点的北、东、下方向距离,单位m。地理坐标按纬度、经度排列,单位为度。R/P/Y · ENU为原始角度,其中偏航0°朝东、90°朝北。仪表将俯仰显示为−P,航向显示为(90 − Y + 360) % 360。
连接详情显示位置序号、消息年龄和ENU坐标系。序号递增且消息新鲜,说明还在收到新数据。控制面板有独立的连接诊断。RViz操作在应用中打开原生RViz2,在Web中打开浏览器查看器。世界需要就绪,安装版还要求RViz服务可用。参阅使用 RViz 和 Foxglove 查看数据。ArduPilot参数在专用面板中读取、导出和编辑;允许的修改需在上锁时应用,并通过回读验证。
ROS 2直接控制

启用ROS后,连接的控制器可以发送有界指令。停止ROS会保持中立输出,直到再次启用。诊断显示原因、已应用序号、确认信息和推力。指令中断时,看门狗会将输出恢复中立。继续阅读ROS 终端与连接、控制网页工作区或控制桌面版工作区。
保存与转移资源
在工作区 → 自定义世界 → 存储中查看地形、载具修订版、世界配置、缓存和磁盘空间。归档只会隐藏资源,保留文件,不释放空间;恢复后可再次选择。请等待使用这些资源的会话结束。
导出/导入ZIP可转移载具及资源。编辑副本会创建新修订版。启动前也可以下载载具和世界SDF,修改后上传兼容修订版。参阅准备自定义载具、自定义载具和自定义世界。
小屏幕与等待状态
手机底部按钮一次打开一个可滚动面板,用×或Escape返回场景。横屏时面板放在场景控件旁。公开演示的桌面视图会整体缩放布局,竖屏时提示旋转手机。全屏取决于浏览器支持和用户操作。
按钮禁用通常表示准备未完成、地形等待中、任务正在运行或指令处理中。重试前先读状态。隐藏面板、清除轨迹、停止图像或取消订阅都不会停止载具。使用结束后请结束会话。关闭安装版会停止本地服务与地形生成,并保留已保存的数据。
AIS凭据
演示使用服务器配置的AISStream密钥。没有密钥时,安装版演示使用Open Waters公开AIS数据流。面板显示提供方和连接状态,可见船舶取决于近期收到的报告。
自定义世界需在场景 → 海上交通中输入自己的密钥并在本地保存。密钥保存在当前浏览器中,也会发送给所选仿真服务器。删除本地密钥会将其从浏览器移除。启用海上交通即可连接。参阅仿真、渲染与传感器架构。
使用 QGC 控制
对于 Autopilot 载具,选择 ArduPilot 面板中的 Open QGC。保持桌面版应用和已登录的工作区打开。连接对话框会准备载具,并将控制权交给 QGroundControl。安装、连接和释放控制权请参阅使用 QGC 控制。
BlueROV2前照灯
在操纵杆控制中使用前照灯同时切换BlueROV2两盏灯的ON/OFF。回读确认实际灯光状态;失败或不可用的命令不会显示成功。载具照明与场景昼夜及相机选择相互独立。