メインコンテンツにジャンプ
@capgo/capacitor-オート デバイスAPI オープンソース

Auto Capacitor プラグイン

Bridge Capacitor apps with CarPlay and Android Auto template surfaces for two-way car communication.

インストール

bun add @capgo/capacitor-auto bunx cap sync
pnpmまたはyarnのnpm
  • npm install @capgo/capacitor-auto
  • pnpm add @capgo/capacitor-auto
  • yarn add @capgo/capacitor-auto

ガイド

Auto を使用する方法については、Capacitor を参照してください

Using @capgo/capacitor-auto

@capgo/capacitor-auto Capacitorアプリを承認済みのCarPlayおよびAndroid Autoテンプレート表面に接続します。アプリは車用ディスプレイに小さなリストテンプレートを送信し、車用ディスプレイはJavaScriptに選択されたアクションを送信します。

ドライバー安全でポリシー制御されたワークフロー向けに設計されています。ウェブビューを車用ディスプレイに反映することはありません。

インストールと同期

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が承認したアプリケーションカテゴリのエンタイトルメントが必要です。Appleが承認したテンプレート内に車用UIを保持するために、CarPlayシーン構成を追加し、iOSセットアップドキュメントに記載されているものに従ってください。 Android要件 __CAPGO_KEEP_0__

__CAPGO_KEEP_1__

Android AutoはAndroidX Car App Libraryを使用します。このプラグインには CarAppService、Android Autoの template 機能を宣言し、デフォルトでは IOT カテゴリを使用します。アプリが別のAndroid Autoカテゴリが必要な場合、 の設定ドキュメントを確認してください。 デザインガイドライン

車載用の表面を短い予測可能なアクションに使用します:

ステータス行

  • 一タップコマンド
  • ドライバーの安全な確認
  • 携帯電話アプリから簡単に状態を引き継ぐ
  • スマートフォンアプリからシンプルな状態の引き継ぎ

複雑なフローは電話UIに残し、 carAction イベントをネイティブの意図トリガーとして使用します。

Keep going from @capgo/capacitor-auto

Capacitor Autoを使用している場合 Using @capgo/capacitor-auto ネイティブのメディアとインターフェイスの動作を計画するには、 @capgo/capacitor-auto @capgo/capacitor-オート Capacitor-Autoの導入 Getting Startedの実装詳細 @capgo/capacitor-ライブ活動 Capacitor-nativeの機能のために@capgo/capacitor-ライブアクティビティを使用します。 @capgo/capacitor-ライブアクティビティ @capgo/capacitor-live-activitiesの実装詳細について Capacitorで@capgo/capacitor-video-playerを使用 Capacitorで@capgo/capacitor-video-playerのネイティブ機能を使用

FAQ

Capacitor Auto no Q&A

Capacitor Auto プラグインを Capacitor アプリにインストールする方法は?

Run "bun add @capgo/capacitor-auto" (or "npm install @capgo/capacitor-auto"), then run "bunx cap sync" so the iOS and Android projects pick up the native code. Import it from "@capgo/capacitor-auto" in your app code.

Does @capgo/capacitor-auto work with React, Vue and Angular?

Yes. Auto is a Capacitor package, so it works with any web framework that runs inside Capacitor, including Ionic, React, Vue, Angular, Svelte and plain JavaScript.

Which Capacitor version does @capgo/capacitor-auto support?

Capgo plugins follow Capacitor's major version: use the plugin major version that matches your Capacitor major version (for example plugin v8 with Capacitor 8). The compatibility table in the GitHub README lists the maintained versions.

Is @capgo/capacitor-auto free and open source?

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-auto/ and the package is free to install from npm. Bug reports and pull requests are welcome.

Auto を使用する code を App Store のレビューなしでアップデートできますか?

プラグインをインストールまたはアップグレードすると、ネイティブ code が変更されるため、新しいストアビルドが必要になります。その後、プラグインを呼び出す JavaScript、HTML、CSS の変更は Capgo のライブアップデートで即時発行できます。

アプリレビューの待ちなしで、Ship Auto の変更を実行

プラグインがストアビルドに追加されたら、Capgo ライブアップデートは、ユーザーにJavaScript、HTML、CSSの変更を数分で反映します。

Capgo で始めましょう