1. 视频监控AI识别预警服务
Shipxy
  • 船讯网API服务概述
  • 注册与创建应用
  • 多语言SDK引入
  • AI大模型接入MCP服务
  • 视频监控AI识别预警服务
    • 视频监控服务接入指南
    • 视频监控API服务说明
    • 视频监控场景应用指南
    • 视频监控服务FAQ与最佳实践
  • AI智能体应用
    • 运力资源智能体
    • 船舶风控智能体
    • 运输规划智能体
    • 航次时效预测智能体
    • 船舶安全监控智能体
    • 多式联运协同智能体
    • 大宗贸易态势分析智能体
  • 1 船舶查询
    • 1.1 船舶位置查询
      • 1.1.1 单船位置查询
      • 1.1.2 多船位置查询
      • 1.1.3 船队位置查询
    • 1.2 船舶模糊查询
      GET
    • 1.3 周边船舶查询
      GET
    • 1.4 区域船舶查询
      GET
    • 1.5 船舶船籍查询
      GET
    • 1.6 船舶档案查询
      GET
  • 2 港口查询
    • 2.1 港口信息查询
      GET
    • 2.2 港口当前靠泊船查询
      GET
    • 2.3 港口当前到锚船查询
      GET
    • 2.4 港口预抵船舶查询
      GET
  • 3 历史行为
    • 3.1 船舶历史轨迹查询
    • 3.2 船舶互相搭靠记录查询
  • 4 挂靠记录
    • 4.1 船舶历史挂靠记录
    • 4.2 船舶挂靠指定港口记录
    • 4.3 船舶当前挂靠信息
    • 4.4 港口挂靠历史船舶
  • 5 航线规划
    • 5.1 点到点航线规划
    • 5.2 港到港航线规划
    • 5.3 预计到达时间(ETA)查询
  • 6 天气气象
    • 6.1 新全球气象
      • 6.1.1 实时气象数据
      • 6.1.2 未来气象预报
    • 6.2 全球台风
      • 6.2.1 获取全球台风列表
      • 6.2.2 获取单个台风信息
    • 6.3 国内港口潮汐
      • 6.3.1 查询国内潮汐观测站列表
      • 6.3.2 查询单个观测站潮汐详情
    • 6.4 全球港口潮汐
      • 6.4.1 查询全球潮汐观测站列表
      • 6.4.2 查询单个观测站潮汐详情
    • 6.5 海区气象
    • 6.6 单点海洋气象
    • 6.7 历史气象记录
  • 7 海图GIS平台开发
    • 7.1 快速入门：从注册到接入
    • 7.2 地图引擎基础：地图控制与业务绘制
    • 7.3 船位展示服务
    • 7.4 历史轨迹服务
    • 7.5 图层与气象服务
    • 7.6 航线绘制与区域回放服务
    • 7.7 Vue项目接入指南
    • 7.8 API Key安全实践：后端代理接入
  • 8 海事数据
    • 8.1 航行警告查询
  • 9 监控推送
    • 9.1 监控船队管理
      • 9.1.1 创建船队
      • 9.1.2 更新船队信息
      • 9.1.3 查询船队
      • 9.1.4 删除船队
      • 9.1.5 船队船舶增加
      • 9.1.6 船队船舶批量更新
      • 9.1.7 船队船舶删除
    • 9.2 区域监控推送
      • 9.2.1 区域创建
      • 9.2.2 区域更新
      • 9.2.3 区域查询
      • 9.2.4 区域删除
      • 9.2.5 区域监控推送内容
    • 9.3 船舶航速提醒推送
      • 9.3.1 新增船舶订阅
      • 9.3.2 删除订阅船舶信息
      • 9.3.3 查询订阅船舶列表
      • 9.3.4 船舶航速异常推送
    • 9.4 实时船位推送
    • 9.5 船舶到离港事件推送
    • 9.6 船舶动态ETA推送
    • 9.7 船舶AIS信号消失事件推送
    • 9.8 船舶搭靠事件推送
  • 文档附录
    • 船舶类型对照表
    • 服务码返回说明
    • 海区对照表
    • 航行状态对照表
    • 绕航节点清单
    • 航标类型对照表
  1. 视频监控AI识别预警服务

