Getting Started

复制一个包含安装步骤和完整 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辅助设置来安装插件。使用以下命令将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.

如果您prefer手动设置，请按照以下命令安装插件并遵循以下平台特定的说明：

安装包
终端窗口
```
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 场景和特权说明页
Follow the 安卓设置安卓 Auto 类别和清单说明页

从 Getting Started 继续

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