4. 人脸关键点实时追踪

原理：从逐帧检测到时空一致追踪

逐帧独立检测人脸关键点虽然直接，但在实时 AR 特效中会产生明显的视觉抖动和延迟抖动。根本原因在于单帧检测结果缺乏时序约束：相邻帧的微小分类偏差会放大为空间上的跳跃。本章引入以稀疏光流为核心的追踪-滤波框架，在检测间隔内通过像素运动场预测关键点位置，并利用时域滤波剔除异常抖动。

稀疏光流（如 OpenCV 的 calcOpticalFlowPyrLK）基于亮度恒定假设，对已检测到的关键点邻域进行局部搜索，计算量远小于重新运行整个人脸检测模型。时域滤波则对光流输出的轨迹进行平滑：指数移动平均（EMA）公式为 P_t = α · D_t + (1 - α) · P_{t-1}，其中 D_t 为当前检测值，P_t 为平滑后的输出，α 控制响应速度与平滑度的平衡。

实现流程：追踪-剔除-平滑-补偿

1. 检测初始化： 在首帧或追踪丢失时，运行 MediaPipe FaceMesh 或类似检测器，获取 468 个关键点。
2. 光流预测： 对上一帧的每个关键点，调用 cv2.calcOpticalFlowPyrLK 计算其在当前帧的位置，作为预测值。
3. 抖动剔除： 若光学追踪失败（返回状态为 0）或关键点 L2 位移超过阈值（如 30px），标记为异常点并弃用该预测值。
4. 时域滤波： 将保留下来的预测值与历史平滑值进行 EMA 融合，输出临时结果。
5. 低帧率补偿： 若检测帧间隔大于 1（例如丢帧），基于运动模型（匀速或匀加速）插值中间位置，避免输出冻结。
6. 状态更新： 将平滑后的关键点写入历史缓冲区，用于下一帧光流计算。

代码与 API 示例（Python + OpenCV / MediaPipe）

以下代码片段展示了如何使用 cv2.calcOpticalFlowPyrLK 进行多级金字塔光流追踪，并结合 EMA 平滑器输出稳定关键点。

import cv2
import mediapipe as mp
import numpy as np

class LandmarkTracker:
    def __init__(self, alpha=0.4, jitter_thresh=30.0):
        self.alpha = alpha
        self.jitter_thresh = jitter_thresh
        self.prev_landmarks = None
        self.smoothed_landmarks = None
        self.lk_params = dict(
            winSize=(15, 15),
            maxLevel=3,
            criteria=(cv2.TERM_CRITERIA_EPS | cv2.TERM_CRITERIA_COUNT, 10, 0.03)
        )

    def update(self, frame, detected_landmarks):
        # detected_landmarks: shape (N, 2) 当前帧检测结果
        if detected_landmarks is None or len(detected_landmarks) == 0:
            # 追踪丢失，返回上一帧平滑结果或 None
            return self.smoothed_landmarks

        if self.prev_landmarks is not None and len(self.prev_landmarks) > 0:
            # 光流追踪
            next_pts, status, _ = cv2.calcOpticalFlowPyrLK(
                self.prev_gray, frame, self.prev_landmarks.astype(np.float32), None, **self.lk_params
            )
            # 抖动剔除
            valid_mask = (status.flatten() == 1)
            diff = np.linalg.norm(next_pts[valid_mask] - detected_landmarks[valid_mask], axis=1)
            valid_mask[valid_mask] = (diff < self.jitter_thresh)

            if np.sum(valid_mask) > 5:  # 至少保留 5 个点
                predicted = next_pts.copy()
                # 对无效点使用检测值回退
                predicted[~valid_mask] = detected_landmarks[~valid_mask]
                # EMA 时域滤波
                if self.smoothed_landmarks is not None:
                    predicted = self.alpha * predicted + (1 - self.alpha) * self.smoothed_landmarks
                self.smoothed_landmarks = predicted
                self.prev_landmarks = predicted.copy()
                self.prev_gray = frame.copy()
                return self.smoothed_landmarks

        # 首次运行或追踪全面失败时直接使用检测值初始化
        self.smoothed_landmarks = detected_landmarks.copy().astype(np.float32)
        self.prev_landmarks = detected_landmarks.copy().astype(np.float32)
        self.prev_gray = frame.copy()
        return self.smoothed_landmarks

调试与诊断

调试时需要可视化三组数据：原始检测值、光流预测值、滤波输出值。将三者叠加绘制在图像上（用不同颜色：蓝、红、绿），观察以下关键指标：

• 追踪丢失： 若预测值频繁被剔除导致回退到检测值，说明光流窗口过小或运动幅度过大。
• 相位延迟： 如果平滑后的关键点在快速转头时明显滞后于真实位置，应增大 EMA 的 α 值或改用卡尔曼滤波。
• 漂移累积： 长时间光流追踪后关键点逐渐偏离面部轮廓，需要周期性强制重新检测（例如每 30 帧重置追踪器）。

部署与稳定性清单