海康测温球机接入实战：测温阈值、船只检测、烟火预警事件的ISAPI对接方案

一、引言

做江河航道、工业园区这类户外监控的开发者，大概都遇到过两类需求叠加：江面上要能自动发现驶来的船只并统计流量，厂区里要能在设备发热、冒烟的早期就收到预警。普通摄像机只能给画面，靠人盯着屏幕看，既容易漏也不持久；真正缺的是一双既能转动巡视、又能感知温度、还能自己判断异常的眼睛。

本文介绍萤石蓝海 AIoT 一站式工作台最新上线的海康测温球机接入能力。测温球机是一类“可见光 + 热成像”双光谱云台球机，既能像普通球机一样转动巡视、拉近拉远，又能通过热成像感知温度，并具备船只检测、烟火/火点识别、废气监测、预置点巡航等能力。平台将这些专有能力通过萤石云 ISAPI 透传封装为设备技能，开发者用自然语言描述业务场景，即可生成 Web / Android / iOS / 小程序多端可运行应用。读完本文你会知道：怎么先查能力集确认设备到底支持哪些子功能、怎么稳妥地下发布防时间和报警规则、怎么调预置点巡航、怎么接住测温/船只/烟火这些上行事件，以及哪些能力其实不归本设备技能管。

二、核心概念：ISAPI 透传、双光谱通道与能力集

ISAPI 透传是指业务侧不直接连设备，而是把海康 ISAPI 报文经萤石云开放接口转发给设备。下行统一走https://open.ys7.com/api/hikvision/{ISAPI路径}，鉴权用EZO-AccessToken、EZO-DeviceSerial、EZO-Date三个请求头；设备上行的报警与检测事件，经萤石平台消息推送到业务自己的 Webhook。

双光谱通道是这台设备最容易踩的点。它有两路画面：一路可见光（看细节，云台控制通常在可见光通道，示例channels/1），一路热成像（感知温度，测温/船只等专有配置多在独立热成像通道，示例channels/2）。下发配置前必须确认是给哪一路配，通道号以设备实际返回为准。

能力集是设备“自报家门”的一份清单。所有功能是否可用，统一以GET /ISAPI/Thermal/capabilities的返回为准，例如isSupportThermometry（测温）、isSupportShipsDetection（船只检测）、isSupportFireDetection（烟火识别）等能力位。不要按型号名硬编码“这台肯定支持烟火”，不同型号、固件差异由能力集如实回答。

三、接入背景：户外“看得懂”的四类痛点

户外场景的监控难点不在“看不看得见”，而在“看不看得懂”，具体可归为四类。

• 江面目标靠人盯。江面开阔、船只往来，靠值班员一直盯屏幕发现目标、数流量，容易漏、人力成本高。
• 温度异常发现晚。厂区设备悄悄发热，等肉眼看到冒烟、明火往往已经晚了，缺一个在“升温阶段”就报警的客观信号。
• 烟火识别误报多。厂区里烟囱、锅炉本来就是正常热源/烟源，不做屏蔽会频繁误报，真正的火点反而被淹没。
• 大范围看不全。固定机位覆盖有限，装一圈成本高，需要云台预置点巡航，用一台设备轮看多个重点位置。

四、核心技能详解

本次接入围绕双光谱球机的专有能力域展开，以下逐一说明。

4.1 热成像测温：阈值报警与温差报警

通过热成像通道感知目标温度，支持温度阈值报警（单区域超过温度上限即报）与温差报警（两个区域之间差值超限即报，更适合发现“局部异常升温”）。温度是比画面更早、更客观的隐患信号。测温区域与阈值由具备资质的现场专业人员结合设备工况设定，生成的应用不内置默认报警线。

4.2 船只检测与船流量统计

面向江河航道，自动识别画面中的船只并统计船流量，把“人盯屏”变成“设备主动报”。可按布防时间控制生效时段（例如只在某些时段检测）。识别到的船只信息可通过查询接口获取，流量统计结果为辅助参考。

4.3 烟火/火点识别与烟雾屏蔽

结合热成像对火点、烟雾进行识别预警。关键减误报手段是设置烟雾屏蔽区域（屏蔽区）：把厂区烟囱、锅炉这类持续正常排烟/发热的位置排除，降低误报，让真正的异常火点更突出。

4.4 废气排放监测

对特定工业场景的废气排放进行监测预警，作为环保巡检的线索来源之一。

4.5 球机云台观测：预置点、巡航、区域扫描

支持预置点、巡航、区域扫描等。预置点是提前保存的观测位置，巡航是让云台按顺序在多个预置点之间自动转动巡视，一台设备即可轮看大范围重点区域。

