Mediamtx项目中WebRTC runOnDemand的MTX_QUERY参数传递问题解析

在Mediamtx流媒体服务器1.10.0版本中，开发人员发现了一个关于WebRTC协议下runOnDemand脚本参数传递的问题。这个问题表现为当客户端通过WebRTC协议连接服务器时，URL查询参数无法正确传递给runOnDemand脚本的环境变量MTX_QUERY。

问题现象

当使用WebRTC协议连接服务器时，例如通过浏览器访问类似https://localhost:8889/mystream?q=hello的URL，虽然MTX_PATH环境变量能正确设置为"mystream"，但MTX_QUERY环境变量却保持为空。这与RTSP协议的行为形成鲜明对比，因为在RTSP协议下（如rtsp://localhost:8554/mystream?q=hello），MTX_QUERY环境变量能够正确接收并传递URL查询参数。

技术背景

Mediamtx是一个开源的流媒体服务器，支持多种协议包括RTSP、WebRTC等。runOnDemand是Mediamtx的一个重要功能，它允许在客户端请求特定路径时动态启动外部脚本处理流媒体。这个功能通过设置一系列环境变量（如MTX_PATH和MTX_QUERY）向脚本传递客户端请求的相关信息。

WebRTC作为一种现代浏览器内置的实时通信技术，与传统的RTSP协议在实现机制上有显著差异。这种差异可能导致某些功能在不同协议下的表现不一致。

问题原因分析

经过项目维护者的调查，这个问题源于WebRTC协议处理层没有正确地将URL查询参数提取并设置到MTX_QUERY环境变量中。虽然路径解析功能正常工作（MTX_PATH设置正确），但查询参数处理环节存在遗漏。

解决方案

项目维护团队在后续版本中修复了这个问题。修复涉及对WebRTC协议处理层的修改，确保其能够像RTSP协议一样正确提取和传递URL查询参数。这个修复被包含在1.11.1版本中。

开发者建议

对于需要使用runOnDemand功能的开发者，建议：

1. 如果依赖URL查询参数进行业务逻辑处理，应升级到1.11.1或更高版本
2. 在开发过程中，注意测试不同协议下的参数传递行为
3. 对于关键业务逻辑，应考虑添加参数验证和回退机制

这个问题也提醒我们，在支持多协议的流媒体服务器开发中，保持各协议间功能一致性是一个重要但容易被忽视的方面。协议间的差异可能导致功能表现不一致，需要在设计和测试阶段特别注意。