WebRTC 实现基础概念解析

时间处理机制

在 WebRTC 实现中，时间处理采用 webrtc::Timestamp 类作为核心表示方式。这个类具有以下关键特性：

1. 时间精度：提供微秒级分辨率，使用64位整数存储
2. 时间转换：内置毫秒和秒的转换方法
3. 时钟基准：基于系统单调时钟（monotonic clock）测量，避免系统时钟调整带来的影响

关于时间处理需要注意的几个要点：

• 虽然不强制指定时间纪元（epoch），但在需要绝对时间时默认使用 Unix 时间纪元（1970年1月1日0时GMT）
• 时间格式转换应尽可能靠近需要使用特定格式的接口处进行
• 当前代码库中存在部分未使用 Timestamp 类的遗留代码，正在逐步统一

线程模型与任务调度

WebRTC 采用基于任务队列的执行模型：

1. 核心接口：所有执行都发生在实现 webrtc::TaskQueueBase 接口的任务队列上
2. 任务发布：提供带延迟和不带延迟的任务发布机制
3. 特殊线程：rtc::Thread 作为 TaskQueueBase 的子类，用于核心线程间通信

线程模型的关键设计原则：

• 网络线程(NetworkThread)不能直接调用工作线程(WorkerThread)的方法
• 部分核心线程包含 SocketServer 用于处理I/O操作
• 平台差异通过不同的 TaskQueue 实现来屏蔽

类命名规范与职责

WebRTC 对特定后缀的类有明确的职责约定：

1. Factory 类

• 命名后缀：Factory
• 核心方法：Create
• 行为规范：
  • 创建并返回对象或其所有权引用(std::unique_ptr等)
  • Create 方法不应改变工厂状态(最好标记为const)
  • 所有权完全转移给调用者

2. Builder 类

• 命名后缀：Builder
• 核心方法：Build
• 行为规范：
  • 只能使用一次(Build后即失效)
  • 推荐使用右值引用限定(Foo Build() &&)
  • 构建前提供的资源由构建后的对象接管或释放

3. Manager 类

• 命名后缀：Manager
• 核心方法：Create
• 行为规范：
  • 返回共享所有权引用或保留唯一所有权
  • 负责管理对象的生命周期
  • 管理多类对象时应明确命名(CreateFoo/CreateBar)

同步机制最佳实践

首选方案：任务传递与线程保护

1. 线程保护变量：使用 RTC_GUARDED_BY(thread) 注解
2. 单线程类：包含 SequenceChecker 并使用 RTC_GUARDED_BY(sequence_checker_)
3. 回调安全：使用 webrtc::ScopedTaskSafety 确保回调时对象仍存在

次选方案：同步原语

1. 线程等待：谨慎使用 Thread::BlockingCall(可能导致性能问题)
2. 共享变量：使用 webrtc::Mutex 并标记 RTC_GUARDED_BY(mutex)

已废弃方案

• sigslot → 改用 webrtc::CallbackList 或 std::function
• AsyncInvoker
• RecursiveCriticalSection → 改用非递归 webrtc::Mutex

枚举转字符串规范

当需要将枚举转换为字符串表示时(如暴露给JavaScript接口)，推荐做法：

1. 函数命名：AsString
2. 声明规范：static constexpr 返回 absl::string_view
3. 位置要求：
   • 声明紧随枚举定义之后
   • 实现放在同一头文件末尾(需标记为inline)
4. 非类枚举：可省略static关键字

这种设计既保证了类型安全，又提供了良好的运行时效率。