船讯网视频监控场景应用指南

文档版本：V1.0
适用版本：船讯网 API V3.0+
更新日期：2026-07-10
技术支持：service@shipxy.com | 400-010-8558

场景1：货物运输防盗智能监控

业务描述

在货物运输过程中，尤其是在夜间靠泊或锚地等待期间，存在货物被盗的风险。通过在货舱、甲板等关键位置安装摄像头，利用AI智能识别能力，自动检测疑似偷盗行为并实时告警，有效降低货损风险。

适用对象

货主/贸易商

航运物流企业

保险公司

涉及接口

接口	用途
`GetShipDevicesStatus`	查询船舶设备状态
`GetVShipAiEvents`	查询疑似偷盗事件记录
`VShipSubscribeSet`	订阅船舶事件推送
`GetVShipPreview`	查看实时视频确认情况

实现步骤

步骤1：确认设备绑定状态

调用设备状态查询接口，确认监控船舶的摄像头已正常绑定且在线。

GET /apicall/v3/GetShipDevicesStatus?key={API Key}&mmsi={船舶MMSI}

步骤2：订阅事件推送

将需要监控的船舶添加到事件订阅列表，开通疑似偷盗事件识别权限。

POST /apicall/v3/VShipSubscribeSet?key={API Key}&mmsi={船舶MMSI}&cell={手机号}

步骤3：接收疑似偷盗事件推送

当AI检测到疑似偷盗行为时，系统会实时推送事件数据：

{
  "ship_name": "粤新会货8233",
  "mmsi": 413904861,
  "device_name": "货舱",
  "type_name": "疑似偷盗",
  "description": "携带装载容器",
  "event_time": "2025-07-01 23:00:00",
  "position": "广州市番禺区",
  "beginNaviStat": "靠泊",
  "img_url": "https://open.ys7.com/api/lapp/mq/downloadurl?...",
  "sog": 0
}

步骤4：实时视频确认

收到疑似偷盗事件后，立即调用实时视频接口查看现场画面，确认是否存在真实偷盗行为。

GET /apicall/v3/GetVShipPreview?key={API Key}&mmsi={船舶MMSI}

步骤5：历史事件查询与统计

定期查询历史疑似偷盗事件，进行统计分析：

GET /apicall/v3/GetVShipAiEvents?key={API Key}&mmsi={船舶MMSI}&start_time={开始时间戳}&end_time={结束时间戳}

预期效果

🛡️ 货物运输防盗监控报告
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📊 监控概览
  监控船舶: 粤新会货8233 (MMSI: 413904861)
  监控摄像头: 货舱×1、驾驶台×1、左舷×1
  监控时段: 2025-07-01 至 2025-07-10

🚨 疑似偷盗事件统计: 3 次

  事件1:
  ├─ 时间: 2025-07-01 23:00:00
  ├─ 类型: 疑似偷盗 - 携带装载容器
  ├─ 位置: 广州市番禺区 (靠泊状态)
  ├─ 处理结果: ✅ 经实时视频确认，为正常作业人员

  事件2:
  ├─ 时间: 2025-07-03 02:15:00
  ├─ 类型: 疑似偷盗 - 小船搭靠
  ├─ 位置: 锚地等待区
  ├─ 处理结果: ⚠️ 非计划内搭靠，已通知船长核实

  事件3:
  ├─ 时间: 2025-07-05 01:30:00
  ├─ 类型: 疑似偷盗 - 携带推铲工具
  ├─ 位置: 码头靠泊
  ├─ 处理结果: ✅ 码头正常卸货作业

📈 安全评估:
  • 疑似事件识别准确率: 100% (3/3 经确认)
  • 真实偷盗风险: 未发现
  • 建议: 继续保持监控，重点关注夜间靠泊时段

场景2：船舶实时动态监控

业务描述

通过定时截图和实时视频查看功能，随时掌握船舶的航行状态、位置信息和船上动态。适用于货主追踪货物运输进度、企业监控船舶运营状态等场景。

适用对象

货主/贸易商

航运物流企业调度部门

船舶管理公司

涉及接口

