Geo Player 用户操作手册

一、平台简介

1.1 产品概述

Geo Player（无人机视频轨迹回放系统）是一款专业的无人机航拍视频回放与轨迹同步分析平台。该平台实现了无人机飞行视频与三维地球的双向联动，支持将地理矢量数据实时叠加到视频画面上，为用户提供直观的飞行轨迹可视化与分析能力。

1.2 核心特性

特性描述视频轨迹同步视频播放时实时同步显示无人机飞行轨迹，点击地球轨迹点可跳转视频时间三维地球可视化基于 Cesium 引擎的三维地球，支持天地图影像底图与地形数据视锥可视化实时显示无人机相机视锥范围，直观呈现拍摄视野矢量叠加将地理矢量数据实时叠加到视频画面，实现地理坐标与视频像素的精确映射矢量绘制支持在地球上绘制点、线、面等矢量图形矢量导入支持导入WGS84坐标的KML、GeoJSON、Shapefile 等标准格式

1.3 技术架构

技术版本用途Vue2.7.16前端框架Vite5.4.11构建工具Cesium-三维地球引擎Element UI2.15.14UI组件库@turf/turf7.3.5地理计算库geo_overlay_js-地理投影SDK

二、支持的数据标准

2.1 视频格式

格式说明MP4主视频格式，支持标准H.264/H.265编码MOVQuickTime格式（部分支持）AVI传统视频格式（部分支持）

2.2 DJI SRT 字幕格式

支持 DJI 大疆无人机生成的标准 SRT 字幕文件，包含完整的飞行元数据：

1 00:00:00,033 --> 00:00:00,100 FrameCnt: 1 [2026-03-10 15:42:29.234] [latitude: 32.568629] [longitude: 120.963933] [rel_alt: 6.383 abs_alt: 20.604] [gb_yaw: 41.1 gb_pitch: -90.0 gb_roll: 0.0] [dzoom_ratio: 1.00] 解析字段说明：

字段含义示例latitudeGPS 纬度32.568629longitudeGPS 经度120.963933rel_alt相对高度（起飞点）6.383abs_alt绝对高度（海拔）20.604gb_yaw云台偏航角41.1gb_pitch云台俯仰角-90.0gb_roll云台横滚角0.0dzoom_ratio数字变焦比例1.00FrameCnt帧计数1dateTime采集时间2026-03-10 15:42:29.234

2.3 矢量数据格式

格式说明支持要素类型KMLGoogle Earth标准格式Point、LineString、PolygonGeoJSON开放地理数据格式Point、MultiPoint、LineString、MultiLineString、Polygon、MultiPolygonShapefileESRI标准格式点、线、面图层

三、支持的无人机型号

平台支持 DJI 大疆主流行业无人机型号：

型号代码型号名称payload_index支持镜头M3EMavic 3 Enterprise66-0-0广角、长焦M3TMavic 3 Thermal67-0-0广角、长焦、红外M3DMavic 3D80-0-0广角、长焦M3TDMavic 3 Thermal Dock81-0-0广角、长焦、红外M4EMatrice 4 Enterprise88-0-0广角、变焦、长焦M4TMatrice 4 Thermal89-0-0广角、变焦、长焦、红外M4DMatrice 4D98-0-0广角、变焦、长焦M4TDMatrice 4 Thermal Dock99-0-0广角、变焦、长焦、红外

注意：选择正确的无人机型号非常重要，这决定了相机 FOV（视场角）和投影参数的正确解析，直接影响视锥显示和矢量叠加的准确性。

四、平台功能列表

4.1 视频播放功能

功能说明视频加载支持 MP4 等主流视频格式视频控制播放、暂停、进度调节、全屏SRT同步自动加载同名 SRT 文件，解析飞行数据实时信息显示当前 GPS 坐标、高度、云台角度

4.2 三维地球功能

功能说明天地图底图卫星影像 + 中文注记地形数据Mars3D 地形服务，真实地形起伏状态栏实时显示鼠标位置坐标、海拔、比例尺轨迹渲染青色已播放段 + 灰色未播放段 + 当前位置标记悬停信息鼠标悬停轨迹显示时间、坐标、高度视锥显示四棱锥可视化相机视野范围

4.3 矢量管理功能

功能说明矢量绘制点、线、多边形交互绘制矢量导入KML、GeoJSON、Shapefile 格式导入图层管理显示/隐藏、排序、删除、重命名符号化编辑颜色、大小、透明度、线型、填充等样式调整视频叠加地球矢量实时叠加到视频画面

