全部文档
当前文档
最近更新时间：2026-05-08 16:41:02
在常规CDN直播场景中，同一域名、同一发布点（App）下，同一流名（StreamName）仅允许一路推流。若需复用同一流名，必须先断开当前推流再重新推送，此过程中客户端会感知到推流中断，影响直播体验。
金山云CDN同流名推流覆盖功能，通过优先级参数实现同流名的无缝推流覆盖。当新推流携带的优先级高于当前推流时，CDN节点会自动以新流覆盖旧流，切换过程平滑无感知，保障直播业务不中断。
应急切换：主推流设备出现故障时，备用设备可携带高优先级参数进行推流，无缝覆盖当前流，确保直播不中断。
灵活切换：多场景切换、画质或码率调整时，可复用同一流名进行推流，无需更改客户端的拉流地址，降低运维复杂度。
该功能需联系金山云技术支持协助完成：
用户提交配置需求（含CDN加速域名、发布点等关键信息）；
技术支持后台启用功能并完成相关配置，确保与现有架构兼容；
协助用户进行功能测试验证；
后续如需调整配置，再次联系技术支持即可。
同流名推流覆盖功能的核心是通过优先级参数控制覆盖权限，实现无缝切换。。
前提条件：已联系技术支持完成功能配置，CDN节点已开启推流覆盖功能。
参数定义：推流URL中可携带 pri=x 参数（参数可支持自定义，x为正整数），数值越大表示优先级越高。不携带 pri 参数时，不具备自定义优先级，无法覆盖任何带 pri 参数的推流。
首次推流：CDN节点验证推流请求通过后建立会话，正常分发流数据。
覆盖判断：当有新推流请求到达时，CDN节点会比较新流与当前流的优先级。若新流的pri值高于当前流的pri值，则触发覆盖，新流替换旧流；若新流的pri值低于或等于当前流的pri值，则拒绝新推流请求。
假设推流域名为 push-rtmp.com，发布点为 live，流名为 streamname。
第一次推流（优先级为1）：
rtmp://push-rtmp.com/live/streamname?pri=1
不携带 pri 参数时，不具备自定义优先级，无法覆盖任何带 pri 参数的推流。
第二次推流（优先级为2，高于第一次）：
rtmp://push-rtmp.com/live/streamname?pri=2
第二次推流携带的pri值大于第一次推流的值，CDN节点将触发覆盖，以新流替换旧流，客户端拉流无感知。
pri参数仅支持正整数，请根据业务需求合理设置优先级数值，避免因优先级设置不当导致误覆盖或无法覆盖。
覆盖触发条件仅适用于同一域名、同一发布点下的同流名推流。
该功能需联系技术支持完成配置后方可使用。
建议先在测试环境中验证功能效果，确认无误后再应用于生产业务，避免影响线上直播。
纯净模式
