Panduan
Cara menggunakan App Intents di Capacitor
Menggunakan @capgo/capacitor-app-intents
Antarmuka plugin Capgo App Intents.
Instal
bun add @capgo/capacitor-app-intents
bunx cap sync
bunx cap sync menyalin code native plugin ke dalam proyek native Anda. Jalankan kembali setiap kali melakukan upgrade plugin.
Impor
import { CapgoAppIntents } from '@capgo/capacitor-app-intents';
Sekilas tentang API
| Metode | Deskripsi |
|---|---|
getPendingInvocations |
Mengembalikan pemanggilan yang diantrekan sebelum JavaScript siap. |
removePendingInvocation |
Hapus satu pemanggilan yang tertunda setelah handler memprosesnya. |
setEntityCatalog |
Simpan katalog entitas untuk string tipe tertentu. |
setHomeScreenShortcutItems |
Ganti quick actions Home Screen (UIApplicationShortcutItems). |
indexSpotlightEntities |
Buat indeks item Spotlight untuk domain aplikasi Anda. |
removeSpotlightEntities |
Hapus item Spotlight berdasarkan ID. |
performAppleSchemaTemplate |
Antrekan handler JavaScript untuk template skema Apple alpha. |
Contoh
getPendingInvocations()
Mengembalikan pemanggilan yang diantrekan sebelum JavaScript siap.
import { CapgoAppIntents } from '@capgo/capacitor-app-intents';
const result = await CapgoAppIntents.getPendingInvocations();
console.log(result);
removePendingInvocation()
Hapus satu pemanggilan yang tertunda setelah handler memprosesnya.
import { CapgoAppIntents } from '@capgo/capacitor-app-intents';
await CapgoAppIntents.removePendingInvocation({ id: 'id-123' });
setEntityCatalog()
Simpan katalog entitas untuk string tipe tertentu.
import { CapgoAppIntents } from '@capgo/capacitor-app-intents';
await CapgoAppIntents.setEntityCatalog({
type: 'type',
entries: [
{
id: 'id-123',
title: 'Hello from Capacitor',
},
],
});
setHomeScreenShortcutItems()
Ganti quick actions Home Screen (UIApplicationShortcutItems).
import { CapgoAppIntents } from '@capgo/capacitor-app-intents';
await CapgoAppIntents.setHomeScreenShortcutItems({
items: [
{
type: 'type',
title: 'Hello from Capacitor',
},
],
});
indexSpotlightEntities()
Buat indeks item Spotlight untuk domain aplikasi Anda.
import { CapgoAppIntents } from '@capgo/capacitor-app-intents';
await CapgoAppIntents.indexSpotlightEntities({
entities: [
{
id: 'id-123',
title: 'Hello from Capacitor',
actionName: 'action',
},
],
});
removeSpotlightEntities()
Hapus item Spotlight berdasarkan ID.
import { CapgoAppIntents } from '@capgo/capacitor-app-intents';
await CapgoAppIntents.removeSpotlightEntities({ ids: ['ids'] });
Tabel di atas mencantumkan 7 metode inti. Listener, helper versi, dan kontrak lengkap setiap metode didokumentasikan di repositori GitHub.
Mendengarkan event
addListener mengembalikan sebuah handle. Panggil handle.remove() saat layar di-unmount, atau CapgoAppIntents.removeAllListeners() untuk menghapus semua listener.