视频监控服务接入指南

目录#

1.
接入前准备
2.
获取API Key（授权码）
3.
设备入网与绑定
4.
API服务接入
5.
事件推送接入
6.
验证接入是否成功

一、接入前准备#

1.1 硬件准备#

在开始接入之前，您需要准备以下硬件：
项目要求说明
摄像头设备支持萤石云协议的海康威视网络摄像机推荐使用海康威视品牌，兼容性最佳
网络环境设备需能连接互联网船舶上需有4G/5G网络或卫星网络
电源供应12V直流供电确保航行期间持续供电

1.2 信息准备#

接入过程中需要使用到以下关键信息：
信息项获取方式用途
设备序列号设备包装标签或机身标签唯一标识摄像头设备
设备验证码设备机身标签验证设备所有权
船舶MMSI船舶九位识别码将设备与船舶关联
船讯网账号注册船讯网获得登录绑定工具

二、获取API Key（授权码）#

船讯网视频监控服务使用 API Key 进行身份认证和权限控制。获取流程如下：

步骤1：注册船讯网账号#

1.
访问船讯网官网（www.shipxy.com）
2.
点击注册，使用手机号完成账号注册
3.
已有船讯网账号的用户可直接登录

步骤2：创建应用Key#

1.
登录后进入API板块控制台中的 "应用管理" 模块
2.
点击 "创建应用"，填写应用名称（如"视频监控服务"）
3.
系统会自动生成一个 应用 Key（格式如 1F6D701272402D1E7D8D316CCE519123）
4.
点击复制按钮，妥善保存该 Key
┌────────────────────────────────────────────────────────────────────┐
│  ⚠️  重要提示                                                       │
│                                                                    │
│  1. API Key 是调用服务的唯一凭证，请勿泄露给第三方                    │
│  2. 一个账户最多可注册 5 个应用 Key                                  │
│  3. 第一个 Key 具备初始测试权限，正式使用需联系商务开通更多权限       │
│  4. 如需视频监控服务权限，将 Key 发送给对接的销售人员即可             │
│                                                                    │
│  商务邮箱：support@shipxy.com | 电话：400-010-8558                  │
└────────────────────────────────────────────────────────────────────┘

步骤3：权限配置#

不同的使用场景需要开通不同的接口权限：
使用场景需开通的权限
基础视频查看实时视频查看（默认开通）
设备状态监控设备状态查询 + 事件查询
AI事件预警事件推送订阅 + AI事件识别权限
历史数据回溯历史视频 + 截图查询 + 视频下载
疑似偷盗监测疑似偷盗事件识别（需单独开通）

三、设备入网与绑定#

3.1 设备入网要求#

监控设备需要通过 萤石云协议 添加到平台
如果设备已经被添加到其他萤石云平台，需要先将设备从其他平台删除

3.2 获取设备信息#

方式一：查看设备标签（推荐）#

大部分设备在机身背面或包装标签上印刷有设备序列号和验证码：
包装：
image 4.png
机身：
image.png

方式二：通过设备管理页面获取#

1.
将电脑与摄像头连接到同一局域网
2.
打开浏览器，输入设备IP地址（如 http://192.168.1.64）
3.
使用管理员账号登录设备管理页面
4.
进入 配置 → 网络 → 设备接入 → 萤石云
5.
启用萤石云，确认注册状态为"在线"
6.
点击 账号绑定 → 设备二维码点击查看，获取设备二维码
image 7.png
注意：点击查看二维码后，请立即记录序列号和验证码。不要重复点击查看，因为每次查看都会刷新验证码，之前获取的验证码将失效。

3.3 绑定设备到船舶#

登录绑定工具#

