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.