SRT项目中的监听回调函数使用注意事项

概述

在SRT(安全可靠传输)协议库的1.5.4-RC.0版本中，对srt_listen_callback函数的使用方式进行了重要变更。这一变更影响了在监听套接字上设置回调函数的时机，开发者需要特别注意以避免出现"Operation not supported"错误。

变更背景

在SRT 1.5.3及之前版本中，开发者可以在调用srt_listen函数之后设置监听回调函数。然而，在1.5.4-RC.0版本中，这一行为被修改为出于线程安全考虑，必须在调用srt_listen之前设置回调函数。

典型错误场景

当开发者按照旧版本的编程习惯，在srt_listen之后调用srt_listen_callback时，会收到错误提示："Operation not supported: Cannot do this operation on a CONNECTED socket"。这个错误信息实际上有些误导性，因为此时套接字处于LISTEN状态而非CONNECTED状态。

正确使用方式

正确的调用顺序应为：

1. 创建并绑定套接字
2. 设置监听回调函数
3. 调用srt_listen开始监听
4. 调用srt_accept接受连接

示例代码片段：

// 创建并绑定套接字
if (srt_bind(sock, &sock_addr, sizeof(sock_addr)) < 0) {
    // 错误处理
}

// 设置监听回调函数
if (srt_listen_callback(sock, listenCallback, context) < 0) {
    // 错误处理
}

// 开始监听
if (srt_listen(sock, backlog) < 0) {
    // 错误处理
}

// 接受连接
const int data_sock = srt_accept(sock, &peer_addr, &peer_addr_len);

版本兼容性建议

对于需要同时支持SRT 1.5.3和1.5.4的项目，建议：

1. 统一采用新的调用顺序
2. 在文档中明确说明版本差异
3. 考虑添加版本检测逻辑，为不同版本提供适当的错误提示

技术原理

这一变更背后的技术考虑主要是线程安全性。通过在监听开始前固定回调函数，可以避免在监听过程中回调函数被修改导致的竞态条件。这种设计模式类似于其他网络编程库中"先配置后启动"的原则，确保了配置的原子性和一致性。

总结

SRT 1.5.4版本对监听回调函数的设置时机做出了重要变更，开发者需要调整代码以适应这一变化。理解这一变更背后的线程安全考虑有助于开发者编写更健壮的网络应用程序。在实际开发中，建议仔细阅读API文档，并关注开源项目的版本变更说明。