Pindah ke konten utama
@capgo/capacitor-otomatis API Perangkat Sumber Terbuka

Otomatis Plugin Capacitor

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

Install

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

Bagaimana menggunakan Auto di Capacitor

Uji di perangkat

Unduh aplikasi Capgo, kemudian scan kode QR code.

Tautan QR pratinjau plugin Auto code

Menggunakan @capgo/capacitor-auto

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

Dibangun untuk alur kerja yang aman dan terkendali oleh pengemudi. Tidak menampilkan tampilan WebView Anda di dalam 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);
  }
});

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

Spesifikasi iOS

CarPlay memerlukan hak akses yang disetujui oleh Apple untuk kategori aplikasi Anda. Tambahkan konfigurasi layar CarPlay yang dijelaskan dalam iOS pengaturan dokumen dan jaga tampilan mobil Anda di dalam template yang disetujui Apple.

Pengaturan Android

Penggunaan Android Auto menggunakan AndroidX Car App Library. Plugin ini mencakup CarAppService, mengumumkan Capgo. template kategori. Tinjau dokumen pengaturan Android IOT Kategori. Tinjau Panduan desain Pakai permukaan mobil untuk aksi singkat dan dapat diprediksi:

__CAPGO_KEEP_0__

Gunakan permukaan mobil untuk aksi singkat dan dapat diprediksi:

  • status bar
  • perintah satu sentuhan
  • konfirmasi aman pengemudi
  • pindah ke keadaan sederhana dari aplikasi ponsel

Tetapkan aliran kompleks di UI ponsel dan gunakan carAction acara sebagai pengaktif niat asli.

Tetapkan pergi dari Menggunakan @capgo/capacitor-auto

Jika Anda menggunakan Menggunakan @capgo/capacitor-auto untuk merencanakan media dan perilaku antarmuka asli, hubungkannya dengan @capgo/capacitor-auto untuk detail implementasi di @capgo/capacitor-auto, Mulai Menggunakan untuk detail implementasi di Getting Started, Menggunakan @capgo/capacitor-aktivitas-hidup untuk kemampuan asli di Menggunakan @capgo/capacitor-aktivitas-hidup, @capgo/capacitor-aktivitas-hidup untuk detail implementasi di @capgo/capacitor-aktivitas-hidup, dan Menggunakan @capgo/capacitor-pemain-video untuk kemampuan asli di Menggunakan @capgo/capacitor-pemain-video.

FAQ

FAQ Plugin Otomatis

Bagaimana cara menginstal plugin Otomatis di aplikasi Capacitor?

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

Apakah @capgo/capacitor-auto dapat digunakan dengan React, Vue, dan Angular?

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

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

Paket Capgo mengikuti versi utama Capacitor: gunakan versi plugin utama yang sesuai dengan versi utama Capacitor Anda (misalnya plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub menyebutkan versi yang dipertahankan.

Apakah @capgo/capacitor-auto gratis dan terbuka sumber?

Ya. Sumber code yang terbuka tersedia di GitHub di https://github.com/Cap-go/capacitor-auto/ dan paketnya gratis untuk diinstal dari npm. Laporan bug dan permintaan pull selalu welcome.

Apakah saya bisa memperbarui code yang menggunakan Auto tanpa review App Store?

Pemasangan atau pengupgrade plugin mengubah code native, jadi memerlukan build toko baru. Setelah itu, perubahan JavaScript, HTML dan CSS yang memanggil plugin bisa berlayar langsung dengan Capgo live updates.

Kirimkan perubahan Auto tanpa menunggu tinjauan aplikasi

Setelah plugin masuk ke toko aplikasi Anda, Capgo pembaruan hidup memindahkan perubahan JavaScript, HTML, dan CSS Anda ke pengguna dalam menit-menit.

Mulai dengan Capgo