开始使用

复制一个设置提示，包含安装步骤和该插件的完整 Markdown 指南。

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-auto`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/auto/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

安装

您可以使用我们的 AI-Assisted Setup 来安装插件。将 Capgo 技能添加到您的 AI 工具中，使用以下命令：

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

然后使用以下提示:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-auto` plugin in my project.

如果您更喜欢手动设置，请运行以下命令安装插件，并按照以下平台特定的说明进行操作:

安装包
终端窗口
```
npm i @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);
});

空状态

设置 emptyText 当模板没有行时：

await Auto.setRootTemplate({
  title: 'Garage',
  emptyText: 'No actions are available right now.',
  sections: [],
});

发送桥接消息

使用 sendMessage 为应用定义的本机桥接消息:

await Auto.sendMessage({
  type: 'status',
  payload: { online: true },
});

平台设置

遵循 iOS设置页面，了解CarPlay场景和特权说明。
遵循 Android设置页面，了解Android Auto类别和清单说明。

继续从 Getting Started

如果您正在使用 Getting Started 来规划原生插件工作，连接它与使用 @capgo/capacitor-auto 原生能力在使用 @capgo/capacitor-auto 中 Capgo 插件目录产品工作流程在 Capgo 插件目录中 Capacitor 由 Capgo 的插件 Capacitor 插件的实现细节由 Capgo 添加或更新插件为添加或更新插件的实现细节, 和 Ionic 企业插件替代品为 Ionic 企业插件替代品中的产品工作流.