接口	用途
`GetShipDevicesStatus`	查询设备状态
`GetVShipPreview`	获取实时视频
`GetVShipImgs`	查询定时截图

实现步骤

步骤1：查询设备状态

GET /apicall/v3/GetShipDevicesStatus?key={API Key}&mmsi={船舶MMSI}

步骤2：获取实时视频画面

GET /apicall/v3/GetVShipPreview?key={API Key}&mmsi={船舶MMSI}

返回的URL在浏览器中打开即可查看实时视频。

步骤3：查询历史截图轨迹

通过定时截图记录，回溯船舶在指定时间段内的位置变化和船上状态：

GET /apicall/v3/GetVShipImgs?key={API Key}&mmsi={船舶MMSI}&start_time={开始时间戳}&end_time={结束时间戳}

预期效果

🚢 船舶实时动态监控报告
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 船舶信息
  船名: 粤新会货8233
  MMSI: 413904861
  当前状态: 靠泊 - 广州市番禺区

📹 摄像头状态
  ├─ 驾驶台摄像头: 🟢 在线
  ├─ 左舷摄像头: 🟢 在线
  └─ 货舱摄像头: 🔴 离线

🎥 实时画面
  ├─ 驾驶台: [实时视频URL] - 可正常查看
  ├─ 左舷: [实时视频URL] - 可正常查看
  └─ 货舱: 设备离线，无法查看

📸 最近定时截图记录 (共 72 张/24小时)

  最新截图: 2025-07-01 21:21:00
  ├─ 位置: 113.527933°E, 23.014968°N
  ├─ 位置描述: 广州市番禺区
  └─ 画面: 船舶靠泊码头，甲板无异常活动

  24小时轨迹概览:
  ├─ 00:00 - 06:00: 锚地等待，船舶静止
  ├─ 06:30: 开始进港
  ├─ 07:15: 靠泊完成，开始卸货
  └─ 07:15 - 现在: 码头靠泊作业中

⚠️ 关注事项
  • 货舱摄像头离线，建议检查设备网络连接
  • 当前处于卸货作业阶段，建议加强监控

场景3：船舶设备运维管理

业务描述

对船舶上的摄像头设备进行统一的运维管理，监控设备在线/离线状态，及时发现并处理设备故障，确保视频监控系统的持续可用性。

适用对象

IT运维人员

船舶管理公司技术部门

设备管理人员

涉及接口

接口	用途
`GetShipDevicesStatus`	批量查询设备状态
`GetVShipAiEvents`	查询设备离线事件

实现步骤

步骤1：建立船舶-设备清单

维护管理的船舶清单，定期轮询各船舶的设备状态。

步骤2：批量查询设备状态

对管辖范围内的所有船舶进行设备状态查询：

GET /apicall/v3/GetShipDevicesStatus?key={API Key}&mmsi={船舶1 MMSI}
GET /apicall/v3/GetShipDevicesStatus?key={API Key}&mmsi={船舶2 MMSI}
...

步骤3：离线事件统计

查询设备离线事件，分析离线频率和时长：

GET /apicall/v3/GetVShipAiEvents?key={API Key}&mmsi={船舶MMSI}&start_time={本周开始}&end_time={本周结束}

按事件类型筛选"设备离线"记录。

预期效果

🔧 船舶设备运维管理报告
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📊 设备总览 (管辖船舶: 15 艘，摄像头: 42 个)

  🟢 在线设备: 38 个 (90.5%)
  🔴 离线设备: 4 个 (9.5%)

⚠️ 离线设备详情

  设备1:
  ├─ 所属船舶: 粤新会货8233 (MMSI: 413904861)
  ├─ 设备ID: FE9129884
  ├─ 安装位置: 驾驶台
  ├─ 离线时长: 2小时15分钟
  └─ 建议: 检查设备电源和网络连接

  设备2:
  ├─ 所属船舶: 皖鸿远369 (MMSI: 413961925)
  ├─ 设备ID: FM5047482
  ├─ 安装位置: 左舷
  ├─ 离线时长: 5分钟
  └─ 状态: 可能为临时网络波动，持续观察

