第6章 Android Auto导航应用开发

课程目录第6章 Android Auto导航应用开发

第6章：Android Auto导航应用开发——模板、搜索与实时路况

各位好，欢迎来到第六章。今天咱们聊聊Android Auto导航开发。说实话，车载导航这块儿，我踩过的坑比走过的路还多。记得第一次把导航模板跑在模拟器上，地图死活不显示，折腾了两天才发现是模板生命周期没处理好。嗯，咱们今天就把这些经验掰开揉碎了讲。

6.1 导航模板的核心机制

Android Auto的导航模板，说白了就是一套预定义的UI框架。你不能像写手机App那样随心所欲地画界面，得按Google定的规矩来。为什么？安全第一。开车时操作屏幕，越简单越不容易出事。

我个人习惯把导航模板分成三类：

导航模板（NavigationTemplate）：主界面，显示地图和导航指令
行程模板（TripTemplate）：行程概览，比如剩余时间、距离
消息模板（MessageTemplate）：提示信息，比如“前方有事故”

来看个实际例子。下面是我在项目中常用的导航模板初始化代码：

// 创建导航模板
NavigationTemplate.Builder builder = new NavigationTemplate.Builder();

// 设置导航状态监听
builder.setNavigationListener(new NavigationTemplate.NavigationListener() {
    @Override
    public void onNavigationStateChanged(NavigationState state) {
        // 这里处理导航状态变化
        // 比如：开始导航、结束导航、重新规划路线
        if (state == NavigationState.ACTIVE) {
            updateEtaDisplay();
        }
    }
});

// 构建模板
NavigationTemplate template = builder.build();

关键点：NavigationTemplate必须绑定一个CarContext，否则模板无法显示。我曾经犯过这个错，调试了半天才发现context传错了。

6.2 地点搜索集成——别让用户打字

车载场景下，打字搜索简直是灾难。你想想看，司机一边开车一边在屏幕上戳键盘，多危险。所以Android Auto推荐用语音搜索，或者用预定义的搜索建议。

我建议这样设计搜索流程：

用户点击搜索按钮，触发语音输入
系统返回语音识别结果
App调用地点搜索API，返回候选列表
用户选择地点，开始导航

代码实现大概是这样的：

// 搜索地点
public void searchPlaces(String query) {
    // 使用Google Places API
    PlacesClient placesClient = Places.createClient(this);
    
    FindAutocompletePredictionsRequest request = 
        FindAutocompletePredictionsRequest.builder()
            .setQuery(query)
            .build();
    
    placesClient.findAutocompletePredictions(request)
        .addOnSuccessListener(response -> {
            for (AutocompletePrediction prediction : 
                 response.getAutocompletePredictions()) {
                // 显示在模板的搜索列表中
                addSearchResult(prediction);
            }
        });
}

避坑指南：我曾经把搜索结果的图片加载放在主线程，结果界面卡得不行。记住，所有网络请求和图片加载都要异步处理。用Glide或者Coil都行，别自己写线程。

6.3 实时路况更新——别让用户走冤枉路

实时路况是导航的灵魂。没有路况的导航，就像没有导航的汽车——能走，但走不远。Android Auto支持通过NavigationTemplate的setTrafficLayer()方法显示路况。

我一般这样处理路况更新：

每30秒拉取一次路况数据
如果路况变化超过阈值，自动重新规划路线
在模板上显示路况提示，比如“前方拥堵，预计延迟10分钟”

来看具体实现：

// 更新路况
public void updateTrafficInfo() {
    // 获取当前路线
    Route currentRoute = navigationManager.getCurrentRoute();
    
    // 检查路况
    TrafficInfo traffic = trafficService.getTrafficInfo(currentRoute);
    
    if (traffic.hasCongestion()) {
        // 显示拥堵提示
        MessageTemplate message = new MessageTemplate.Builder(
            "前方拥堵，正在重新规划路线..."
        ).build();
        
        // 重新规划路线
        navigationManager.reroute();
    }
    
    // 更新ETA显示
    updateEtaDisplay(traffic.getDelayMinutes());
}

注意：不要频繁请求路况数据。我曾经设置成每5秒刷新一次，结果用户的车机直接卡死。30秒到1分钟是比较合理的间隔。另外，如果用户正在高速行驶，可以适当延长刷新间隔，减少网络开销。

6.4 知识体系总览

下面这张图是我自己整理的导航开发核心逻辑，你可以对照着看：

6.5 实战中的几个坑

最后分享几个我实际项目中遇到的坑，希望能帮你少走弯路：

问题	原因	解决方案
模板显示空白	CarContext未正确初始化	检查CarAppService的onCreate方法
搜索无结果	API Key未配置或配额超限	检查Google Cloud Console
路况更新卡顿	主线程执行网络请求	使用协程或RxJava异步处理
导航指令延迟	模板刷新频率太低	设置合理的刷新间隔（建议200ms）

个人经验：调试车载应用时，最好用真机。模拟器虽然方便，但很多传感器和GPS行为跟真机不一样。我有个项目在模拟器上跑得好好的，一上车就崩，最后发现是GPS权限没处理好。

好了，这一章的内容就到这里。导航开发其实不难，关键是理解模板的约束和生命周期。多写几遍，自然就熟了。有什么问题欢迎交流。

📚 课程目录