Guía
Cómo usar Incoming Call Kit en Capacitor
Uso de @capgo/capacitor-incoming-call-kit
Capacitor API para mostrar una interfaz nativa de llamada entrante.
Instalar
bun add @capgo/capacitor-incoming-call-kit
bunx cap sync
bunx cap sync copia el code nativo del plugin en tus proyectos nativos. Ejecútalo de nuevo tras cada actualización del plugin.
Importar
import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';
API de un vistazo
| Método | Descripción |
|---|---|
showIncomingCall |
Muestra la interfaz nativa de llamada entrante. |
endCall |
Finaliza una llamada específica rastreada. |
endAllCalls |
Finaliza todas las llamadas rastreadas. |
getActiveCalls |
Devuelve las llamadas rastreadas actualmente. |
checkPermissions |
Devuelve el estado de permisos para notificaciones e intents de pantalla completa. |
requestPermissions |
Solicita el permiso de notificaciones si la plataforma lo permite. |
requestFullScreenIntentPermission |
Abre la configuración de intents de pantalla completa en Android 14+ si está disponible. |
Ejemplos
showIncomingCall()
Muestra la interfaz nativa de llamada entrante.
import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';
const result = await IncomingCallKit.showIncomingCall({
callId: 'call-id-123',
callerName: 'caller',
});
console.log(result);
endCall()
Finaliza una llamada específica rastreada.
import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';
const result = await IncomingCallKit.endCall({ callId: 'call-id-123' });
console.log(result);
endAllCalls()
Finaliza todas las llamadas rastreadas.
import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';
const result = await IncomingCallKit.endAllCalls();
console.log(result);
getActiveCalls()
Devuelve las llamadas rastreadas actualmente.
import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';
const result = await IncomingCallKit.getActiveCalls();
console.log(result);
checkPermissions()
Devuelve el estado de permisos para notificaciones e intents de pantalla completa.
import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';
const result = await IncomingCallKit.checkPermissions();
console.log(result);
requestPermissions()
Solicita el permiso de notificaciones si la plataforma lo permite.
import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';
const result = await IncomingCallKit.requestPermissions();
console.log(result);
La tabla anterior enumera los 7 métodos principales. Los helpers de versión y listeners, así como el contrato completo de cada método, están documentados en la repositorio GitHub.
Escuchar eventos
addListener devuelve un handle. Llama handle.remove() cuando la pantalla se desmonte, o IncomingCallKit.removeAllListeners() para limpiar todos los listeners.
Referencia completa
Continúa desde Usando @capgo/capacitor-incoming-call-kit
Si estás usando Uso de @capgo/capacitor-incoming-call-kit para planificar las operaciones del dashboard y de API, conéctalo con @capgo/capacitor-incoming-call-kit para el detalle de implementación en @capgo/capacitor-incoming-call-kit, Primeros pasos para los detalles de implementación en Primeros pasos, Resumen de API para los detalles de implementación en API Overview, Introducción para los detalles de implementación en Introducción, y Claves de API para los detalles de implementación en API Keys.