使用 @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 需要您的应用程序类别的 Apple 批准权。添加 CarPlay 场景配置，如 iOS 设置文档中所述，并将您的汽车 UI 保持在 Apple 批准的模板中。 iOS 配置文档 Android 要求

Android 需求

Android Auto 使用 AndroidX Car App Library。该插件包含一个 CarAppService，声明了 template 能力，并默认为 IOT 类别。查看 Android 设置文档如果您的应用需要另一个 Android Auto 类别。设计指南

在车载面板上使用短、可预测的动作：

状态行

一键命令
驾驶员安全确认
Android Auto 使用 AndroidX Car App Library。该插件包含一个
简化手机应用与本机应用之间的状态传递

保持复杂的流程在手机UI中，使用事件作为本机意图触发器 carAction 保持复杂的流程在手机UI中，使用事件作为本机意图触发器

继续使用@capgo/capacitor-auto

如果您正在使用 使用@capgo/capacitor-auto 为了规划本机媒体和界面行为，连接它与 @capgo/capacitor-auto @capgo/capacitor-auto 获取开始获取开始使用@capgo/capacitor-live-activities 为使用@capgo/capacitor-live-activities的原生功能 @capgo/capacitor-live-activities 为@capgo/capacitor-live-activities的实现细节使用@capgo/capacitor-video-player 为使用@capgo/capacitor-video-player的原生功能

自动

Capacitor 自动化教程