📈 本周离线事件统计

  总离线事件: 12 次
  ├─ 网络原因: 8 次 (67%)
  ├─ 电源原因: 2 次 (17%)
  └─ 未知原因: 2 次 (16%)

  平均离线恢复时间: 45 分钟

✅ 运维建议
  1. 重点关注粤新会货8233驾驶台设备，离线超过2小时
  2. 建议为离线的2艘船舶安排远程或现场检修
  3. 本周离线率较上周上升3%，需关注网络稳定性

场景4：港口装卸货作业监管

业务描述

在港口装卸货作业期间，通过摄像头监控作业过程，自动识别开关舱门事件和人员入侵事件，帮助货主和物流企业远程监管装卸货作业规范性和安全性。

适用对象

货主/贸易商

港口运营方

航运物流企业

涉及接口

接口	用途
`GetVShipAiEvents`	查询开关舱门、人员入侵事件
`GetVShipPreview`	实时查看作业画面
`GetVShipPlayback`	回放历史作业视频

实现步骤

步骤1：订阅作业船舶事件

POST /apicall/v3/VShipSubscribeSet?key={API Key}&mmsi={船舶MMSI}

步骤2：接收开关舱门事件

当舱门被打开或关闭时，系统自动推送事件：

{
  "ship_name": "粤新会货8233",
  "mmsi": 413904861,
  "device_name": "货舱",
  "type_name": "开关舱门",
  "event_time": "2025-07-01 08:30:00",
  "position": "广州港",
  "beginNaviStat": "靠泊",
  "sog": 0
}

步骤3：查询作业期间完整事件记录

GET /apicall/v3/GetVShipAiEvents?key={API Key}&mmsi={船舶MMSI}&start_time={作业开始时间}&end_time={作业结束时间}

预期效果

⚓ 港口装卸货作业监管报告
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 作业船舶: 粤新会货8233 (MMSI: 413904861)
📍 作业港口: 广州港
📅 作业时间: 2025-07-01 08:00 - 2025-07-01 14:30

📊 作业事件记录

  08:30:00 - 开关舱门 (货舱)
  ├─ 舱门开启，开始卸货作业

  08:32:15 - 人员入侵 (甲板)
  ├─ 作业人员进入监控区域
  ├─ 判定: ✅ 正常作业人员

  08:45:00 - 人员入侵 (货舱)
  ├─ 多名人员同时出现在货舱区域
  ├─ 判定: ✅ 正常卸货作业

  12:00:00 - 开关舱门 (货舱)
  ├─ 舱门关闭，午休暂停作业

  13:00:00 - 开关舱门 (货舱)
  ├─ 舱门开启，下午继续作业

  14:28:30 - 开关舱门 (货舱)
  ├─ 舱门关闭，卸货完成

✅ 作业规范评估
  • 开关舱门记录完整: 是
  • 异常人员活动: 未发现
  • 作业时长: 约 6.5 小时 (含午休1小时)
  • 整体评估: 作业规范，无异常

场景5：历史追溯与取证

业务描述

当发生货物损坏、数量争议或安全事故时，需要通过历史视频录像和定时截图进行回溯取证，获取事故发生时的一手证据材料。

适用对象

保险公司理赔部门

货主/贸易商

航运物流企业安全部门

海事调查机构

涉及接口

接口	用途
`GetVShipAiEvents`	查询事件记录，确定回溯时间点
`GetVShipPlayback`	获取历史视频回放
`AddPlaybackRecordTask`	创建视频录制下载任务
`PlaybackRecordTaskQuery`	查询录制任务状态和下载地址
`GetVShipImgs`	查询事件发生时的定时截图

实现步骤

步骤1：确定回溯时间段

通过事件查询接口，找到需要回溯的关键事件时间点：

GET /apicall/v3/GetVShipAiEvents?key={API Key}&mmsi={船舶MMSI}&start_time={起始时间}&end_time={结束时间}

步骤2：获取历史视频回放

GET /apicall/v3/GetVShipPlayback?key={API Key}&mmsi={船舶MMSI}&start_time={事件前10分钟}&end_time={事件后10分钟}

步骤3：录制视频用于存档

