Lompat ke konten utama
Kembali ke plugin
@capgo/capacitor-otomatis
Tutorial
@capgo/capacitor-otomatis

Otomatis

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

Petunjuk

Tutorial Otomatis

Tes di perangkat

Unduh aplikasi Capgo terlebih dahulu, kemudian scan kode QR code.

Pratinjau QR plugin otomatis code

Menggunakan @capgo/capacitor-otomatis

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

Itu dibangun untuk alur kerja yang aman dan terkendali oleh kebijakan pengemudi. Tidak ada refleksi WebView Anda ke dalam mobil.

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

Amati 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 dokumen setup iOS dan jaga UI mobil Anda di dalam template yang disetujui oleh Apple. __CAPGO_KEEP_0__

Persyaratan Android

Android Auto menggunakan AndroidX Car App Library. Plugin ini termasuk sebuah CarAppService, yang mengumumkan kemampuan template dan secara default menggunakan kategori. IOT Periksa dokumen pengaturan Android jika aplikasi Anda memerlukan kategori Android Auto lainnya. Pedoman Desain

Gunakan permukaan mobil untuk aksi-aksi singkat dan dapat diprediksi:

baris status

  • perintah satu sentuhan
  • konfirmasi aman pengemudi
  • __CAPGO_KEEP_0__
  • pengalihan keadaan sederhana dari aplikasi ponsel

Tetapkan aliran kompleks di antarmuka ponsel dan gunakan carAction acara sebagai pengaktif intent 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, Pengenalan untuk detail implementasi di Pengenalan, Menggunakan @capgo/capacitor-live-activities untuk kemampuan asli 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 kemampuan asli di Menggunakan @capgo/capacitor-video-player.