4.4 双向联动功能

功能说明视频驱动地球视频播放时地球自动同步到当前位置地球驱动视频点击地球轨迹点，视频跳转到对应时间分屏联动视频与地球分屏显示，可拖拽调整比例

五、平台使用指南

5.1 系统访问

5.1.1 开发环境启动

访问地址：登录http://www.uav-tools.com/，选择GIS视频增强工具

5.1.2 登录验证

需要用户登录验证

未登录用户3秒后自动跳转首页

5.2 首次使用流程

步骤一：选择无人机型号

首次进入平台，系统会提示选择无人机型号：

点击型号下拉框，选择您的无人机型号（如 M4TD）

确认型号信息正确

点击「确认选择」按钮

提示：型号选择后可在运行过程中切换，但切换会重新初始化叠加引擎。

步骤二：加载视频和SRT文件

自动匹配方式（推荐）：

点击「选择视频/SRT」按钮

同时选择 MP4 视频文件和同名 SRT 文件

系统自动加载视频并解析轨迹

单独加载方式：

先点击「选择视频/SRT」加载 MP4 文件

如 SRT 未自动加载，点击「单独加载SRT」

选择对应的 .SRT 文件

命名约定：视频和SRT文件同名即可自动匹配，如 DJI_001.MP4 和 DJI_001.SRT

步骤三：开始播放分析

视频加载完成后：

点击播放按钮开始视频播放

右侧地球自动飞向轨迹起点

观察轨迹同步和视锥显示

5.3 视频播放操作

5.3.1 视频控制条

位于视频底部，提供以下控制：

按钮功能▶ / ⏸播放 / 暂停进度条拖拽调整播放时间🔊音量控制⛶全屏切换

5.3.2 SRT信息显示

视频下方实时显示当前帧的飞行数据：

GPS坐标：经度、纬度（度格式）

高度：相对高度（米）

云台角度：偏航角(Y)、俯仰角(P)

5.4 三维地球操作

5.4.1 基础交互

操作方式平移左键拖拽旋转右键拖拽或双指拖拽缩放滚轮或双指捏合倾斜中键拖拽或双指上下滑动

5.4.2 轨迹交互

点击轨迹跳转视频：

将鼠标移至轨迹线（灰色/青色线条）

悬停显示信息气泡（时间、坐标、高度）

左键点击轨迹线

视频自动跳转到对应时间点

轨迹颜色含义：

颜色含义灰色半透明未播放轨迹段青色亮色已播放轨迹段白点标记当前位置

5.4.3 视锥控制

位于地球左下角的视锥控制面板：

控件功能视锥显示复选框开启/关闭视锥可视化长度滑块调整视锥长度（1-5000米）

视锥颜色含义：

橙色半透明锥体：相机视野范围

橙色边线：锥体轮廓

橙色顶点标记：无人机位置

5.5 矢量绘制操作

5.5.1 绘制面板

位于地球左侧的「矢量绘制」面板：

按钮功能📍 点按钮绘制点要素➖ 线按钮绘制线要素🔺 多边形按钮绘制面要素取消取消当前绘制清空清空所有绘制

5.5.2 绘制点要素

点击「点」按钮进入绘制模式

鼠标变为十字光标

单击地球表面添加点

弹出保存对话框

输入图层名称和要素名称

点击「确定」保存

5.5.3 绘制线要素

点击「线」按钮进入绘制模式

连续单击添加节点

双击结束绘制

在对话框中命名并保存

提示：至少需要2个点才能绘制线。

5.5.4 绘制多边形要素

点击「多边形」按钮进入绘制模式

连续单击添加顶点

双击闭合多边形

在对话框中命名并保存

提示：至少需要3个点才能绘制多边形。

5.5.5 取消/清空绘制

右键点击：取消当前绘制操作

取消按钮：退出绘制模式

清空按钮：清除所有已绘制要素（会提示确认）

5.6 矢量导入操作

5.6.1 打开导入对话框

点击右侧「矢量图层」面板中的「导入矢量文件」按钮。

5.6.2 导入步骤

选择文件：

拖拽文件到上传区域

或点击上传区域选择文件

支持格式：.kml、.geojson、.json、.shp

查看解析结果：

文件名、大小、类型

要素数量统计（点/线/面）

预览确认

命名图层：

默认使用文件名

可自定义图层名称

完成导入：

点击「导入」按钮

图层自动添加到地球显示

5.6.3 导入提示

解析成功显示绿色提示框

