2. 帧率基础概念与测量方法：理解FPS、帧间隔、Pipeline延迟

帧率是Camera性能最直观的度量，但仅看FPS数字往往掩盖了深层的性能问题。本章从三个核心概念出发——FPS、帧间隔、Pipeline延迟，并给出高通平台下两种主流抓取工具的使用方法。

2.1 核心概念辨析

2.2 帧间隔与Pipeline延迟的关系

下图展示了Camera系统中一帧从Sensor曝光到应用显示的完整路径，以及帧间隔与Pipeline延迟在时间轴上的位置。

2.3 使用 adb shell dumpsys media.camera 抓取帧率数据

dumpsys media.camera 是高通平台最快捷的帧率诊断工具，无需root即可获取Camera HAL层的实时帧统计信息。

2.3.1 基本命令

# 查看所有Camera设备状态
adb shell dumpsys media.camera

# 仅查看特定Camera ID的帧率统计
adb shell dumpsys media.camera -v 5 | grep -A 20 "CameraDeviceClient.*0"

2.3.2 关键输出字段解读

以下是一个典型输出片段及含义：

CameraDeviceClient@3.1:
  mRequestCount: 150
  mResultCount: 148
  mFrameNumber: 148
  mLastFrameNumber: 148
  mFps: 29.8
  mFrameInterval: 33.5 ms
  mMinFrameInterval: 32.1 ms
  mMaxFrameInterval: 38.7 ms
  mJitter: 6.6 ms

2.4 使用 Perfetto 抓取帧率数据

Perfetto 是Android平台最强大的系统级追踪工具，可以精确到微秒级查看每一帧在Camera Pipeline中的完整生命周期。

2.4.1 抓取命令

# 抓取Camera相关trace（推荐）
adb shell perfetto -c - --txt \
  -o /data/misc/perfetto-traces/camera_trace.perfetto \
  <<< 'buffers: { size_kb: 65536 }
data_sources: {
  config {
    name: "android.camera"
    target_buffer: 0
  }
}
data_sources: {
  config {
    name: "android.hwcomposer"
    target_buffer: 0
  }
}
data_sources: {
  config {
    name: "linux.sched"
    target_buffer: 0
  }
}
duration_ms: 5000'

# 拉取到本地
adb pull /data/misc/perfetto-traces/camera_trace.perfetto .

2.4.2 在Perfetto UI中分析帧率

打开 ui.perfetto.dev 加载trace文件后，重点关注以下切片：

• camera_frame：每一帧从HAL到App的完整生命周期，包含request、result、buffer等子阶段
• HWComposer：显示合成时间，反映帧是否被正确送显
• Choreographer：App侧帧绘制调度，判断App是否及时消费帧

2.5 帧率问题快速定位流程

1. 第一步： 使用 dumpsys media.camera 查看HAL层平均FPS和帧间隔抖动。如果FPS达标但抖动大，优先排查Sensor/ISP配置。
2. 第二步： 使用Perfetto抓取5秒trace，查看 camera_frame 切片是否连续。如果出现帧缺失，检查HAL层buffer管理。
3. 第三步： 对比 camera_frame 和 HWComposer 切片。如果camera_frame有帧但HWComposer没有，说明App侧未及时送显。
4. 第四步： 查看 Choreographer 切片，确认App绘制是否与camera帧率同步。如果Choreographer周期不稳定，需要优化App侧UI线程。