Quartz 4

🔍 搜索

android 合成管线相关知识

6 min read

Android 合成管线相关知识

acquireNextBufferLocked - VRI[NotificationShade]#4068(f:0,a:2)frame=182

整体含义

这是 Android BLASTBufferQueue 在 SurfaceFlinger 合成流程中记录的一个 trace slice，表示 SurfaceFlinger 正在从 NotificationShade 窗口的 BufferQueue 中获取（acquire）下一帧 buffer。

逐字段解析

字段值含义
acquireNextBufferLocked-BLASTBufferQueue 的核心方法，从 BufferQueue 消费者端获取下一个可用的 GraphicBuffer。源码位于 frameworks/native/libs/gui/BLASTBufferQueue.cpp
VRIViewRootImplVRI = ViewRootImpl，Android View 层级的根节点，负责View 树的绘制调度。每个窗口对应一个 ViewRootImpl 实例
NotificationShade窗口名称系统通知栏/下拉面板窗口（状态栏下拉后的通知面板）
#4068Surface 序列号该 BLASTBufferQueue/Layer 的唯一标识序号
f:0mNumFrameAvailable = 0当前 BufferQueue 中等待被消费的帧数为 0（该帧被acquire 后队列已空）
a:2mNumAcquired = 2当前已被 acquire 但尚未释放的 buffer 数量为2（包含本次 acquire 的这帧）
frame=182mFrameNumber = 182帧序号 182，这是该 Surface 生产的第 182 帧 buffer

在渲染管线中的位置

App RenderThread BLASTBufferQueue SurfaceFlinger │ │ │ │───── dequeueBuffer ────────>│ │ │<──── buffer ───────────────│ │ │──── draw & queueBuffer ──────>│ │ │ │── onFrameAvailable │ │ │ (mNumFrameAvailable++) │ │ │ │ │ │<── acquireNextBufferLocked ──│ ← 你看到的这个 │ │ (mNumFrameAvailable—, │ │ │ mNumAcquired++) │ │ │── Transaction.apply() ──────>│ │ │ │── 合成显示

f:0, a:2 的实际意义

  • f:0：acquire 此帧后，队列中没有更多待处理的帧，说明生产者（App）和消费者（SF）节奏基本同步
  • a:2：有 2 个 buffer 已被 acquire 但尚未 release（通常 mMaxAcquiredBuffers 默认为 1，但系统内部允许 max+1）。如果 a 持续偏高，可能意味着 SurfaceFlinger 合成存在延迟

Sources

  • BLASTBufferQueue.cpp - AOSP
  • BLASTBufferQueue.cpp - Git at Google
  • ViewRootImpl.java - AOSP
  • BLASTBufferQueue 详解
  • SurfaceFlinger BlastBufferQueue 生产者消费者模型
  • BufferQueue and Gralloc - Android 官方文档

f:0（mNumFrameAvailable）深度解析

一句话定义

mNumFrameAvailable 是 BLASTBufferQueue 内部的一个影子计数器（shadow counter），追踪生产者已 queue 但消费者尚未 acquire 的帧数。

生命周期：何时加、何时减

App (Producer) BLASTBufferQueue SurfaceFlinger │ │ │ │─────── queueBuffer() ───────────────>│ │ │ │ onFrameAvailable() │ │ │ mNumFrameAvailable++ ← 【+1】 │ │ │ │ │ │ acquireNextBufferLocked() │ │ │ acquireBuffer() │ │ │ mNumFrameAvailable— ← 【-1】 │ │ │ mNumAcquired++ │ │ │── Transaction.apply() ───────────>│ │ │ │ │ │ releaseBufferCallback() │ │ │ mNumAcquired— │ │ │ mPendingRelease.emplace() │

操作函数效果
+1onFrameAvailable()生产者 queue 了一帧新 buffer
-1acquireNextBufferLocked()消费者 acquire 了一帧 buffer
-1acquireAndReleaseBuffer()同步等待期间丢弃中间帧（drop frame）

f:0 具体意味着什么

在你的 trace 中：

acquireNextBufferLocked - VRI[NotificationShade]#4068(f:0,a:2)frame=182

f:0 表示：在 acquire 第 182 帧之后，BufferQueue 中已经没有待消费的帧了。

这对应以下时序：

时间线 →

onFrameAvailable: mNumFrameAvailable = 0 → 1 (第182帧入队) acquireNextBuffer: mNumFrameAvailable = 1 → 0 (第182帧被取走) ↑ 此时记录 f:0

不同 f 值的性能含义

f 值状态含义
f:0正常/理想生产消费节奏同步，帧产出一帧就被消费一帧，无积压
f:1轻微积压队列中还有 1 帧没被消费，可能是 SF 合成稍慢
f:≥2明显积压生产速度远快于消费速度，可能触发 drop frame（acquireAndReleaseBuffer 丢弃中间帧），是掉帧/卡顿的信号

与 QueuedBuffer trace counter 的关系

在 Perfetto 中你还会看到一条 counter track 叫 QueuedBuffer - VRI[NotificationShade]#4068，它的计算公式是：

QueuedBuffer = mNumFrameAvailable + mNumAcquired - mPendingRelease.size()

这个 counter 追踪的是整个 pipeline 中「在途」的 buffer 总数（已 queue 未 release），而 f 只是其中「已 queue 未 acquire」的部分。

源码关键片段（AOSP BLASTBufferQueue.cpp）

 // onFrameAvailable - 生产者 queue 完一帧后的回调
  void BLASTBufferQueue::onFrameAvailable(const BufferItem& item) {
      std::lock_guard lock(mMutex);
      // ...
      mNumFrameAvailable++;  // ← f 值 +1
      // 同步等待期间如果积压≥2帧，丢弃旧帧
      if (waitForTransactionCallback && mNumFrameAvailable >= 2) {
          acquireAndReleaseBuffer();  // ← f 值 -1（丢帧）
      }
      // ...
      acquireNextBufferLocked();
  }

  // acquireNextBufferLocked - 实际获取 buffer
  status_t BLASTBufferQueue::acquireNextBufferLocked(...) {
      // 检查是否超过最大 acquire 数
      if (maxBuffersAcquired()) {
          return BufferQueue::NO_BUFFER_AVAILABLE;
      }
      // acquire buffer
      mBufferItemConsumer->acquireBuffer(&bufferItem, 0, false);
      mNumFrameAvailable--;  // ← f 值 -1
      mNumAcquired++;        // ← a 值 +1
      // 构建 Transaction 提交给 SurfaceFlinger
      // ...
  }

总结

f:0 = 健康状态。你的 NotificationShade 窗口产出第 182 帧后被立刻消费，没有积压。如果在分析卡顿时看到 f:≥2，就需要关注消费者侧（SurfaceFlinger 合成）是否存在瓶颈。

Sources:

  • BLASTBufferQueue.cpp - AOSP Source
  • BLASTBufferQueue 详解
  • SurfaceFlinger BlastBufferQueue 生产者消费者模型
  • BLASTBufferQueue 源码深入理解
  • BufferQueue and Gralloc - Android 官方文档

Graph View