Langsung ke konten utama
@capgo/capacitor-auto API Perangkat Open source

Otomatis plugin Capacitor

Jembatani aplikasi Capacitor dengan template CarPlay dan Android Auto untuk komunikasi dua arah dengan mobil

Instal

bun add @capgo/capacitor-auto bunx cap sync
npm, pnpm atau yarn
  • npm install @capgo/capacitor-auto
  • pnpm add @capgo/capacitor-auto
  • yarn add @capgo/capacitor-auto

Panduan

Cara menggunakan Auto di Capacitor

Menggunakan @capgo/capacitor-auto

@capgo/capacitor-auto menghubungkan aplikasi Capacitor ke template CarPlay dan Android Auto yang disetujui. Aplikasi Anda mengirim template daftar kecil ke layar mobil, dan layar mobil mengirim aksi yang dipilih kembali ke JavaScript.

Dibuat untuk workflow yang aman bagi pengemudi dan dikendalikan kebijakan. Ini tidak memirror WebView Anda ke mobil.

Instal dan sinkronkan

npm install @capgo/capacitor-auto
npx cap sync

Kirim template ke mobil

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' },
        },
      ],
    },
  ],
});

Dengarkan aksi pengemudi

await Auto.addListener('carAction', async (event) => {
  if (event.id === 'open-main-door') {
    await openGarageDoor(event.payload?.doorId);
  }
});

Pantau status koneksi

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);
});

Persyaratan iOS

CarPlay memerlukan entitlement yang disetujui Apple untuk kategori aplikasi Anda. Tambahkan konfigurasi CarPlay scene yang dijelaskan di dokumentasi setup iOS dan pastikan UI mobil Anda tetap menggunakan template yang disetujui Apple.

Persyaratan Android

Android Auto menggunakan AndroidX Car App Library. Plugin ini menyertakan CarAppService, mendeklarasikan template capability, dan secara default menggunakan IOT kategori. Tinjau Dokumen setup Android jika aplikasi Anda membutuhkan kategori Android Auto lain.

Panduan desain

Gunakan permukaan mobil untuk aksi singkat dan terprediksi:

  • baris status
  • perintah satu ketuk
  • konfirmasi yang aman untuk pengemudi
  • penyerahan state sederhana dari aplikasi ponsel

Jaga alur kompleks di UI ponsel dan gunakan carAction event sebagai pemicu intent native.

Lanjutkan dari Menggunakan @capgo/capacitor-auto

Jika Anda menggunakan Menggunakan @capgo/capacitor-auto untuk merencanakan perilaku media dan antarmuka native, hubungkan dengan @capgo/capacitor-auto untuk detail implementasi di @capgo/capacitor-auto, Panduan Memulai untuk detail implementasi di Getting Started, Menggunakan @capgo/capacitor-live-activities untuk kemampuan native di Menggunakan @capgo/capacitor-live-activities, @capgo/capacitor-live-activities untuk detail implementasi di @capgo/capacitor-live-activities, dan Menggunakan @capgo/capacitor-video-player untuk kapabilitas native saat menggunakan @capgo/capacitor-video-player.

FAQ

FAQ plugin Auto

Bagaimana cara install plugin Auto di aplikasi Capacitor?

Jalankan "bun add @capgo/capacitor-auto" (atau "npm install @capgo/capacitor-auto"), lalu jalankan "bunx cap sync" agar proyek iOS dan Android mendeteksi code native. Import dari "@capgo/capacitor-auto" di code aplikasi Anda.

Apakah @capgo/capacitor-auto bisa dipakai dengan React, Vue, dan Angular?

Ya. Auto adalah package Capacitor, jadi bisa dipakai dengan framework web apa pun yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte, dan JavaScript biasa.

Versi Capacitor mana yang didukung @capgo/capacitor-auto?

Plugin Capgo mengikuti versi mayor Capacitor: gunakan versi mayor plugin yang sesuai dengan versi mayor Capacitor Anda (contoh: plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub mencantumkan versi yang masih di-maintain.

Apakah @capgo/capacitor-auto gratis dan open source?

Ya. Source code bersifat publik di GitHub di https://github.com/Cap-go/capacitor-auto/ dan package ini gratis diinstall dari npm. Laporan bug dan pull request sangat diterima.

Bisakah saya update code yang menggunakan Auto tanpa review App Store?

Instalasi atau upgrade plugin akan mengubah native code, jadi butuh build store baru. Setelah itu, perubahan JavaScript, HTML, dan CSS yang memanggil plugin bisa langsung dikirim lewat live updates Capgo.

Rilis perubahan Auto tanpa menunggu review aplikasi

Setelah plugin ada di build store Anda, live updates Capgo akan mengirim perubahan JavaScript, HTML, dan CSS ke pengguna dalam hitungan menit.

Mulai dengan Capgo