Choreographer vsync偏移调优实战 - 第1节

1.1 Choreographer 的作用与定位

Choreographer 是 Android 帧渲染调度中枢，负责统一接收 垂直同步信号（VSYNC），并驱动应用层测量（measure）、布局（layout）、绘制（draw）以及输入事件的分发。其核心作用是确保每一帧的内容在下一个 VSYNC 边界前完成准备，从而使界面刷新与屏幕硬件扫描同步，消除撕裂和掉帧。

1.2 VSYNC 信号产生流程

硬件垂直同步信号由显示控制器（Display Controller）产生，通常对应屏幕刷新率（如 60/90/120Hz）。Android 系统通过 HWComposer 或 HWC2 接收该硬件中断，并将其转换为软件可消费的事件。

信号传递路径如下（简化）：

1. 显示硬件在每帧消隐期（blanking interval）产生 VSYNC 脉冲。
2. HWC 驱动捕获中断，写入 /dev/graphics/fb0 或通过同步框架上报。
3. SurfaceFlinger 作为系统服务监听硬件 VSYNC，并通过 mPrimaryVsyncListener 进行分发。
4. SurfaceFlinger 将 VSYNC 信号进一步派发给 Choreographer 所在的 App 进程（通过 SFEventThread / VSyncSource）。
5. App 端的 FrameDisplayEventReceiver 在 Java 层处理该事件，触发 doFrame()。

1.3 SurfaceFlinger 与 Choreographer 的关系

SurfaceFlinger 是 Android 图形系统服务，负责合成所有可见的 Surface 并提交到显示缓存。它与 Choreographer 的分工如下：

SurfaceFlinger 的 vsync_offset 参数（位于 /sys/class/graphics/fb0/vsync_offset 或通过 dumpsys SurfaceFlinger 查看）直接影响了 Choreographer 接收 VSYNC 的时间点，是调优的核心配置之一。

1.4 整体结构流程图（SVG）

下图展示了从硬件 VSYNC 到 Choreographer 回调的完整链路，并标注了各环节依赖的关键系统服务：

1.5 关键 API 与调试命令

查看当前设备的 VSYNC 参数和 SurfaceFlinger 状态：

# 查看 SurfaceFlinger 的 vsync offset 值（部分设备无此节点）
cat /sys/class/graphics/fb0/vsync_offset

# 使用 dumpsys 查看详细帧渲染信息
adb shell dumpsys SurfaceFlinger --vsync

# 抓取 Choreographer 帧统计
adb shell dumpsys gfxinfo  framestats

Android 源码中 Choreographer 的关键类位置：

# 核心 Java 类
frameworks/base/core/java/android/view/Choreographer.java

# 底层的 FrameDisplayEventReceiver 由 JNI 实现
frameworks/base/core/java/android/view/Choreographer.java
  -> private final class FrameDisplayEventReceiver extends DisplayEventReceiver

# SurfaceFlinger 的 vsync 分发实现
frameworks/native/services/surfaceflinger/SurfaceFlinger.cpp
  -> void SurfaceFlinger::onVSyncReceived(nsecs_t timestamp)

1.6 常见概念误区

• 误区： Choreographer 直接监听硬件中断。
  纠正： 实际通过 SurfaceFlinger 代理，App 进程运行在普通线程无法直接访问底层中断。
• 误区： VSYNC 周期等于屏幕刷新率。
  纠正： 刷新率仅决定了显示硬件发中断的间隔，但软件处理链路中存在偏移和抖动。
• 误区： 调整 vsync_offset 会改变屏幕刷新率。
  纠正： 偏移只改变 App 接收 VSYNC 的时间点，对硬件刷新周期无影响。

1.7 性能与稳定性影响

如果 Choreographer 接收到的 VSYNC 时间点与 SurfaceFlinger 合成窗口错位，可能导致以下问题：