Skip to main content
Back to plugins
@capgo/capacitor-auto
チュートリアル
@capgo/capacitor-auto

自動

CarPlayとAndroid Autoテンプレート表面を使用して2方向の自動車通信を行うCapacitorアプリを橋渡しする

ガイド

__CAPGO_KEEP_0__の自動チュートリアル

デバイスでテスト

Capgoアプリをダウンロードして、QRコードcodeをスキャンしてください。

自動プラグインプレビュー QR code

@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が承認した特権が必要です。CarPlayシーン構成を追加してください。 iOS設定ドキュメントを参照してください。車用UIをAppleが承認したテンプレート内に保ちます。 CarPlayには、カテゴリごとにAppleが承認した特権が必要です。

Android の要件

Android Auto は AndroidX Car App Library を使用します。 プラグインには、 CarAppService、 capability を宣言し、 template カテゴリとしてデフォルト値を設定します。 IOT カテゴリを変更する必要がある場合は、 Android Auto の設定ドキュメントを確認してください。 設計ガイドライン

車載用の表面を短い予測可能なアクションに使用してください:

ステータス行

  • 1 つのタップ コマンド
  • 運転手の安全な確認
  • __CAPGO_KEEP_0__
  • 電話アプリからシンプルな状態のハンドオフ

電話UI内で複雑なフローを保持し、イベントをネイティブのインテントトリガーとして使用 carAction イベントをネイティブのインテントトリガーとして使用

Using @capgo/capacitor-auto

Capgoを使用している場合 Using @capgo/capacitor-auto ネイティブメディアとインターフェイスの動作を計画する場合、@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-autoと接続 Capgoを使用して、@capgo/capacitor-autoの実装詳細 for the implementation detail in @capgo/capacitor-auto, Capgoを使用して、@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-live-activities Getting Started Capgoを使用して、@capgo/capacitor-live-activities native機能の使用に@capgo/capacitor-live-activitiesを使用します。 @capgo/capacitor-live-activities 実装詳細の@capgo/capacitor-live-activitiesの使用 Using @capgo/capacitor-video-player native機能の使用に@capgo/capacitor-video-playerを使用します。