4.6 可见光 + 热成像双画面

可见光看“那是什么”，热成像看“哪里热”，两路画面互相印证，定位隐患更直观。

关于画面能力如实说明：常规视频预览、录像回放、取流等通用摄像机能力，由平台的通用摄像机技能统一承接；本次设备技能聚焦专有热成像测温、船只/烟火/废气识别与球机云台观测，两者配合使用。

五、技术架构：从双光谱设备到多端应用

整体分四层。

• 设备层：双光谱测温球机经网络接入萤石云，可见光与热成像两路能力以 ISAPI 标准化描述，具体功能点与通道号以能力集返回为准。
• 平台层：萤石云提供 ISAPI 下行透传（/api/hikvision/{ISAPI路径}）与上行消息推送（测温报警、火点、船只检测等事件投递到业务 Webhook）。
• AI 生成层：勾选设备技能并叠加端技能后，AI 根据自然语言描述完成设备对接逻辑、前端界面与后端服务的全栈代码生成。
• 应用层：输出 Web / Android / iOS / 小程序，覆盖测温看板、船只/流量监测、烟火预警处置、云台巡航控制等。

六、三步生成应用

第一步：先查能力集。对接任何能力前先GET /ISAPI/Thermal/capabilities，确认这台设备是否支持测温、船只、烟火、废气、云台，不支持的能力不调用、UI 自动隐藏。

bash

1 curl -X GET 'https://open.ys7.com/api/hikvision/ISAPI/Thermal/capabilities' \

2 -H "EZO-AccessToken: $ACCESS_TOKEN" \

3 -H "EZO-DeviceSerial: $DEVICE_SERIAL" \

4 -H "EZO-Date: $(date '+%Y-%m-%d %H:%M:%S')"

5

6 # 关键能力位示意：

7 # <isSupportThermometry>true</isSupportThermometry>

8 # <isSupportShipsDetection>true</isSupportShipsDetection>

9 # <isSupportFireDetection>true</isSupportFireDetection>

第二步：按场景读改配置。给江面配船只检测布防时间、给厂区烟火配屏蔽区域等。配置一律先 GET 读当前值，在返回结构基础上只改需要变的字段，再 PUT 整体回发。

bash

1 # 先读船只检测布防时间现状

2 curl -X GET 'https://open.ys7.com/api/hikvision/ISAPI/Event/schedules/shipsDetections' \

3 -H "EZO-AccessToken: $ACCESS_TOKEN" \

4 -H "EZO-DeviceSerial: $DEVICE_SERIAL" \

5 -H "EZO-Date: $(date '+%Y-%m-%d %H:%M:%S')"

6

7 # 照抄 GET 返回结构、只改目标字段后 PUT

8 curl -X PUT 'https://open.ys7.com/api/hikvision/ISAPI/Event/schedules/shipsDetections' \

9 -H "EZO-AccessToken: $ACCESS_TOKEN" \

10 -H "EZO-DeviceSerial: $DEVICE_SERIAL" \

11 -H "EZO-Date: $(date '+%Y-%m-%d %H:%M:%S')" \

12 -H 'Content-Type: application/xml' \

13 --data-binary @schedule.xml

14 # 成功：<statusCode>1</statusCode><statusString>OK</statusString>

15

第三步：巡航并接收事件。调用预置点让云台自动转向观测位置；测温报警、火点、船只等事件由设备主动上报，业务侧在 Webhook 落库、通知、触发处置工单。

bash

1 # 调用 1 号预置点（云台控制在可见光通道 channels/1）

2 curl -X PUT 'https://open.ys7.com/api/hikvision/ISAPI/PTZCtrl/channels/1/presets/1/goto' \

3 -H "EZO-AccessToken: $ACCESS_TOKEN" \

4 -H "EZO-DeviceSerial: $DEVICE_SERIAL" \

5 -H "EZO-Date: $(date '+%Y-%m-%d %H:%M:%S')"

6

7 # 查询设备识别到的船只信息（专有查询，format=json）

8 curl -X GET

9 'https://open.ys7.com/api/hikvision/ISAPI/Thermal/channels/2/shipsDetection/SearchShipsInfo?format=json' \

10 -H "EZO-AccessToken: $ACCESS_TOKEN" \

11 -H "EZO-DeviceSerial: $DEVICE_SERIAL" \

12 -H "EZO-Date: $(date '+%Y-%m-%d %H:%M:%S')"

设备序列号英文字母需大写；ACCESS_TOKEN通过环境变量注入，不写死在代码里。在工作台勾选测温球机核心技能（热成像测温、船只检测、烟火火点识别、废气监测、云台巡航、双画面）并叠加端技能，用自然语言描述场景即可生成可运行应用。

