3、回放引擎设计：回放引擎架构、时间戳管理、速率控制、状态同步

好，咱们今天聊聊回放引擎。说实话，这东西看着简单，做起来坑不少。

我最早做回放引擎的时候，以为就是把数据按顺序重放一遍。结果第一次跑起来，画面卡得像幻灯片，时间戳对不上，状态全乱套。嗯，后来我才明白——回放引擎的核心，不是“放”，而是“控”。

3.1 回放引擎架构

先说说整体架构。我个人习惯把回放引擎拆成三层：

• 数据层：负责读取和缓存回放数据
• 控制层：管理时间、速率、状态同步
• 渲染层：把数据变成可视化的结果

你想想看，这三层各司其职，才能保证回放流畅。我在项目中遇到过一个问题——数据层读得太慢，控制层等数据，渲染层干瞪眼。后来加了双缓冲队列，才解决。

说白了，数据层是仓库，控制层是调度员，渲染层是展示台。调度员不给力，仓库和展示台再好也没用。

3.2 时间戳管理

时间戳是回放引擎的灵魂。没有准确的时间戳，回放就是一场灾难。

我建议用绝对时间戳，而不是相对时间戳。为什么？

• 绝对时间戳：记录事件发生的真实时间点，比如 2024-01-15 10:30:00.123
• 相对时间戳：记录事件之间的间隔，比如 +150ms

绝对时间戳的好处是——不怕丢数据。我曾经遇到一个项目，用相对时间戳，结果中间丢了一帧，后面所有时间全错位了。那叫一个惨。

时间戳的存储格式，我推荐用 uint64_t，单位是微秒。这样既能表示很大的时间范围，精度也够。

// 时间戳结构体示例
struct Timestamp {
    uint64_t us;  // 微秒级绝对时间戳
};

// 时间戳比较
bool operator<(const Timestamp& a, const Timestamp& b) {
    return a.us < b.us;
}

// 时间戳差值（微秒）
int64_t diff_us(const Timestamp& a, const Timestamp& b) {
    return static_cast<int64_t>(a.us) - static_cast<int64_t>(b.us);
}

3.3 速率控制

速率控制，说白了就是让回放“快一点”或“慢一点”。但这里有个坑——你不能简单地跳过数据。

我常用的速率控制策略有三种：

速率模式	实现方式	适用场景
实时回放	按原始时间戳间隔播放	调试正常流程
慢速回放	放大时间间隔（如 2x、5x）	分析细节问题
快速回放	缩小时间间隔或跳帧	快速浏览长数据

你想想看，慢速回放时，时间间隔放大，但数据不能丢。快速回放时，可以跳帧，但关键帧不能跳。这个平衡点，我调了好几个版本才找到。

速率控制的代码实现，核心是一个时间缩放因子：

class RateController {
public:
    void setSpeed(float speed) {
        // speed: 0.1 ~ 10.0
        speed_ = std::clamp(speed, 0.1f, 10.0f);
    }
    
    Timestamp adjustTimestamp(const Timestamp& original) {
        // 根据速率调整时间戳
        uint64_t adjusted = base_time_.us + 
            static_cast<uint64_t>((original.us - base_time_.us) * speed_);
        return Timestamp{adjusted};
    }
    
private:
    float speed_ = 1.0f;
    Timestamp base_time_;
};

3.4 状态同步

状态同步是回放引擎里最容易被忽视的部分。很多人以为只要时间戳对了，状态自然就对了。其实不是。

我举个例子：你在回放一个自动驾驶的数据，车辆在 t1 时刻刹车，t2 时刻转向。如果状态不同步，可能出现——刹车还没生效，转向已经开始了。这会导致回放结果和真实情况完全不一样。

状态同步的核心原则：先同步状态，再播放数据。

具体做法：

1. 初始化状态：回放开始前，把系统状态设置到起始点
2. 增量更新：每帧只更新变化的部分，不要全量刷新
3. 校验机制：定期检查状态一致性，发现偏差及时修正

状态同步的代码实现，我习惯用快照机制：

class StateSync {
public:
    // 保存当前状态快照
    void saveSnapshot(const Timestamp& t) {
        snapshots_[t.us] = current_state_;
    }
    
    // 恢复到指定时间点的状态
    bool restoreTo(const Timestamp& t) {
        auto it = snapshots_.lower_bound(t.us);
        if (it == snapshots_.begin()) {
            return false;  // 没有更早的快照
        }
        --it;
        current_state_ = it->second;
        return true;
    }
    
private:
    std::map<uint64_t, State> snapshots_;
    State current_state_;
};

嗯，这里要注意——快照不能存太多，否则内存会爆。我一般每隔 1 秒存一个快照，最多保留 10 分钟的数据。

好了，回放引擎的核心设计就这些。记住一句话：时间戳是骨架，速率控制是肌肉，状态同步是血液。三者缺一不可。