如需下载视频作为证据存档，创建录制任务：

POST /apicall/v3/AddPlaybackRecordTask?key={API Key}&device_id={设备序列号}&task_id={自定义任务ID}&start_time=20250701082000&end_time=20250701085000

等待10-15分钟后查询任务状态：

GET /apicall/v3/PlaybackRecordTaskQuery?key={API Key}&task_id={自定义任务ID}

状态为1（成功）时，获取下载地址进行下载。

步骤4：获取定时截图佐证

GET /apicall/v3/GetVShipImgs?key={API Key}&mmsi={船舶MMSI}&start_time={事件时间-1小时}&end_time={事件时间+1小时}

预期效果

📁 历史追溯与取证报告
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 取证事件
  船舶: 粤新会货8233 (MMSI: 413904861)
  事件类型: 货物损坏争议
  争议时间: 2025-07-01 08:30 左右
  争议地点: 广州港码头

📹 视频证据

  1. 历史回放视频
  ├─ 时间段: 2025-07-01 08:20 - 08:50
  ├─ 时长: 30 分钟
  ├─ 内容: 卸货全过程录像
  └─ 状态: ✅ 已获取回放URL

  2. 下载存档视频
  ├─ 任务ID: task-20250701-001
  ├─ 状态: ✅ 录制成功
  ├─ 文件大小: 156 MB
  ├─ 下载地址: [已获取]
  └─ 有效期: 2025-07-08 08:30 前

📸 截图证据 (事件前后1小时内，共 6 张)

  08:00:00 - 船舶靠泊稳定，舱门关闭
  08:20:00 - 舱门开启，准备卸货
  08:35:00 - 卸货进行中，货物状态正常
  08:40:00 - ⚠️ 画面中可见部分货物包装破损
  08:45:00 - 继续卸货
  09:00:00 - 卸货继续，破损货物已隔离

📊 取证结论
  • 视频证据完整覆盖争议时间段
  • 截图显示货物包装在卸货过程中出现破损
  • 建议: 结合视频和截图，可向责任方提出索赔
  • 所有证据材料已下载存档，保存期限建议不少于2年

场景6：异常事件实时告警中心

业务描述

建立统一的异常事件监控中心，对管辖的所有船舶进行7×24小时自动监控，当发生设备离线、人员入侵、摄像头遮挡等异常事件时，通过多种渠道（API推送、电话通知）实时告警，确保异常事件得到及时处置。

适用对象

航运物流企业运营中心

船舶管理公司监控中心

港口安全管理部门

涉及接口

接口	用途
`VShipSubscribeSet`	批量订阅船舶事件
`VShipSubscribeQuery`	查询订阅列表
`GetVShipAiEvents`	查询历史事件统计

实现步骤

步骤1：批量订阅船舶事件

对管辖范围内的所有船舶进行事件订阅：

POST /apicall/v3/VShipSubscribeSet?key={API Key}&mmsi={船舶1 MMSI}&cell={值班手机号}
POST /apicall/v3/VShipSubscribeSet?key={API Key}&mmsi={船舶2 MMSI}&cell={值班手机号}
...

步骤2：搭建事件接收服务

在自有系统中搭建Webhook接收服务，接收船讯网推送的事件数据：

步骤3：事件分级处理

根据事件类型设置不同的告警级别：

事件类型	告警级别	处理方式
疑似偷盗	🔴 紧急	立即电话通知+实时视频确认
人员入侵	🟠 重要	API推送+短信通知
设备离线	🟡 一般	API推送，定时汇总
摄像头遮挡	🟠 重要	API推送+短信通知
开关舱门	🟢 提示	仅记录，不告警

步骤4：定期统计分析

每日/每周查询事件统计，分析安全态势：

GET /apicall/v3/GetVShipAiEvents?key={API Key}&mmsi={船舶MMSI}&start_time={统计周期开始}&end_time={统计周期结束}

预期效果

🚨 异常事件实时告警中心
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📊 监控总览 (2025-07-01)
  监控船舶总数: 50 艘
  在线摄像头: 142 个
  今日事件总数: 23 次

