1. 萤石云RTMP协议基础认知第一次接触萤石云视频流开发时我被各种协议搞得头晕眼花。RTMP、RTSP、HLS这些专业名词听起来高大上其实理解起来并不复杂。简单来说RTMP就像快递公司的加急专送特点是传输速度快、延迟低特别适合需要实时交互的视频监控场景。萤石云的RTMP协议地址长得很有规律比如这个典型例子rtmp://rtmp.open.ys7.com/openlive/ff01018a141094b7fa138b9d0b856507b.hd把它拆解来看rtmp://协议标识就像快递单上的加急标签rtmp.open.ys7.com萤石的流媒体服务器地址相当于快递中转站openlive固定路径表示这是标准流服务ff01018a141094b7fa138b9d0b856507b设备唯一ID相当于收件人身份证号.hd清晰度标识类似快递包裹的易碎品标记实测下来RTMP的延迟通常在2-4秒比HLS协议的4-10秒快不少。有个项目我同时测试了两种协议HLS在手机网页上播放很顺畅但做实时监控时明显感觉画面滞后换成RTMP后操作员反馈跟实际动作基本同步。2. 设备接入前的关键配置去年给某学校部署监控系统时我们踩过一个坑所有摄像头画面都是黑屏。折腾半天才发现是码流加密没关闭。这里分享几个必须检查的配置项关闭码流加密的操作路径打开萤石云视频APP进入设备设置 → 局域网配置找到平台接入选项确保码流加密处于关闭状态视频编码设置更重要。有次客户抱怨画面卡顿过去一看发现子码流设成了H.265。虽然H.265压缩率高但很多老设备不支持。建议统一设为H.264具体操作通过显示器连接录像机进入主菜单 → 配置 → 编码参数分别设置主码流和子码流为H.264分辨率建议主码流1080P子码流720P还有个容易忽略的点是NTP时间同步。某商场项目就出现过录像时间戳错乱的问题后来发现是摄像头时区设错了。正确的做法是在设备网络设置里配置NTP服务器为pool.ntp.org3. 获取RTMP流地址的三种方式3.1 通过开放平台控制台获取这是最直观的方法适合快速测试登录 萤石开放平台进入设备管理 → 选择目标摄像头点击直播地址标签页在RTMP协议栏复制地址不过这种方式有个限制地址有效期默认只有24小时。有次做演示时地址突然失效场面相当尴尬。后来发现可以在有效期下拉框选择更长时间最长能设7天。3.2 调用API接口动态获取对于需要集成到系统的场景推荐使用API方式。核心接口是这个POST /api/lapp/v2/live/address/get我封装了一个Python示例import requests def get_rtmp_url(access_token, device_serial): url https://open.ys7.com/api/lapp/v2/live/address/get headers {Content-Type: application/x-www-form-urlencoded} data { accessToken: access_token, deviceSerial: device_serial, protocol: 3, # 3表示RTMP quality: 1 # 1-高清2-流畅 } response requests.post(url, headersheaders, datadata) if response.json().get(code) 200: return response.json()[data][url] else: raise Exception(获取失败 response.json().get(msg))这个接口有几个实用参数expireTime设置有效期30秒到7天supportH265指定编码格式gbchannel国标设备通道号3.3 通过设备直连生成地址当网络环境特殊无法连接云端时可以用这个公式手动拼接rtmp://{摄像头IP}:1935/live/{通道号}?auth{鉴权码}鉴权码需要通过这个接口获取GET /api/v1/device/authorize?serial{设备序列号}4. 接口调用实战与排错最近在做一个智能停车场的项目调用接口时遇到个典型问题返回403错误。经过排查发现是access_token过期了。这里分享几个常见错误码的解决方法错误码200以外的处理流程401检查access_token是否过期有效期默认24小时403确认设备序列号是否正确404检查接口路径是否为v2版本500等5分钟重试可能是服务器临时故障请求参数易错点deviceSerial要带字母大写channelNo从1开始计数protocol参数要用数字而非字符串这是我优化后的请求示例params { accessToken: at.abcdef123456..., # 注意前缀at. deviceSerial: C12345678, # 注意C要大写 channelNo: 1, # 整数非字符串 protocol: 3, # 必须传数字 expireTime: 86400 # 单位秒 }返回数据解析也有讲究。正确的处理顺序应该是先检查code是否为200再检查data中的ret字段最后看status和exception字段5. 流地址的应用集成测试拿到RTMP地址后我习惯用三种方式测试VLC播放测试打开VLC → 媒体 → 打开网络串流粘贴rtmp地址点击播放 如果黑屏可以在工具 → 消息里看详细错误FFmpeg推流测试ffmpeg -re -i test.mp4 -c copy -f flv 你的RTMP地址这个命令可以模拟实时推流测试带宽承受能力网页播放测试 推荐使用flv.js库代码示例script srchttps://cdn.jsdelivr.net/npm/flv.js/dist/flv.min.js/script video idvideoElement controls/video script if (flvjs.isSupported()) { var player flvjs.createPlayer({ type: flv, url: 你的RTMP地址 }); player.attachMediaElement(videoElement); player.load(); player.play(); } /script实际项目中遇到过RTMP地址突然失效的情况。后来我们做了两点优化设置定时任务提前1小时刷新地址增加RTMP心跳检测断开自动重连对于需要7×24小时稳定的场景建议考虑萤石云的EZOPEN协议虽然集成稍复杂但稳定性更好。不过这就超出今天RTMP的讨论范围了。