七、效率对比

八、典型应用场景

江河航道船只监测。江面开阔，靠人盯屏发现船只、数流量容易漏。设备自动识别船只、统计流量，配合预置点巡航覆盖大范围江面，目标主动上报，把人从屏幕前解放出来。船只识别与流量为辅助参考，海事/航道监管与官方统计以主管部门口径为准。

工业园区测温防火。厂区设备多，某处悄悄升温、冒烟很难第一时间发现。热成像持续测温，超阈值或温差拉立即报警，烟火/火点识别提前预警，并对烟囱、锅炉设置屏蔽区减少误报，把防线前移到“发热阶段”。该预警不替代专业消防报警与火灾判定。

大范围户外一台顶多台。户外区域大、固定机位看不全。球机云台按预置点巡航，可见光看细节、热成像看温度，用更少设备覆盖更大范围，重点区域不漏看。

九、总结

本次新增的海康测温球机接入能力，让开发者不必逐一处理双光谱通道区分、能力位判断、布防时间读改写、屏蔽区与预置点巡航等繁琐报文。选好技能、描述场景，即可获得多端可运行的户外监测应用。

从“看得见画面”到“感知温度、识船辨火、自动巡视、主动上报”，这是蓝海 AIoT 工作台为江河与厂区场景提供的核心价值。需要再次强调三条边界：测温/烟火属隐患早期预警，不替代专业消防报警与火灾判定；船只检测与流量为辅助参考，不替代海事监管与官方口径；废气监测为预警线索，不替代环保在线监测等法定监测与执法依据。具体可用功能点以设备能力集返回为准。

十、常见问题 FAQ

Q1：测温球机和普通热成像观测筒机有什么区别？

A：观测筒机主打固定点位热成像测温与温差报警；测温球机在此基础上是双光谱云台球机，多出船只检测与船流量统计、烟火/火点识别与烟雾屏蔽、废气监测，以及预置点/巡航/区域扫描等云台能力，适合江河、厂区这类大范围户外场景。

Q2：怎么知道某台设备到底支不支持船只或烟火识别？

A：不要按型号猜。先GET /ISAPI/Thermal/capabilities，看isSupportShipsDetection、isSupportFireDetection、isSupportThermometry等能力位，生成的应用按返回值决定是否展示对应功能。

Q3：可见光通道和热成像通道怎么区分？

A：设备有两路画面。云台控制示例在可见光通道（PTZCtrl/channels/1），测温、船只等专有配置多在独立热成像通道（示例Thermal/channels/2）。实际通道号以设备返回为准，下发前先确认目标通道。

Q4：改布防时间会不会把其他已有配置覆盖掉？

A：如果直接拼一个最小报文 PUT，可能整体覆盖丢失其他字段。稳妥做法是先 GET 读当前结构，在其基础上只改目标字段，再整体 PUT，成功以statusCode=1为准。

Q5：厂区烟囱、锅炉总是触发烟火报警怎么办？

A：配置烟雾屏蔽区域（屏蔽区），把这类持续正常排烟/发热的位置排除，降低误报。屏蔽区只针对检测算法的画面区域，不影响设备对其他区域的监测。

Q6：船只流量统计能直接当官方数据用吗？

A：不能。设备识别与统计用于辅助值守和趋势参考，受画面角度、天气、遮挡、目标密度影响；海事/航道监管和正式流量口径以主管部门为准。

Q7：废气监测能替代环保在线监测设备吗？

A：不能。该能力提供的是特定场景的排放预警线索，不替代 CEMS 等污染源在线监测设备，也不作为环保执法的法定依据。

Q8：测温/火点报警能不能直接联动灭火或当作消防结论？

A：不建议也不应这样定位。它是早期预警信号，帮助提前发现和处置；是否成灾、如何处置由专业消防系统与有资质人员判断，温度阈值也应由专业人员设定。

Q9：预置点巡航和普通转动是什么关系？

A：普通转动是临时控制方向；预置点是保存好的观测位置，巡航是让云台在多个预置点间按顺序自动巡视，适合无人值守时轮看重点区域。

Q10：事件是设备直连我的服务吗？

A：不是。设备事件先上萤石云，再由平台消息推送到你配置的 Webhook，按事件类型落库、通知、派单即可。通道与字段以事件 payload 为准。

Q11：视频预览、录像回放也要在这个技能里开发吗？

A：不需要。预览、回放、取流等通用摄像机能力由通用摄像机技能承接，本设备技能聚焦热成像测温、船只/烟火/废气识别与云台观测，叠加使用即可。