Saltar al contenido principal
@capgo/capacitor-incoming-call-kit Comunicación Código abierto

Llamada entrante de Call Kit plugin Capacitor

Muestra la UI nativa de llamada entrante con CallKit y notificaciones a pantalla completa en Android

Instalar

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

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.

FAQ

FAQ del plugin Incoming Call Kit

¿Cómo instalo el plugin Incoming Call Kit en una app Capacitor?

Ejecuta "bun add @capgo/capacitor-incoming-call-kit" (o "npm install @capgo/capacitor-incoming-call-kit") y luego "bunx cap sync" para que los proyectos de iOS y Android reconozcan el code nativo. Impórtalo desde "@capgo/capacitor-incoming-call-kit" en el code de tu app.

¿Es compatible @capgo/capacitor-incoming-call-kit con React, Vue y Angular?

Sí. Incoming Call Kit es un paquete Capacitor, por lo que funciona con cualquier framework web que se ejecute dentro de Capacitor, incluyendo Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Qué versión de Capacitor es compatible con @capgo/capacitor-incoming-call-kit?

Los plugins de Capgo siguen la versión mayor de Capacitor: usa la versión mayor del plugin que coincida con la versión mayor de tu Capacitor (por ejemplo, el plugin v8 con Capacitor 8). La tabla de compatibilidad del README de GitHub lista las versiones mantenidas.

¿Es @capgo/capacitor-incoming-call-kit gratis y de código abierto?

Sí. El código fuente de code es público en GitHub en https://github.com/Cap-go/capacitor-incoming-call-kit/ y el paquete se puede instalar gratis desde npm. Los reportes de errores y pull requests son bienvenidos.

¿Puedo actualizar code que usa Incoming Call Kit sin revisión de la App Store?

Instalar o actualizar el plugin cambia el code nativo, así que requiere un nuevo build para la tienda. Después, los cambios de JavaScript, HTML y CSS que llamen al plugin se pueden publicar al instante con las live updates de Capgo.

Lanza cambios de Incoming Call Kit sin esperar la revisión de la app

Una vez que el plugin esté en tu store build, Capgo live updates envía tus cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Empieza con Capgo