📈 今日事件分布

  疑似偷盗: 1 次 🔴
  ├─ 时间: 02:30
  ├─ 船舶: 皖鸿远369
  ├─ 类型: 小船搭靠
  └─ 处理: 已通知船长核实，确认为正常加油作业

  人员入侵: 8 次 🟠
  ├─ 均为正常港口作业人员，已自动标记

  设备离线: 5 次 🟡
  ├─ 3次已自动恢复
  └─ 2次需人工介入，已派修

  摄像头遮挡: 2 次 🟠
  ├─ 1次为雨水遮挡，已恢复
  └─ 1次需清理，已通知船员

  开关舱门: 7 次 🟢
  └─ 正常作业记录

⏱️ 告警响应统计
  平均响应时间: 3.5 分钟
  紧急事件响应率: 100%
  误报率: 12% (主要为人员入侵的正常作业)

场景7：船队批量视频监控管理

业务描述

对管理的整个船队进行批量视频监控，统一查看多艘船舶的视频画面、设备状态和事件记录，提高管理效率。

适用对象

船东/船舶管理公司

大型航运物流企业

fleet management平台开发商

涉及接口

接口	用途
`GetShipDevicesStatus`	批量查询设备状态
`GetVShipPreview`	批量获取实时视频
`GetVShipAiEvents`	批量查询事件
`VShipSubscribeSet/Del/Query`	管理订阅列表

实现步骤

步骤1：获取船队船舶清单

维护船队中所有船舶的MMSI列表。

步骤2：批量轮询设备状态

步骤3：批量订阅事件

步骤4：构建监控大屏

汇总展示船队监控数据：

船舶总数、在线/离线数量

各船舶摄像头状态

预期效果

🚢 船队批量视频监控管理看板
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📊 船队概览
  船舶总数: 50 艘
  🟢 全部正常: 42 艘
  🟡 部分异常: 6 艘
  🔴 严重异常: 2 艘

📹 摄像头状态
  总数: 148 个
  🟢 在线: 132 个 (89.2%)
  🔴 离线: 16 个 (10.8%)

🚨 最新事件 (实时更新)

  1分钟前 - 皖鸿远369 人员入侵 广州港
  5分钟前 - 粤新会货8233 设备离线 驾驶台
  12分钟前 - 苏通货118 开关舱门 上海港
  30分钟前 - 浙海轮256 摄像头遮挡 右舷

📺 实时视频轮播
  [船舶1 驾驶台] [船舶2 货舱] [船舶3 左舷]
  每30秒自动切换

⚠️ 需关注船舶
  1. 粤新会货8233 - 1个摄像头离线超过2小时
  2. 浙海轮256 - 右舷摄像头被遮挡
  3. 皖鸿远369 - 最近1小时3次人员入侵事件

场景8：保险风控与理赔取证

业务描述

保险公司利用视频监控服务对投保船舶进行远程风控监控，在出险时快速获取第一现场的视频证据，辅助理赔调查，降低欺诈风险。

适用对象

保险公司风控部门

保险公估机构

海事理赔部门

涉及接口

接口	用途
`GetVShipAiEvents`	查询异常事件记录
`GetVShipPlayback`	回放事发时段视频
`AddPlaybackRecordTask`	录制视频证据
`PlaybackRecordTaskQuery`	获取下载地址
`GetVShipImgs`	获取事发时段截图

实现步骤

步骤1：接入投保船舶视频数据

获取投保人的授权后，将船舶加入监控范围。

步骤2：定期风控巡查

GET /apicall/v3/GetVShipAiEvents?key={API Key}&mmsi={投保船舶MMSI}&start_time={本周开始}&end_time={本周结束}

步骤3：出险时快速取证

接到出险报案后：

确定出险时间和大致位置

查询该时段的事件记录：

GET /apicall/v3/GetVShipAiEvents?key={API Key}&mmsi={船舶MMSI}&start_time={出险前1小时}&end_time={出险后1小时}

获取历史视频回放：

GET /apicall/v3/GetVShipPlayback?key={API Key}&mmsi={船舶MMSI}&start_time={出险时间-30分钟}&end_time={出险时间+30分钟}

