@capgo/capacitor-auto

@capgo/capacitor-auto 为需要在 iOS 和 Android 上使用经审核的模板化车机界面的 App 提供轻量桥接。

它不会把 WebView 镜像到车机屏幕。手机端 App 发送受限的车载模板，车机端通过 CarPlay 或 Android Auto UI 渲染，行选择会作为事件回传给 Capacitor App。

手机到车机

推送包含分区、行、副标题和应用自定义 payload 的根模板。

车机到手机

监听 carAction 驾驶员在车机屏幕上选择操作时触发的事件。

连接状态

在 CarPlay 或 Android Auto 主机连接或断开时做出响应。

原生入口

提供 CarPlay scene delegate 和 Android Auto CarAppService 以便车机宿主启动该集成。

平台支持

平台	支持	备注
iOS	是	原生
Android	是	原生
Web 端	部分支持	查看入门指南

核心 API

• isAvailable() 返回平台支持情况及当前连接状态。
• setRootTemplate(options) 使用简单的列表模板更新车辆显示。
• sendMessage(options) 通过原生 bridge 发送应用自定义消息。
• connectionChanged 报告车辆主机连接或断开时的状态。
• carAction 当选中车辆行时触发。
• messageReceived 承载应用自定义的 bridge 消息。

平台模型

iOS 使用 CarPlay CPTemplateApplicationSceneDelegate 并渲染 CPListTemplate.

Android 使用 AndroidX Car App Library，注册 CarAppService，并渲染模板化的 Android Auto 界面。

两个平台都要求应用遵循 Apple 和 Google 的车载应用政策。您仍需根据具体用例配置正确的应用分类、entitlement、审核批准以及平台设置。

唯一可信来源

此参考文档同步自 src/definitions.ts 中的 capacitor-auto.

从 @capgo/capacitor-auto 继续

如果你正在使用 @capgo/capacitor-auto 要规划原生插件工作，请将其与 使用 @capgo/capacitor-auto 用于“使用 @capgo/capacitor-auto”中的原生能力， Capgo 插件目录 查看 Capgo 插件目录中的产品工作流， Capgo 提供的 Capacitor 插件 查看由 Capgo 提供的 Capacitor 插件中的实现细节， 添加或更新插件 关于“添加或更新插件”中的实现细节，以及 Ionic Enterprise 插件替代方案 关于“Ionic Enterprise 插件替代方案”中的产品工作流。