3. 预热延迟定义与测量方法：从 open() 到第一个预览帧的时间拆解

预热延迟（Warm-up Latency）是 Camera HAL 性能优化的核心指标，它直接决定了用户从点击相机图标到看到取景画面的等待时长。本章将明确定义预热延迟的边界，并给出可复现的测量方法，包括使用 adb 命令行工具和 systrace 进行精确的时间拆解。

3.1 预热延迟的定义与时间边界

预热延迟定义为从应用层调用 Camera.open() 到 HAL 层输出第一个预览帧（First Preview Frame）之间的总耗时。这个时间段涵盖了应用层初始化、HAL 驱动加载、ISP 管线配置、传感器启动与帧同步等多个阶段。

为了便于分析，我们将预热延迟拆解为以下四个子阶段：

3.2 使用 adb 进行粗粒度测量

adb 是快速获取预热延迟总值的工具，适合在开发阶段进行回归测试。通过注入日志标记点，可以精确捕获时间戳。

测量步骤：

1. 在应用层 Camera.open() 调用前后添加 Log.d("CameraPerf", "open_start") 和 Log.d("CameraPerf", "open_end")。
2. 在 HAL 层输出第一个预览帧的回调函数中添加 Log.d("CameraPerf", "first_preview_frame")。
3. 使用 adb logcat -s CameraPerf -v time 捕获日志。
4. 计算时间差。

# 清除旧日志，启动相机应用
adb logcat -c
# 手动点击相机图标，或通过 am start 启动
adb shell am start -n com.example.camera/.MainActivity
# 等待 3 秒后停止日志
adb logcat -d -s CameraPerf -v time > camera_latency.log

# 解析日志中的时间戳
# 示例输出：
# 01-01 12:00:01.123 CameraPerf: open_start
# 01-01 12:00:01.456 CameraPerf: open_end
# 01-01 12:00:01.789 CameraPerf: first_preview_frame
# 预热延迟 = 1.789 - 1.123 = 666ms

3.3 使用 systrace 进行精细时间拆解

systrace（现已被 Perfetto 取代，但概念相同）能够以微秒级精度展示每个线程的执行时间线，是分析预热延迟内部瓶颈的黄金工具。通过在关键路径上添加 Trace 标记，可以可视化每个子阶段的耗时。

关键 Trace 标记点：

// C++ HAL 层示例：添加 Trace 标记
#include <utils/Trace.h>

int camera_open(const hw_module_t* module, const char* id,
                hw_device_t** device) {
    ATRACE_NAME("HAL_open");
    // ... 驱动加载逻辑 ...
    ATRACE_INT("Sensor_power_on", 1);
    // ...
}

int configure_streams(const camera3_device_t* device,
                      camera3_stream_configuration_t* config) {
    ATRACE_NAME("ISP_configure_streams");
    // ... 管线配置逻辑 ...
    ATRACE_INT("ISP_pipeline_start", 1);
    // ...
}

systrace 抓取命令：

# 抓取 5 秒的 trace，包含相机相关进程
python systrace.py -t 5 -o camera_warmup.html \
    --app=com.example.camera \
    sched freq idle workq binder_driver

# 在生成的 HTML 中，使用 'w' 键放大时间轴，
# 查找 "HAL_open" 到 "First_preview_frame" 之间的跨度。

3.4 预热延迟拆解流程图

下图展示了从 open() 到第一个预览帧的完整时间线，以及每个子阶段的典型耗时分布。

3.5 常见测量陷阱与避坑指南

• 陷阱一：热启动 vs 冷启动——如果相机进程未被杀死，HAL 驱动可能已经加载，导致测量结果偏小。务必使用 adb shell am force-stop com.example.camera 确保冷启动。
• 陷阱二：日志缓冲区溢出——在密集日志输出时，logcat 可能丢失部分条目。建议使用 logcat -b main -b system -b events 并增大缓冲区大小。
• 陷阱三：systrace 标记未生效——确保编译时开启了 ATRACE_ENABLED 宏，且用户空间 trace 点已通过 setprop debug.atrace.app_number 1 启用。
• 陷阱四：忽略帧同步延迟——第一个预览帧可能因为 VSYNC 对齐而额外等待 0-16ms，这在 60fps 显示下是正常现象，不应计入 HAL 优化范围。