Langsung ke konten utama

Incoming Call Kit plugin Capacitor

Tampilkan UI panggilan masuk native dengan iOS CallKit dan notifikasi full-screen Android

Instal

bun add @capgo/capacitor-incoming-call-kit bunx cap sync
npm, pnpm atau yarn
  • npm install @capgo/capacitor-incoming-call-kit
  • pnpm add @capgo/capacitor-incoming-call-kit
  • yarn add @capgo/capacitor-incoming-call-kit

Panduan

Cara menggunakan Incoming Call Kit di Capacitor

Menggunakan @capgo/capacitor-incoming-call-kit

Capacitor API untuk menampilkan antarmuka panggilan masuk native.

Instal

bun add @capgo/capacitor-incoming-call-kit
bunx cap sync

bunx cap sync menyalin code native plugin ke dalam proyek native Anda. Jalankan kembali setiap kali melakukan upgrade plugin.

Impor

import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';

Sekilas tentang API

Metode Deskripsi
showIncomingCall Menampilkan UI panggilan masuk native.
endCall Mengakhiri panggilan tertentu yang sedang dilacak.
endAllCalls Mengakhiri semua panggilan yang sedang dilacak.
getActiveCalls Mengembalikan daftar panggilan yang sedang dilacak.
checkPermissions Mengembalikan status izin saat ini untuk notifikasi dan full-screen intents.
requestPermissions Meminta izin notifikasi jika platform mendukungnya.
requestFullScreenIntentPermission Membuka halaman pengaturan full-screen intent Android 14+ jika tersedia.

Contoh

showIncomingCall()

Menampilkan UI panggilan masuk native.

import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';

const result = await IncomingCallKit.showIncomingCall({
  callId: 'call-id-123',
  callerName: 'caller',
});
console.log(result);

endCall()

Mengakhiri panggilan tertentu yang sedang dilacak.

import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';

const result = await IncomingCallKit.endCall({ callId: 'call-id-123' });
console.log(result);

endAllCalls()

Mengakhiri semua panggilan yang sedang dilacak.

import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';

const result = await IncomingCallKit.endAllCalls();
console.log(result);

getActiveCalls()

Mengembalikan daftar panggilan yang sedang dilacak.

import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';

const result = await IncomingCallKit.getActiveCalls();
console.log(result);

checkPermissions()

Mengembalikan status izin saat ini untuk notifikasi dan full-screen intents.

import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';

const result = await IncomingCallKit.checkPermissions();
console.log(result);

requestPermissions()

Meminta izin notifikasi jika platform mendukungnya.

import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';

const result = await IncomingCallKit.requestPermissions();
console.log(result);

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 IncomingCallKit.removeAllListeners() untuk menghapus semua listener.

Referensi lengkap

Lanjutkan dari Menggunakan @capgo/capacitor-incoming-call-kit

Jika Anda menggunakan Menggunakan @capgo/capacitor-incoming-call-kit untuk merencanakan operasi dashboard dan API, hubungkan dengan @capgo/capacitor-incoming-call-kit untuk detail implementasi di @capgo/capacitor-incoming-call-kit, Panduan Memulai untuk detail implementasi di Getting Started, Ringkasan API untuk detail implementasi di API Overview, Pendahuluan untuk detail implementasi di Introduction, dan Kunci API untuk detail implementasi di API Keys.

FAQ

FAQ plugin Incoming Call Kit

Bagaimana cara install plugin Incoming Call Kit di aplikasi Capacitor?

Jalankan "bun add @capgo/capacitor-incoming-call-kit" (atau "npm install @capgo/capacitor-incoming-call-kit"), lalu jalankan "bunx cap sync" agar proyek iOS dan Android mendeteksi code native. Import dari "@capgo/capacitor-incoming-call-kit" di dalam code aplikasi Anda.

Apakah @capgo/capacitor-incoming-call-kit kompatibel dengan React, Vue, dan Angular?

Ya. Incoming Call Kit adalah package Capacitor, jadi bisa digunakan dengan framework web apa pun yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte, dan JavaScript murni.

Versi Capacitor mana yang didukung oleh @capgo/capacitor-incoming-call-kit?

Plugin Capgo mengikuti versi mayor Capacitor: gunakan versi mayor plugin yang sesuai dengan versi mayor Capacitor Anda (contoh: plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub mencantumkan versi yang masih di-maintain.

Apakah @capgo/capacitor-incoming-call-kit gratis dan open source?

Ya. Source code tersedia secara publik di GitHub pada https://github.com/Cap-go/capacitor-incoming-call-kit/ dan paketnya bebas diinstal dari npm. Bug report dan pull request sangat kami terima.

Bisakah saya update code yang menggunakan Incoming Call Kit tanpa review App Store?

Instalasi atau upgrade plugin akan mengubah native code, jadi butuh build store baru. Setelah itu, perubahan JavaScript, HTML, dan CSS yang memanggil plugin bisa langsung dikirim lewat live updates Capgo.

Rilis perubahan Incoming Call Kit tanpa menunggu review aplikasi

Setelah plugin ada di build store Anda, live updates Capgo akan mengirim perubahan JavaScript, HTML, dan CSS ke pengguna dalam hitungan menit.

Mulai dengan Capgo