在很多物联网项目中，传感器数据能告诉我们“发生了什么”，摄像头画面则能帮助我们确认“现场到底是什么情况”。
比如温度超标、设备停机、人员进入、扬尘异常、机房漏水时，管理人员除了查看数值曲线，往往还希望第一时间打开现场画面，确认异常是否真实、影响范围多大、是否需要立即派人处理。
因此，摄像头视频接入 ThingsCloud 的核心价值，并不是把视频当成普通设备数据上报到平台，而是让视频画面和设备数据、告警、看板、移动 App 形成同一个业务体验。
先明确：视频接入和设备数据接入不是一回事
温湿度、液位、开关量、电表读数等数据，可以通过 MQTT、HTTP、TCP、Modbus 等方式进入 ThingsCloud，由平台进行存储、分析、展示和告警。
但摄像头产生的是连续视频流，数据量大，协议也更复杂。常见摄像头或视频平台可能使用 RTSP、RTMP、GB28181、SRT 等协议，这些协议通常不能直接在 App、小程序或网页看板中播放。
更准确地说：
- 传感器数据：设备上报到 ThingsCloud，平台存储数据并用于看板、告警和自动化。
- 视频数据：摄像头接入视频流服务，ThingsCloud 在看板或 App 中作为播放器展示实时画面。
也就是说，ThingsCloud 负责把视频画面融入物联网应用体验中；视频流本身通常由萤石云等第三方视频平台，或自建的视频流服务器提供。
三种常见接入方式
根据项目现场的摄像头类型、移动端兼容性、延迟要求和运维能力，摄像头视频接入 ThingsCloud 主要可以分为三类。
| 接入方式 | 适合场景 | 是否需要自建视频流服务器 | 主要特点 |
|---|---|---|---|
| 萤石云摄像头 | 新采购摄像头，或已有萤石 / 海康设备 | 不需要 | 配置简单，可在看板和 App 中使用，支持云台、对讲、回放等能力 |
| HLS 视频流 | 需要兼顾 iOS、Android、App 和小程序播放 | 通常需要 | 兼容性好，延迟相对较高，适合多数移动端访问场景 |
| FLV 视频流 | 工业值守、安防监控等低延迟场景 | 通常需要 | 延迟低，适合接近实时查看，但 iOS 侧兼容性受限 |
这里的“接入 ThingsCloud”，并不是要求摄像头直接用 MQTT 上报视频数据，而是将可播放的视频源配置到 ThingsCloud 的看板组件或 ThingsX 设备面板组件中。
方式一：接入萤石云摄像头
如果项目正在采购摄像头，或者现场已经使用萤石、海康等支持萤石云的设备，萤石云通常是上手最快的方式。
摄像头先接入萤石云，ThingsCloud 项目中配置萤石云 API 应用密钥后，就可以在可视化看板或 ThingsX App 设备面板中添加萤石视频监控组件。
这种方式的优势是部署成本低，不需要自己搭建视频流服务器。对于萤石云摄像头，ThingsCloud 文档中已经支持在看板和用户 App 中展示视频画面，并支持录像、抓拍、音频、语音对讲、云台操作等能力。
在 App 场景中，萤石摄像头序列号需要配置到设备扩展信息中。因此，设备面板可以围绕某一台设备展示其关联摄像头画面，同时把温度、压力、开关状态、告警状态等物联网数据放在同一个设备详情页中。
方式二：接入 HLS 视频流
如果现场摄像头、NVR、视频编码器或已有视频平台可以提供 HLS 地址，就可以使用 HLS 视频播放组件。
HLS 的播放地址通常以 .m3u8 结尾。它会把连续视频切分成一段段小文件，再由播放器按顺序加载播放。它的延迟通常比 FLV 更高，但移动端兼容性更好，适合需要同时覆盖 iOS、Android、App 和小程序的项目。
在 ThingsX 设备面板中使用 HLS 视频时，可以在设备类型的属性定义中添加一个文本类型属性，子类型选择 HLS 视频 URL，用于保存该设备对应的视频播放地址。然后在设备面板编辑器中添加 HLS 视频播放组件，并绑定这个属性。
这样，每台设备可以拥有自己的视频 URL，用户打开设备详情页时，就能看到对应设备或点位的视频画面。
方式三：接入 FLV 视频流
FLV 视频流更接近直播流，播放器接收到数据后即可解码播放，因此延迟通常更低，适合工业现场值守、安防监控、无人值守机房等对实时性要求较高的场景。
但需要注意，FLV 在 iOS 手机的 ThingsX App 和微信小程序中不支持播放。因此，如果项目需要覆盖 iOS 用户，应优先评估 HLS；如果主要用于 Android、网页看板或低延迟值守场景，FLV 更适合。
在 ThingsX 设备面板中使用 FLV 视频时，同样可以定义文本类型属性，子类型选择 FLV 视频 URL，再在设备面板中添加 FLV 视频播放组件并绑定该属性。
已有摄像头怎么办：用视频流服务器做转换
很多工业、园区和市政项目已经部署了大量摄像头，摄像头原始协议可能是 RTSP、RTMP、GB28181 或 SRT。这些协议本身并不适合直接放到 App 或小程序中播放，因此通常需要一台视频流服务器进行转换。
可以把它理解成一座“视频转换站”：
- 摄像头、NVR 或原有视频平台把视频流送到视频流服务器。
- 视频流服务器将原始协议转换成 HLS 或 FLV 播放地址。
- ThingsCloud 看板或 ThingsX App 通过视频组件播放这些地址。
- 传感器数据、设备状态和告警仍然通过 ThingsCloud 的设备接入体系进行管理。
官方文档中推荐的开源方案是 SRS。SRS 可以接收 RTSP、RTMP、SRT、GB28181、WebRTC 等输入，并输出 HLS、FLV 等播放地址。对于多摄像头项目，也可以把 SRS 部署在园区、工厂或机房现场的边缘服务器上，再按项目需要转发到云端或局域网访问。
有一点必须提前规划：看板和 App 面板中的视频播放需要使用 HTTPS 加密地址。如果视频流服务器只提供 HTTP 地址，App 或小程序可能会因为非安全内容而无法加载视频。
在看板和 App 中怎么放视频
视频接入完成后，真正面向业务人员的是两个入口：可视化看板和 ThingsX App。
在可视化看板中，可以从音视频分类中添加视频组件。根据视频来源选择萤石视频监控、HLS 视频播放或 FLV 视频播放，然后配置摄像头序列号或视频播放 URL。视频组件和图表、地图、指标卡、告警统计等组件一样，可以按项目驾驶舱的布局进行组合。
在 ThingsX App 的设备面板中，可以把视频放到设备详情页中。常见做法是：
- 设备首页展示关键数据，如温度、湿度、电压、电流、在线状态。
- 视频分页展示现场画面，方便移动端人员查看。
- 告警信息和设备控制项放在同一面板中，便于异常确认和远程处置。
对于 HLS / FLV 方式，视频播放 URL 可以作为设备属性保存。对于萤石云方式，App 中每个设备通过扩展信息关联一个萤石摄像头序列号。
选型建议
如果还没有采购摄像头，并且希望尽快把视频能力加入 ThingsCloud 项目，可以优先考虑萤石云摄像头。它不需要维护流媒体服务器，适合中小型项目、演示项目和标准化交付项目。
如果已经有大量 IP 摄像头、NVR 或国标平台，并且项目具备一定服务器运维能力，可以考虑通过 SRS 等视频流服务器转换成 HLS 或 FLV，再接入 ThingsCloud 的视频组件。
如果项目要兼顾 iOS、Android、App 和小程序，优先选择 HLS。如果项目更关注低延迟实时查看，并且终端环境允许，FLV 会更合适。
如果项目中既有物联网传感器，又有视频监控，建议把视频当作“现场确认入口”，把传感器数据和告警当作“业务判断入口”。两者放在同一个看板或 App 中，才能真正提升运维效率。
结语
摄像头视频接入 ThingsCloud 的关键，不是把视频系统替换掉，而是把现场画面接入物联网应用场景。
萤石云适合快速集成，HLS 适合广泛兼容，FLV 适合低延迟查看；已有 RTSP、RTMP、GB28181 等摄像头时，可以通过 SRS 等视频流服务器转换为可播放的视频地址。
当视频、设备数据、告警和移动 App 组合在一起，管理人员就不再只是“看数据”，而是可以在同一个平台中完成发现异常、查看现场、判断风险和安排处置的完整流程。
更多配置细节可以参考 ThingsCloud 官方文档：
关于 ThingsCloud
ThingsCloud 是新一代物联网设备统一接入平台，帮助企业在极短的时间内搭建个性化的物联网平台和应用，并适应不断变化的发展需求。目前广泛应用于制造、电力、能源、环境、农业、楼宇、家居、教育、交通、物流、自动化等领域。
ThingsCloud 可接入各类网关，传感器、执行器、控制器、通信模组、智能硬件等，实现数据采集、远程控制，数据分析、告警通知、智能联动。还可以零代码生成项目应用 SaaS 和用户应用 App，并开放 API 和实时消息，便于业务系统集成和扩展开发。
通过使用 ThingsCloud，企业可以大大缩短搭建物联网系统的时间，节省软件开发费用，降低定制开发的风险，快速落地数字化和智能化项目。我们的客户遍布各行业，包括中国石化、中国铁塔、中国燃气、吉林大学、北控水务、ACE、中国民航大学、西安交通大学、精量电子、大秦铁路、宁波水利局等。
