第30章实战项目二

课程目录第30章实战项目二

实战项目二：实现一个车载仪表盘应用（涉及 Cluster 服务与车辆信号）

好，咱们进入第二个实战项目。说实话，仪表盘应用是车载开发里最「刺激」的部分——你想想看，时速表、转速表、故障灯，哪个都不能出错。我在做第一个量产项目时，就因为一个信号延迟问题，差点让测试车在路试时亮错故障灯。嗯，从那以后我对 Cluster 这块就格外上心。

项目背景与目标

这个项目我们要做一个数字仪表盘，跑在 Android Automotive OS 上。它要能实时显示车速、转速、油量、转向灯状态。说白了，就是把传统机械仪表盘搬到屏幕上。

核心目标有三个：

通过 CarClusterService 获取车辆信号
实现仪表盘的 UI 渲染，保证 60fps 流畅度
处理信号延迟和异常情况

关键点：仪表盘应用属于系统级应用，有最高优先级。它不能像普通 App 那样被杀掉，也不能有卡顿。我见过有些团队用 WebView 做仪表盘，结果冷启动要 3 秒——这在车上绝对不行。

系统架构概览

先看整体架构。我画了一张图，帮你理清各个模块的关系：

从图里你能看到，车辆信号从 CAN 总线出发，经过 Vehicle HAL、CarService，最终通过 CarClusterService 到达仪表盘应用。我习惯把 CarClusterService 看作一个「信号路由器」——它负责把原始车辆信号转换成 UI 层能直接用的数据。

CarClusterService 的核心接口

咱们直接看代码。CarClusterService 提供了几个关键接口：

// 获取车速信号
public float getVehicleSpeed() {
    // 返回 km/h
    return mCar.getCarPropertyManager()
        .getProperty(VehicleProperty.PERF_VEHICLE_SPEED, 0);
}

// 获取发动机转速
public float getEngineSpeed() {
    // 返回 RPM
    return mCar.getCarPropertyManager()
        .getProperty(VehicleProperty.ENGINE_RPM, 0);
}

// 获取油量
public float getFuelLevel() {
    // 返回百分比 0-100
    return mCar.getCarPropertyManager()
        .getProperty(VehicleProperty.FUEL_LEVEL, 0);
}

我的经验：别在主线程里直接调用 getProperty()。车辆信号更新频率很高，我见过有人这么干，结果 UI 线程被堵死，仪表盘直接卡成 PPT。正确的做法是用回调监听。

注册信号监听器

正确的姿势是注册一个 CarPropertyEventListener。这样信号一变化，系统就会主动通知你：

CarPropertyManager propertyManager = mCar.getCarPropertyManager();

// 注册车速监听
propertyManager.registerCallback(
    new CarPropertyManager.CarPropertyEventCallback() {
        @Override
        public void onChangeEvent(CarPropertyValue value) {
            if (value.getPropertyId() == VehicleProperty.PERF_VEHICLE_SPEED) {
                float speed = (float) value.getValue();
                // 更新 UI
                runOnUiThread(() -> updateSpeedDisplay(speed));
            }
        }

        @Override
        public void onErrorEvent(int propertyId, int zone) {
            // 处理错误
            Log.e("ClusterDemo", "信号错误: " + propertyId);
        }
    },
    VehicleProperty.PERF_VEHICLE_SPEED,
    0  // 区域 ID，一般传 0
);

这里有个坑——回调频率。车速信号可能每 100ms 就更新一次，但 UI 刷新没必要那么快。我建议做个节流：

private long lastUpdateTime = 0;
private static final long THROTTLE_MS = 200; // 200ms 刷新一次

@Override
public void onChangeEvent(CarPropertyValue value) {
    long now = System.currentTimeMillis();
    if (now - lastUpdateTime < THROTTLE_MS) {
        return; // 跳过这次更新
    }
    lastUpdateTime = now;
    // 更新 UI
}