解析失败显示红色错误信息

空文件提示「没有找到有效要素」

5.7 矢量图层管理

5.7.1 图层列表操作

位于右侧「矢量图层」面板：

操作说明☑ 复选框显示/隐藏图层⬆⬇ 拖拽调整图层顺序（上层叠加优先显示）✏ 编辑按钮打开符号化编辑对话框🗑 删除按钮删除图层（需确认）

5.7.2 图层信息显示

每个图层项显示：

图层类型图标（点/线/面）

图层名称

要素数量

5.8 矢量符号化编辑

5.8.1 打开符号编辑器

点击图层右侧的编辑按钮（铅笔图标）。

5.8.2 点符号设置

属性设置方式颜色颜色选择器大小滑块（4-24像素）透明度滑块（0-100%）

5.8.3 线符号设置

属性设置方式颜色颜色选择器线宽滑块（1-10像素）透明度滑块（0-100%）线型下拉选择（实线/虚线/点线）

5.8.4 面符号设置

属性设置方式填充色颜色选择器填充透明度滑块（0-100%）边框色颜色选择器边框宽度滑块（1-10像素）边框透明度滑块（0-100%）

5.8.5 实时预览

符号编辑对话框底部有实时预览画布，直观显示符号效果。

5.8.6 保存设置

点击「确定」应用设置

点击「取消」放弃修改

点击「重置」恢复默认符号

5.9 视频矢量叠加

5.9.1 自动叠加机制

当矢量图层显示（复选框勾选）时：

地球上的矢量自动叠加到视频画面

使用地理投影算法将坐标转换为视频像素

实时跟随视频视角变化更新

5.9.2 投影原理

地理坐标 → ENU坐标 → 相机投影 → 视频像素 → 容器像素 投影参数来源：

参数来源视频原始尺寸video.videoWidth/videoHeight容器尺寸Canvas 显示尺寸相机位置/姿态SRT 字幕数据相机 FOV无人机型号配置

5.9.3 图层顺序影响

图层列表顺序决定叠加显示顺序：

列表上层 = 视频画面上层

拖拽调整顺序可改变叠加层级

5.10 分屏布局调整

5.10.1 拖拽分隔条

视频和地球之间有可拖拽分隔条（⋮ 符号）：

鼠标移至分隔条，变为双向箭头

左键拖拽调整左右比例

范围限制：20% - 80%

5.10.2 布局建议

场景建议比例视频分析为主视频 60%，地球 40%地球探索为主视频 30%，地球 70%平衡查看视频 50%，地球 50%

5.11 状态栏信息

地球底部状态栏实时显示：

信息说明经度鼠标位置经度（度格式，6位精度）纬度鼠标位置纬度（度格式，6位精度）高度鼠标位置海拔高度（米）比例尺当前视图比例尺（如 1:1000）

六、常见问题解答

Q1: SRT 文件无法自动加载？

原因：视频和 SRT 文件名不一致。

解决方案：

确保 MP4 和 SRT 文件同名（如 DJI_001.MP4 和 DJI_001.SRT）

或使用「单独加载SRT」功能手动选择

Q2: 视锥显示位置不对？

原因：无人机型号选择错误。

解决方案：

确认当前型号与实际飞行设备匹配

在顶部工具栏重新选择正确型号

Q3: 矢量叠加不显示？

原因：图层未显示或视频未加载 SRT。

解决方案：

检查图层复选框是否勾选

确保 SRT 已加载（轨迹线可见）

检查矢量坐标是否在轨迹范围内

Q4: 绘制时无法添加点？

原因：相机控制与绘制冲突。

解决方案：

绘制模式下自动禁用相机平移

确保点击地球表面（非空白区域）

右键取消后重新进入绘制模式

Q5: 导入 Shapefile 失败？

原因：Shapefile 需完整文件集。

解决方案：

确保 .shp 文件同目录有 .dbf 和 .shx 文件

或使用 GeoJSON/KML 格式（单文件更方便）

七、技术支持

7.1 日志查看

开发者可查看浏览器控制台日志：

[VideoPlayer] 视频播放相关日志

[CesiumGlobe] 地球渲染相关日志

[TrajectoryLayer] 轨迹渲染日志

[FrustumLayer] 视锥计算日志

7.2 相关项目

项目说明geo_overlay_js地理投影 SDKairspace-map空域地图系统

八、版本信息

文档版本：v1.0

更新日期：2026-04-28

适用平台版本：Geo Player 1.0

内部使用项目 - 仅供授权用户使用