Android Graphics 显示系统 - 监测、计算FPS的工具及设计分析

“ 在Android图像显示相关的开发、调试、测试过程中，如何能有效地评估画面的流畅度及监测、计算图层渲染显示的实时FPS呢？本篇文章将会提供一种实用、灵巧的思路。”

01 设计初衷

面对开发测试中遇到的卡顿掉帧问题，如何在复现卡顿的过程中持续监控FPS 和丢帧情况？特别是视频播放的场景，掉帧与FPS不稳定会带来糟糕的用户体验。因此需要有一款小工具可以实时监测图层渲染、显示的FPS变化，以便于判断是否FPS不稳定或掉帧。

02 设计原理

参考了网上现有的 FPS 计算方式原理，一定程度上满足自己的预期需求，但要么自己设计脚本计算逻辑处理，要么就要修改到源码。

方式1. 写作FPS计算脚本

基于dumpsys SurfaceFlinger --latency Layer-name或dumpsys gfxinfo获取信息，然后设计计算逻辑。

方式2. 修改SF源码呼叫computeFps

修改SurfaceFlinger的逻辑，利用原生computeFps方法来计算指定图层的FPS.

float FrameTimeline::computeFps(const std::unordered_set<int32_t>& layerIds)

那有没有其它方式呢？

当然！

我们留意到在SurfaceFlinger的源码中有一个FpsReporter，里面有提供注册监听器的接口，看起来可以利用！

class FpsReporter : public IBinder::DeathRecipient {
public:FpsReporter(frametimeline::FrameTimeline& frameTimeline, SurfaceFlinger& flinger,std::unique_ptr<Clock> clock = std::make_unique<SteadyClock>());....// Registers an Fps listener that listens to fps updates for the provided layervoid addListener(const sp<gui::IFpsListener>& listener, int32_t taskId);// Deregisters an Fps listenervoid removeListener(const sp<gui::IFpsListener>& listener);....
}

再接着看下IFpsListener的定义，顾名思义，当fps变化时就会回调到

/frameworks/native/libs/gui/aidl/android/gui/IFpsListener.aidl
oneway interface IFpsListener {// Reports the most recent recorded fps for the tree rooted at this layervoid onFpsReported(float fps);
}

那用户层有无提供设置的接口呢？

先看SurfaceComposerClient中的定义，确实也存在add/remove方法

/frameworks/native/libs/gui/include/gui/SurfaceComposerClient.h
static status_t addFpsListener(int32_t taskId, const sp<gui::IFpsListener>& listener);
static status_t removeFpsListener(const sp<gui::IFpsListener>& listener);

那设计原理有了：设计一个C++小工具，注册fps listener，就可以监测特定task的fps了。

03 设计实现

源码下载

废话不说直接开源给大家，如果觉得有用 期待您点赞！

yrzroger/FpsMonitor: 监测Android平台实时刷新率FPS (github.com)

使用说明

下载main branch，基于Android 14平台开发，代码放到android源码目录下
执行mm编译获得可执行档 FpsMonitor
方式测试设备 adb push FpsMonitor /data/local/tmp/
执行 adb shell am stack list 获取要监测的应用的 taskId
adb shell /data/local/tmp/FpsMonitor -t taskId 运行程序
输入‘q’ 或者 Ctrl+C 退出监测

效果展示

在console log中打印出实时的FPS

在屏幕左上角展示当前的屏幕的刷新率和Task图层渲染显示的帧率

04 设计分析

自己实现 IFpsListener，在onFpsReported中做想做的事情

struct TaskFpsCallback : public gui::BnFpsListener {
binder::Status onFpsReported(float fps) override {// 收到FPS，do what you want
}
}

注册监听器到SurfaceFlinger

    sp<TaskFpsCallback> callback = new TaskFpsCallback();if (SurfaceComposerClient::addFpsListener(mTaskId, callback) != OK) {ALOGD("addFpsListener error!");return -1;}

UI显示

RefreshRateOverlay类中封装实现UI显示的逻辑，这部分源自SurfaceFlinger中的逻辑，本质也是创建Native Surface，然后使用Skia在Surface上绘制数字，不细讲。

05 再探FpsReporter::dispatchLayerFps