1.
打开绑定工具地址：https://setupv.shipxy.com
2.
使用船讯网手机号和密码登录
3.
支持PC端浏览器、微信等多种环境访问

绑定形式一：新增设备绑定#

适用于设备首次绑定到船讯网平台。
前置条件：
设备已通电并联网
设备未在其他萤石云平台上绑定
操作步骤：
1.
登录绑定工具后，点击 【新增】
2.
输入 设备序列号
3.
验证码默认填写 a12345678（如设备有特殊验证码，请按实际填写）
4.
输入或搜索要绑定的 船名或MMSI
5.
选择摄像头的 安装位置（位置选择很重要，关系到AI识别的准确性）
6.
点击 【保存】
7.
绑定成功后，点击 【实时视频】 查看画面，确认角度合适
安装位置说明：请根据摄像头实际安装位置选择，如"驾驶台"、"左舷"、"右舷"、"船艏"、"船艉"、"货舱"等。不同位置对应不同的AI识别策略。

绑定形式二：轮转设备绑定#

适用于设备已经在船讯网平台中，需要更换绑定到不同的船舶。
特点：
不需要设备通电在线也能完成换绑
航次结束后可将设备收回，绑定到虚拟船舶等待下次使用
操作步骤：
1.
登录绑定工具，选择 【轮转设备绑定】
2.
输入 设备序列号，搜索并点击 【重新绑定】
3.
输入或搜索新的 船名或MMSI
4.
选择新的 安装位置
5.
点击 【保存】
6.
换绑成功后，新船舶的视频权限会自动添加到账号下

航次结束后的设备解绑#

当航次结束，轮转摄像头被拆下寄回时，需要将设备与运输船舶解除绑定，统一转移到虚拟船舶上等待下次使用。
操作步骤：
1.
收到拆下寄回的设备后，选择 【轮转设备绑定】
2.
输入 设备序列号，搜索并点击 【重新绑定】
3.
输入虚拟船舶 MMSI：414414414
4.
点击 【保存】 即可

3.4 绑定验证#

绑定完成后，请进行以下验证：
1.
在船讯网APP或PC网页端查看是否能正常显示视频画面
2.
检查视频画面角度是否合适，能否覆盖需要监控的区域
3.
如果画面不清晰或角度不对，可现场调整摄像头位置后重新查看

四、API服务接入#

4.1 接口调用方式#

船讯网视频监控服务提供RESTful API接口，所有接口统一通过以下方式调用：
服务基地址： https://api.shipxy.com
认证方式： 通过URL参数传递API Key（授权码）
请求格式：
https://api.shipxy.com/apicall/v3/{接口名称}?key={您的API Key}&参数1=值1&参数2=值2
返回格式： 统一返回JSON格式数据
{
  "status": 0,      // 状态码，0表示成功
  "msg": "",        // 状态描述
  "data": { }       // 业务数据
}

4.2 权限开通#

调用API接口前，需要确保您的API Key已开通对应的接口权限。权限开通流程：
1.
准备好您的API Key
2.
联系船讯网商务或销售人员（support@shipxy.com）
3.
说明需要开通视频监控服务相关权限
4.
商务人员会为您配置权限
5.
权限开通后即可调用接口

4.3 接口分类#

视频监控服务的API接口分为以下几类：
接口类别说明典型接口
设备查询类查询船舶绑定的设备信息GetShipDevicesStatus
视频查看类获取实时/历史视频URLGetVShipPreview、GetVShipPlayback
截图查询类查询定时截图GetVShipImgs
事件查询类查询AI识别的事件记录GetVShipAiEvents
视频下载类创建和管理视频下载任务AddPlaybackRecordTask等
事件订阅类管理事件推送订阅VShipSubscribeSet等
详细的接口定义和参数说明，请参考《船讯网视频监控API服务说明》文档。

五、事件推送接入#

5.1 推送机制说明#

