メインコンテンツへスキップ

@capgo/capacitor-auto

CapacitorアプリをCarPlayとAndroid Autoのテンプレート画面とブリッジし、車との双方向通信を実現

@capgo/capacitor-auto iOSおよびAndroidにおいて、承認済みのテンプレートベースの車載インターフェースを必要とするアプリ向けに、軽量なブリッジを提供します。

WebViewを車載画面にミラーリングするものではありません。スマホアプリから制限された車載用テンプレートを送信し、CarPlayまたはAndroid AutoのUIでレンダリングされます。行の選択などは、イベントとしてCapacitorアプリに返されます。

スマホから車へ

セクション、行、サブタイトル、およびアプリ定義のペイロードを含むルートテンプレートをプッシュします。

車からスマホへ

を監視します: carAction ドライバーが車載ディスプレイ上でアクションを選択した際のイベントです。

接続状態

CarPlayまたはAndroid Autoのホストが接続または切断されたときに反応します。

ネイティブのエントリポイント

CarPlayのSceneDelegateとAndroid Auto用の実装が含まれており、 CarAppService 車載ホスト側からこの統合機能を起動できます。

プラットフォームサポート備考
iOSとはいネイティブ
Androidはいネイティブ
Web一部はじめにを見る
  • isAvailable() プラットフォームのサポート状況と現在の接続状態を返します。
  • setRootTemplate(options) シンプルなリストテンプレートを使用して、車のディスプレイを更新します。
  • sendMessage(options) ネイティブブリッジ経由で、アプリケーション定義のメッセージを送信します。
  • connectionChanged カーホストの接続時および切断時に通知されます。
  • carAction 車の行が選択されたときに発行されます。
  • messageReceived アプリケーション定義のブリッジメッセージを運びます。

iOSではCarPlayを使用し、 CPTemplateApplicationSceneDelegate また、 CPListTemplate.

AndroidではAndroidX Car App Libraryを使用し、 CarAppServiceテンプレート化されたAndroid Auto画面を描画します。

両プラットフォームにおいて、アプリはAppleおよびGoogleのカーアプリポリシーに従う必要があります。ユースケースに応じて、適切なアプリカテゴリ、entitlement、審査の承認、およびプラットフォームの設定が引き続き必要です。

信頼できる情報源

「Source of truth」セクション

このリファレンスは以下から同期されています: src/definitions.ts における capacitor-auto.

使用している場合 @capgo/capacitor-auto ネイティブプラグインの作業を計画するには、次と連携してください: @capgo/capacitor-auto の使用方法 @capgo/capacitor-auto を使用して Native Build の機能を利用する場合 Capgo プラグインディレクトリ Capgo プラグインディレクトリのプロダクトワークフローについては、 Capgo による Capacitor プラグイン Capgo による Capacitor プラグインの実装詳細については、 プラグインの追加または更新 プラグインの追加または更新における実装詳細については、および Ionic Enterprise プラグインの代替案 Ionic Enterprise プラグインの代替案におけるプロダクトワークフローについては。