Petunjuk
Tutorial Otomatis
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.