录制视频存档：

POST /apicall/v3/AddPlaybackRecordTask?key={API Key}&device_id={设备序列号}&task_id={理赔编号}&start_time={开始时间}&end_time={结束时间}

获取截图佐证：

GET /apicall/v3/GetVShipImgs?key={API Key}&mmsi={船舶MMSI}&start_time={出险时间-2小时}&end_time={出险时间+2小时}

预期效果

🛡️ 保险风控与理赔取证报告
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 案件信息
  保单号: PICC-2025-0710-001
  船舶: 粤新会货8233 (MMSI: 413904861)
  出险时间: 2025-07-01 08:35
  出险地点: 广州港
  报案事由: 货物损坏争议

📊 风控监控记录 (投保期间)

  监控天数: 30 天
  异常事件: 15 次
  ├─ 人员入侵: 10 次 (均为正常作业)
  ├─ 开关舱门: 3 次 (正常)
  └─ 设备离线: 2 次 (已恢复)
  风险评级: 🟢 低风险

📹 理赔取证材料

  1. 事发时段历史视频
  ├─ 时间段: 08:05 - 09:05 (1小时)
  ├─ 状态: ✅ 已获取回放URL
  └─ 关键画面: 08:35 可见货物包装破损

  2. 视频证据文件
  ├─ 任务ID: PICC-20250701-001
  ├─ 状态: ✅ 录制完成
  ├─ 文件大小: 298 MB
  └─ 下载地址: [已获取，有效期7天]

  3. 截图证据链
  ├─ 08:00 - 货物完好
  ├─ 08:20 - 开始卸货
  ├─ 08:35 - ⚠️ 发现破损 (关键证据)
  ├─ 08:40 - 破损货物被移出
  └─ 09:00 - 继续卸货

📈 理赔建议
  • 视频证据清晰显示货物在卸货过程中发生破损
  • 建议理赔方向: 装卸责任
  • 证据完整度: 95%
  • 预计理赔处理周期: 缩短30%

文档结束
接口的详细参数说明请参考《船讯网视频监控API服务说明》
如有疑问，请联系船讯网技术支持团队：service@shipxy.com | 400-010-8558

视频监控场景应用指南

船讯网视频监控场景应用指南#

目录#

场景1：货物运输防盗智能监控#

业务描述#

适用对象#

涉及接口#

实现步骤#

预期效果#

场景2：船舶实时动态监控#

业务描述#

适用对象#

涉及接口#

实现步骤#

预期效果#

场景3：船舶设备运维管理#

业务描述#

适用对象#

涉及接口#

实现步骤#

预期效果#

场景4：港口装卸货作业监管#

业务描述#

适用对象#

涉及接口#

实现步骤#

预期效果#

场景5：历史追溯与取证#

业务描述#

适用对象#

涉及接口#

实现步骤#

预期效果#

场景6：异常事件实时告警中心#

业务描述#

适用对象#

涉及接口#

实现步骤#

预期效果#

场景7：船队批量视频监控管理#

业务描述#

适用对象#

涉及接口#

实现步骤#

预期效果#

场景8：保险风控与理赔取证#

业务描述#

适用对象#

涉及接口#

实现步骤#

预期效果#

船讯网视频监控场景应用指南

目录

场景1：货物运输防盗智能监控

业务描述

适用对象

涉及接口

实现步骤

预期效果

场景2：船舶实时动态监控

业务描述

适用对象

涉及接口

实现步骤

预期效果

场景3：船舶设备运维管理

业务描述

适用对象

涉及接口

实现步骤

预期效果

场景4：港口装卸货作业监管

业务描述

适用对象

涉及接口

实现步骤

预期效果

场景5：历史追溯与取证

业务描述

适用对象

涉及接口

实现步骤

预期效果

场景6：异常事件实时告警中心

业务描述

适用对象

涉及接口

实现步骤

预期效果

场景7：船队批量视频监控管理

业务描述

适用对象

涉及接口

实现步骤

预期效果

场景8：保险风控与理赔取证

业务描述

适用对象

涉及接口

实现步骤

预期效果