大家要留意一点，注册的IFpsListener是和Task绑定的，而一个Task通常会关联多个图层，因为有Child Layer，所以任何一个图层的变化都是导致FPS变化。

因此：

我们的小工具有一个局限，那就是跟踪单一图层的FPS会受到场景限制，比如视频播放时，如果视频图层上有其他UI变化(隶属同一个Task)，那计算出的FPS就不仅仅是解码视频显示的FPS了

SurfaceFlinger中合成阶段会去调用FpsReporter::dispatchLayerFps

void SurfaceFlinger::postComposition(nsecs_t callTime) {....Mutex::Autolock lock(mStateLock);if (mFpsReporter) {mFpsReporter->dispatchLayerFps();}....
}

dispatchLayerFps会去遍历所有layers，找到和task对应的layer及child layers，然后呼叫computeFps计算，最终回调listener->onFpsReported

void FpsReporter::dispatchLayerFps() {const auto now = mClock->now();if (now - mLastDispatch < kMinDispatchDuration) {return;}std::vector<TrackedListener> localListeners;{std::scoped_lock lock(mMutex);if (mListeners.empty()) {return;}std::transform(mListeners.begin(), mListeners.end(), std::back_inserter(localListeners),[](const std::pair<wp<IBinder>, TrackedListener>& entry) {return entry.second;});}std::unordered_set<int32_t> seenTasks;std::vector<std::pair<TrackedListener, sp<Layer>>> listenersAndLayersToReport;mFlinger.mCurrentState.traverse([&](Layer* layer) {auto& currentState = layer->getDrawingState();if (currentState.metadata.has(gui::METADATA_TASK_ID)) {int32_t taskId = currentState.metadata.getInt32(gui::METADATA_TASK_ID, 0);if (seenTasks.count(taskId) == 0) {// localListeners is expected to be tinyfor (TrackedListener& listener : localListeners) {if (listener.taskId == taskId) {seenTasks.insert(taskId);listenersAndLayersToReport.push_back({listener, sp<Layer>::fromExisting(layer)});break;}}}}});for (const auto& [listener, layer] : listenersAndLayersToReport) {std::unordered_set<int32_t> layerIds;layer->traverse(LayerVector::StateSet::Current,[&](Layer* layer) { layerIds.insert(layer->getSequence()); });listener.listener->onFpsReported(mFrameTimeline.computeFps(layerIds));}mLastDispatch = now;
}

06 拓展

是否可以设置APP实现FPS监测呢？

在WMS中，也是有提供registerTaskFpsCallback的接口，可以在app层面使用监测FPS，本质原理是一样的，只是通过JNI呼叫到了SurfaceComposerClient::addFpsListener。

/frameworks/base/services/core/java/com/android/server/wm/WindowManagerService.java@Override@RequiresPermission(Manifest.permission.ACCESS_FPS_COUNTER)public void registerTaskFpsCallback(@IntRange(from = 0) int taskId,ITaskFpsCallback callback) {if (mContext.checkCallingOrSelfPermission(Manifest.permission.ACCESS_FPS_COUNTER)!= PackageManager.PERMISSION_GRANTED) {final int pid = Binder.getCallingPid();throw new SecurityException("Access denied to process: " + pid+ ", must have permission " + Manifest.permission.ACCESS_FPS_COUNTER);}if (mRoot.anyTaskForId(taskId) == null) {throw new IllegalArgumentException("no task with taskId: " + taskId);}mTaskFpsCallbackController.registerListener(taskId, callback);}@Override@RequiresPermission(Manifest.permission.ACCESS_FPS_COUNTER)public void unregisterTaskFpsCallback(ITaskFpsCallback callback) {if (mContext.checkCallingOrSelfPermission(Manifest.permission.ACCESS_FPS_COUNTER)!= PackageManager.PERMISSION_GRANTED) {final int pid = Binder.getCallingPid();throw new SecurityException("Access denied to process: " + pid+ ", must have permission " + Manifest.permission.ACCESS_FPS_COUNTER);}mTaskFpsCallbackController.unregisterListener(callback);}

如何监测单一图层的FPS，避免上面提到的局限呢？

可以考虑采用文章开头提到的方式1 、方式2。或者对SurfaceFlinger动动手脚。

本文基于 Android U 源码解析，请结合完整源码阅读！

关注公众号，优质内容