注意：有些车辆信号（比如转向灯）变化很快，但 UI 动画可以平滑过渡。别让每个信号都直接驱动 UI 变化，否则动画会显得很生硬。我一般会用插值器做平滑处理。

仪表盘 UI 实现要点

UI 部分我用的是 Canvas + SurfaceView。为什么不用普通的 View？因为仪表盘需要 60fps 的稳定帧率，SurfaceView 有独立的绘制线程，不会受主线程影响。

核心绘制逻辑：

public class ClusterSurfaceView extends SurfaceView implements SurfaceHolder.Callback {
    private float mSpeed = 0;
    private float mTargetSpeed = 0;
    private Paint mPaint;

    public ClusterSurfaceView(Context context) {
        super(context);
        getHolder().addCallback(this);
        mPaint = new Paint(Paint.ANTI_ALIAS_FLAG);
    }

    // 在独立线程中循环绘制
    private void drawLoop() {
        while (isRunning) {
            Canvas canvas = getHolder().lockCanvas();
            if (canvas != null) {
                // 平滑过渡到目标值
                mSpeed += (mTargetSpeed - mSpeed) * 0.1f;
                drawSpeedometer(canvas, mSpeed);
                getHolder().unlockCanvasAndPost(canvas);
            }
            // 控制帧率
            SystemClock.sleep(16); // ~60fps
        }
    }

    // 外部调用，设置目标速度
    public void setTargetSpeed(float speed) {
        mTargetSpeed = speed;
    }
}

这里有个小技巧——用插值平滑过渡。mSpeed 每次只向目标值靠近 10%，这样指针转动就很自然。我在项目里试过直接赋值，结果指针像抽风一样跳来跳去，用户看着肯定不舒服。

信号异常处理

车辆信号不是永远可靠的。我遇到过 CAN 总线故障、信号延迟、甚至信号值完全离谱的情况。所以必须做异常处理：

异常类型	表现	处理方式
信号丢失	onErrorEvent 被触发	显示上次有效值，并显示警告图标
信号超时	超过 1 秒未收到更新	启动超时计时器，超时后显示「--」
信号异常值	车速突然跳到 999 km/h	做范围校验，超出合理范围则丢弃

// 范围校验示例
private float validateSpeed(float speed) {
    if (speed < 0 || speed > 300) {
        Log.w("ClusterDemo", "车速异常: " + speed);
        return mLastValidSpeed; // 返回上次有效值
    }
    mLastValidSpeed = speed;
    return speed;
}

核心原则：仪表盘永远不能显示错误信息。如果信号不可靠，宁可显示「--」或上次有效值，也不能显示一个错误的速度。这是安全相关的硬性要求。

性能优化建议

最后聊几个性能优化的点。仪表盘应用对性能极其敏感，我踩过不少坑：

减少对象创建：绘制循环里别 new 对象，所有 Paint、Path 都提前创建好
使用硬件加速：SurfaceView 默认支持硬件加速，但要注意不要频繁调用 setLayerType()
避免过度绘制：只绘制可见区域，用 clipRect 裁剪掉不需要的部分
异步加载资源：仪表盘的背景图、指针图片等资源，在初始化时异步加载

我记得有一次，仪表盘在冷启动时卡了 2 秒才显示。查了半天，发现是背景图太大，在主线程里解码。改成异步加载后，启动时间降到了 300ms 以内。

好了，这个项目的基本框架就是这样。从 CarClusterService 获取信号，到 UI 渲染，再到异常处理，每一步都有讲究。你动手做的时候，建议先从最简单的车速显示开始，逐步加入转速、油量等功能。别想着一步到位，那样容易出问题。

📚 课程目录

实战项目二：实现一个车载仪表盘应用（涉及 Cluster 服务与车辆信号）

项目背景与目标

系统架构概览

CarClusterService 的核心接口

注册信号监听器

仪表盘 UI 实现要点

信号异常处理

性能优化建议