视频监控服务FAQ与最佳实践
船讯网视频监控服务FAQ与最佳实践
文档版本：V1.0
适用版本：船讯网 API V3.0+
更新日期：2026-07-10
技术支持：service@shipxy.com | 400-010-8558
目录
一、常见问题 FAQ
Q1：视频监控服务如何收费？
| 收费项 | 说明 |
|---|---|
| 基础视频查看 | 按设备数量收取服务费 |
| 历史视频下载 | 按下载流量计费，单位：分钟 |
| AI事件识别 | 基础事件（离线/遮挡/入侵/开关舱门）包含在套餐中 |
| 疑似偷盗识别 | 需单独开通，按设备数量计费 |
| 电话通知服务 | 增值服务，按通话次数计费 |
Q2：一个API Key可以同时用于视频监控和其他船讯网服务吗？
Q3：视频监控服务有频率限制吗？
| 接口类别 | 频率限制 | 说明 |
|---|---|---|
| 设备状态查询 | 每秒5-10次 | 根据套餐等级不同 |
| 实时视频获取 | 每秒5-10次 | 建议合理控制调用频率 |
| 历史视频/截图查询 | 每秒1次 | 根据套餐等级不同 |
| 事件推送 | 无限制 | 被动接收，不属于主动调用 |
| 视频下载任务创建 | 每分钟5次 | 防止滥用 |
| 视频通道 | 同一个设备一个通道观看 | 多个入口访问同一个摄像头观看视频需额外开通通道 |
Q4：支持哪些品牌的摄像头？
注意：设备必须支持萤石云协议才能接入船讯网视频监控平台。购买设备前请确认设备支持该协议。
Q5：摄像头安装位置如何选择？
| 监控目标 | 推荐安装位置 | AI识别能力 |
|---|---|---|
| 货物防盗 | 货舱、甲板上方 | 人员入侵、疑似偷盗 |
| 船员作业监督 | 驾驶台、甲板 | 人员入侵 |
| 船舶周边监控 | 船艏、船艉、左舷、右舷 | 船舶搭靠、小船靠近 |
| 舱门开关监控 | 货舱门正对面 | 开关舱门 |
| 设备防遮挡 | 较高位置，视野开阔 | 摄像头遮挡 |
Q6：视频数据可以保存多久？
| 数据类型 | 保存期限 | 说明 |
|---|---|---|
| 实时视频 | 不保存 | 仅实时查看，不存储 |
| 历史 视频录像 | 14天 | 支持14天以内的历史视频回放和录制下载 |
| 定时截图 | 1年 | 每15-20分钟自动截图，保存1年 |
| AI事件记录 | 1年 | 事件识别记录保存1年 |
| 事件截图 | 1年 | 事件触发时的截图保存1年 |
Q7：数据安全和隐私如何保障？
Q8：轮转设备如何管理？
1.
2.
3.
4.
二、设备绑定相关问题
Q9：设备绑定失败怎么办？
| 失败现象 | 可能原因 | 解决方法 |
|---|---|---|
| 提示"设备不存在" | 序列号或验证码错误 | 核对设备标签上的信息，注意区分大小写 |
| 提示"设备已被绑定" | 设备在其他平台绑定 | 先将设备从其他萤石云平台删除 |
| 提示"船舶不在清单中" | 该船舶未与当前账号关联 | 联系商务将船舶添加到您的账号下 |
| 绑定后看不到视频 | 设备未通电或网络不通 | 检查设备电源和网络连接 |
| 提示"验证码错误" | 验证码已刷新 | 重新查看设备获取最新验证码 |
Q10：如何获取设备的验证码？
1.
2.
3.
4.
重要提醒：点击查看后会刷新验证码，之前获取的验证码将失效。请记录后立即使用。
Q11：可以一艘船绑定多个摄像头吗？
三、视频查看相关问题
Q12：实时视频卡顿怎么办？
1.
2.
3.
4.
Q13：历史视频能下载到本地吗？
1.
AddPlaybackRecordTask 接口创建录制任务2.
3.
PlaybackRecordTaskQuery 接口查询任务状态4.
限制：仅支持14天以内的历史视频下载，单次录制不超过30分钟。
Q14：定时截图的频率可以调整吗？
四、事件推送相关问题
Q15：为什么收不到事件推送？
1.
VShipSubscribeQuery 确认船舶已在订阅列表中2.
3.
4.
5.
Q16：电话通知服务如何开通？
1.
2.
3.
cell 参数绑定接收手机号4.
Q17：可以只接收特定类型的事件推送吗？
type_name 字段进行过滤处理。五、API调用相关问题
Q18：API返回"无接口权限"怎么办？
Q19：MMSI输入有什么要求？
413904861 ✅ / 41390486 ❌ / 0413904861 ❌Q20：时间戳格式有什么要求？
| 接口 | 时间格式 | 示例 |
|---|---|---|
| GetVShipAiEvents | Unix时间戳（秒） | 1751334377 |
| GetVShipPlayback | Unix时间戳（秒） | 1751334377 |
| GetVShipImgs | Unix时间戳（秒） | 1751334377 |
| AddPlaybackRecordTask | yyyyMMddHHmmss | 20250403123059 |
Unix时间戳可通过以下方式获取： Python: int(time.time())JavaScript: Math.floor(Date.now() / 1000)Java: System.currentTimeMillis() / 1000
六、最佳实践
6.1 设备部署最佳实践
1.
2.
3.
4.
6.2 API调用最佳实践
1.
2.
3.
6.3 安全管理最佳实践
1.
2.
3.
6.4 业务使用最佳实践
1.
2.
3.
七、附录
附录A：事件类型对照表
| 事件类型 | type_name值 | 适用场景 | 告警级别 |
|---|---|---|---|
| 设备离线 | 设备离线 | 设备运维 | 一般 |
| 摄像头遮挡 | 摄像头遮挡 | 安全防护 | 重要 |
| 人员入侵 | 人员入侵 | 船舶防盗 | 重要 |
| 开关舱门 | 开关舱门 | 作业监管 | 提示 |
| 船舶搭靠 | 船舶搭靠 | 安全监控 | 重要 |
| 疑似偷盗 | 疑似偷盗 | 货物防盗 | 紧急 |
| 子类型 | description值 | 说明 |
|---|---|---|
| 携带装载容器 | 携带装载容器 | 检测到人员携带装载容器 |
| 携带推铲工具 | 携带推铲工具 | 检测到人员携带推铲类工具 |
| 管线设备接触 | 管线设备接触 | 检测到管线设备被异常接触 |
| 小船搭靠 | 小船搭靠 | 检测到小型船只靠近搭靠 |
附录B：API返回状态码说明
| 状态码 | 说明 |
|---|---|
| 0 | 请求成功 |
| 14 | 来源域错误 |
| 15 | 无接口权限 |
| 16 | 请求参数错误 |
| 17 | 请求频率超限 |
| 18 | 无此船数据 |
| 19 | 查询时间段过长 |
| 20 | 账户已过期 |
附录C：设备状态码说明
| 状态码 | 说明 |
|---|---|
| 1 | 正常运行（在线） |
| 2 | 离线 |
附录D：视频录制任务状态码说明
| 状态码 | 状态 | 说明 |
|---|---|---|
| 0 | 准备中 | 任务已创建，正在准备 |
| 1 | 成功 | 录制完成，可下载文件 |
| 2 | 终止 | 任务被手动终止 |
| 3 | 失败 | 录制失败 |
| 4 | 排队中 | 正在排队等待录制 |
| 5 | 进行中 | 正在录制中 |
| 6 | 暂停 | 录制暂停 |
附录E：联系方式
| 类型 | 联系方式 |
|---|---|
| 商务咨询 | support@shipxy.com / 400-010-8558 |
| 技术支持 | service@shipxy.com |
| 官网 | www.shipxy.com |
| API控制台 | 登录船讯网官网后进入"API服务"模块 |
| 设备绑定工具 | https://setupv.shipxy.com |
文档结束
如有疑问，请联系船讯网技术支持团队：service@shipxy.com | 400-010-8558