Inizia
Copia una richiesta di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-incoming-call-kit`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/incoming-call-kit/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
-
Installa il pacchetto
Finestra del terminale bun add @capgo/capacitor-incoming-call-kit -
Sincronizza progetti nativi
Finestra del terminale bunx cap sync -
Scegli la fonte del tuo anello Decidi se l'evento di chiamata in arrivo proviene dal tuo backend, un SDK come Twilio o Stream, o da un percorso di push nativo come FCM o PushKit.
Come si abbinano le integrazioni
Sezione intitolata “Come si abbinano le integrazioni”Questo plugin gestisce solo la presentazione delle chiamate in arrivo native. La tua app mantiene il controllo del trasporto, dell'autenticazione e della sessione media effettiva.
Il modello di produzione comune è:
- Il tuo backend o il chiamante SDK emette un evento di chiamata.
- La tua app chiama
showIncomingCall(). - Il plugin presenta un'interfaccia di chiamata in arrivo nativa.
callAcceptedinsegna alla tua app di unirsi alla stanza reale o alla sessione VoIP.callDeclined,callEndedocallTimedOutinsegna alla tua app di pulire lo stato remoto.
Integrazione minima
Sezione intitolata “Integrazione minima”import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';
await IncomingCallKit.requestPermissions();await IncomingCallKit.requestFullScreenIntentPermission();
await IncomingCallKit.addListener('callAccepted', async ({ call }) => { console.log('Accepted', call.callId, call.extra); // Start or join your real call session here.});
await IncomingCallKit.addListener('callDeclined', ({ call }) => { console.log('Declined', call.callId); // Tell your backend or SDK that the user declined.});
await IncomingCallKit.addListener('callTimedOut', ({ call }) => { console.log('Timed out', call.callId); // Clear ringing state in your backend or SDK.});
await IncomingCallKit.showIncomingCall({ callId: 'call-42', callerName: 'Ada Lovelace', handle: '+39 555 010 020', appName: 'Capgo Phone', hasVideo: true, timeoutMs: 45_000, extra: { roomId: 'room-42', callerUserId: 'user_ada', }, android: { channelId: 'calls', channelName: 'Incoming Calls', showFullScreen: true, }, ios: { handleType: 'phoneNumber', },});Opzioni importanti
Sezione intitolata “Opzioni importanti”callId: identificatore stabile riutilizzato in seguito conendCall()timeoutMs: timeout di massima buona fede non rispostoextra: JSON casuale riflesso indietro nei payload degli ascoltatoriandroid.channelIdeandroid.channelName: regolazione del canale di notifica Androidandroid.showFullScreen: richiede l'attività di chiamata in arrivo a schermo intero Androidios.handleTypesceglieregeneric,phoneNumber, oemailAddressper CallKit
Gestione delle chiamate attive
Sezione intitolata “Gestione delle chiamate attive”const { calls } = await IncomingCallKit.getActiveCalls();
await IncomingCallKit.endCall({ callId: 'call-42', reason: 'remote-ended',});
await IncomingCallKit.endAllCalls({ reason: 'session-reset',});Modello di evento
Sezione intitolata “Modello di evento”incomingCallDisplayed: l'interfaccia nativa è stata visualizzata con successocallAccepted: l'utente ha accettato dall'interfaccia nativacallDeclined: l'utente ha rifiutato prima di unirsicallEnded: la tua app o la piattaforma ha interrotto la chiamata tracciatacallTimedOut: la chiamata è rimasta senza risposta fino atimeoutMs
Ogni evento trasporta il payload normalizzato call e il tuo oggetto originale. extra Nota della piattaforma
Sezione intitolata “Nota della piattaforma”
Leggi il- Leggi il {__CAPGO_KEEP_0__} Guida iOS __CAPGO_KEEP_0__
- Leggi il Guida Android __CAPGO_KEEP_0__
- Non è supportato