指南
如何在 Capacitor 中使用 Auto
使用@capgo/capacitor-auto
@capgo/capacitor-auto 连接Capacitor应用到已批准的CarPlay和Android Auto模板表面。您的应用发送一小份模板列表到汽车显示屏，汽车显示屏发送选定的操作回JavaScript。
它是为安全的驾驶员、政策控制的工作流程而设计的。它不会将您的WebView映射到汽车。
安装和同步
npm install @capgo/capacitor-auto
npx cap sync
发送模板到汽车
import { Auto } from '@capgo/capacitor-auto';
await Auto.setRootTemplate({
title: 'Garage',
sections: [
{
header: 'Doors',
items: [
{
id: 'open-main-door',
title: 'Open main door',
subtitle: 'Tap to send the action to the phone app',
payload: { doorId: 'main' },
},
],
},
],
});
监听驾驶员操作
await Auto.addListener('carAction', async (event) => {
if (event.id === 'open-main-door') {
await openGarageDoor(event.payload?.doorId);
}
});
监视连接状态
const status = await Auto.isAvailable();
console.log(status.available, status.connected, status.platform);
await Auto.addListener('connectionChanged', (event) => {
console.log('Car connected:', event.connected, event.platform);
});
iOS要求
CarPlay需要您的应用类别获得苹果批准的特权。添加CarPlay场景配置，如在 iOS设置文档 中描述的，并将您的汽车UI保持在苹果批准的模板内。
Android要求
Android Auto 使用 AndroidX Car App Library。该插件包含一个 CarAppService，声明了一个 template 能力，且默认为 IOT 类别。查看 Android 设置文档 如果您的应用需要另一个 Android Auto 类别。 设计指南
在汽车面板上使用短、可预测的动作：
状态行
- 一键命令
- 驾驶员安全确认
- 从手机应用简单地传递状态
- Android Auto 使用 AndroidX Car App Library。该插件包含一个
保持复杂流程在手机UI中并使用 carAction 事件作为本机意图触发器。
继续使用@capgo/capacitor-auto
如果您正在使用 使用@capgo/capacitor-auto 规划本机媒体和界面行为时，连接它与 @capgo/capacitor-auto 在@capgo/capacitor-auto中实现详细信息 开始 在开始中实现详细信息 使用@capgo/capacitor-live-activities 在使用@capgo/capacitor-live-activities中实现本机能力 @capgo/capacitor实时活动 了解@capgo/capacitor实时活动的实现细节 使用@capgo/capacitor视频播放器 了解使用@capgo/capacitor视频播放器的原生能力