船讯网视频监控服务支持将AI识别到的异常事件 实时推送 到客户指定的接收端。推送流程如下：
┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│  船载摄像头  │────▶│  AI事件识别  │────▶│  事件推送   │
│  检测异常   │     │  触发告警   │     │  至客户系统  │
└─────────────┘     └─────────────┘     └──────┬──────┘
                                               │
                                        ┌──────┴──────┐
                                        │  电话通知    │
                                        │  (增值服务)  │
                                        └─────────────┘

5.2 订阅船舶事件#

要接收某艘船舶的视频事件推送，需要先将该船舶添加到订阅列表中。
操作方式： 调用 VShipSubscribeSet 接口
必填参数：
key：您的API Key
mmsi：要订阅的船舶MMSI
可选参数：
cell：绑定手机号码，开通电话通知服务后，事件发生时将拨打此号码
返回说明：
添加成功：返回成功提示
添加失败：可能原因包括权限不足、订阅数量超限、船舶不在用户视频平台清单中

5.3 管理订阅列表#

操作接口说明
添加订阅VShipSubscribeSet将船舶加入事件订阅列表
删除订阅VShipSubscribeDel将船舶从订阅列表中移除
查询列表VShipSubscribeQuery查看当前所有订阅的船舶

5.4 推送数据格式#

事件推送的数据格式为JSON，包含以下关键字段：
字段说明
ship_name船舶名称
mmsi船舶MMSI
device_name视频设备名称和位置
type_name事件类型（如"人员入侵"、"疑似偷盗"等）
event_time事件发生时间（北京时间）
img_url事件发生时自动截图的URL
position事件发生的位置描述
疑似偷盗事件额外字段：
字段说明
description具体的偷盗子类型描述

5.5 电话通知服务（增值服务）#

如需开通电话通知功能，请联系船讯网商务：
1.
在订阅船舶时，通过 cell 参数绑定接收电话的手机号码
2.
开通电话通知服务后，当船舶发生异常事件时
3.
系统会自动对接外呼平台，拨打绑定的手机号码
4.
电话中将语音播报事件类型和船舶信息

六、验证接入是否成功#

完成以上接入步骤后，可以通过以下方式验证接入是否成功。

测试1：查询设备状态#

调用接口： GetShipDevicesStatus
请求示例：
https://api.shipxy.com/apicall/v3/GetShipDevicesStatus?key=您的API Key&mmsi=船舶MMSI
验证标准：
如果返回设备列表（包含device_id、device_name、device_state），说明设备绑定成功
device_state为1表示设备在线，2表示离线

测试2：查看实时视频#

调用接口： GetVShipPreview
请求示例：
https://api.shipxy.com/apicall/v3/GetVShipPreview?key=您的API Key&mmsi=船舶MMSI
验证标准：
如果返回一个H5页面的URL，在浏览器中打开能看到实时视频画面，说明视频服务正常

测试3：查询事件记录#

调用接口： GetVShipAiEvents
请求示例：
https://api.shipxy.com/apicall/v3/GetVShipAiEvents?key=您的API Key&mmsi=船舶MMSI&start_time=开始时间戳&end_time=结束时间戳
验证标准：
如果返回事件列表（total字段大于0），说明AI事件识别服务正常
如果total为0，可能是该时间段内确实没有事件发生

常见问题排查#

问题现象可能原因解决方法
查询不到设备设备未绑定或绑定失败重新登录绑定工具检查绑定状态
设备状态为离线设备未通电或网络不通检查设备电源和网络连接
无法查看视频API Key没有视频权限联系商务开通权限
查询不到事件时间段内无事件或未开通AI权限检查权限配置，更换时间段重试
收不到推送船舶未加入订阅列表调用订阅接口添加船舶
文档结束
详细的接口参数说明请参考《船讯网视频监控API服务说明》
如有疑问，请联系船讯网技术支持团队：service@shipxy.com | 400-010-8558
上一页
视频监控AI识别预警服务
下一页
视频监控API服务说明