如何在AndroidAuto的Surface上绘制自定义地图等内容？

核心逻辑 #

NavigationTemplate提供的Surface需通过SurfaceCallback的生命周期方法接管绘制，你可以利用Canvas或OpenGL直接在Surface上渲染自定义地理参考图像，以下是具体实现步骤：

1. 完善Surface生命周期回调 #

除了onSurfaceAvailable，还需实现onSurfaceChanged和onSurfaceDestroyed来管理绘制资源的创建与释放：

class MapScreen(carContext: CarContext) : Screen(carContext), SurfaceCallback {
    private var surfaceHolder: SurfaceHolder? = null
    private var mapBitmap: Bitmap? = null
    private val mainHandler = Handler(Looper.getMainLooper())

    init {
        carContext.getCarService(AppManager::class.java).setSurfaceCallback(this)
    }

    // 保留原onGetTemplate方法...

    override fun onSurfaceChanged(surfaceContainer: SurfaceContainer, format: Int, width: Int, height: Int) {
        Log.d("HelloMapScreen", "Surface updated: ${width}x$height")
        // 尺寸变化时可重新调整地图缩放比例
    }

    override fun onSurfaceDestroyed(surfaceContainer: SurfaceContainer) {
        surfaceHolder = null
        mapBitmap?.recycle()
        mapBitmap = null
        mainHandler.removeCallbacksAndMessages(null)
        Log.d("HelloMapScreen", "Surface released")
    }
}

2. 加载并绘制自定义地图 #

在onSurfaceAvailable中加载地图资源，通过Canvas循环绘制到Surface上：

override fun onSurfaceAvailable(surfaceContainer: SurfaceContainer) {
    Log.d("HelloMapScreen", "Surface ready")
    surfaceHolder = surfaceContainer.holder
    // 从资源中加载自定义地理参考图像
    mapBitmap = BitmapFactory.decodeResource(carContext.resources, R.drawable.custom_map)
    // 启动绘制循环（约60fps）
    startDrawingLoop()
}

private fun startDrawingLoop() {
    surfaceHolder?.let { holder ->
        val canvas = holder.lockCanvas() ?: return
        try {
            // 清空画布背景
            canvas.drawColor(Color.BLACK)
            // 绘制地图（示例：铺满整个Surface）
            mapBitmap?.let { bitmap ->
                canvas.drawBitmap(bitmap, null, Rect(0, 0, canvas.width, canvas.height), null)
            }
        } finally {
            holder.unlockCanvasAndPost(canvas)
        }
        // 延迟触发下一次绘制
        mainHandler.postDelayed({ startDrawingLoop() }, 16)
    }
}

3. 添加交互控制（以平移为例） #

如果需要支持地图平移，可通过偏移量控制绘制位置，并结合Action按钮触发偏移更新：

private var offsetX = 0f
private var offsetY = 0f

// 修改绘制逻辑，加入偏移量
canvas.drawBitmap(bitmap, offsetX, offsetY, null)

// 在ActionStrip中添加平移控制按钮
ActionStrip.Builder()
    .addAction(Action.Builder()
        .setTitle("左移")
        .setOnClickListener { offsetX += 50f }
        .build())
    .addAction(Action.Builder()
        .setTitle("右移")
        .setOnClickListener { offsetX -= 50f }
        .build())
// ... 其他按钮 ...

关键注意事项 #

• 绘制操作必须在Surface可用状态下执行，避免空指针异常
• 大尺寸地图建议采用瓦片加载或分块渲染，防止内存溢出
• 务必在onSurfaceDestroyed中回收Bitmap并移除绘制循环，避免内存泄漏

内容的提问来源于stack exchange，提问作者kach4n