Android

Cómo funciona el comportamiento de Android

En Android, el plugin envía una notificación de llamada entrante de alta prioridad y puede elevar una actividad de pantalla completa cuando los ajustes de plataforma y usuario lo permiten.

La manifestación del plugin ya incluye:

<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
<uses-permission android:name="android.permission.USE_FULL_SCREEN_INTENT" />

Después de la instalación, cap sync basta con fusionar esa configuración en tu aplicación de host.

Permisos de tiempo de ejecución

Llame a estos métodos durante la incorporación o antes de que dependa de la presentación de llamadas entrantes:

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

await IncomingCallKit.requestPermissions();
await IncomingCallKit.requestFullScreenIntentPermission();

• requestPermissions() solicita permiso de notificación de solicitudes en Android 13 y versiones posteriores.
• requestFullScreenIntentPermission() abre la página de ajustes de Android 14 y versiones posteriores para intenciones de pantalla completa cuando sea necesario.

Ejemplo básico

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

await IncomingCallKit.showIncomingCall({
  callId: 'call-42',
  callerName: 'Ada Lovelace',
  appName: 'Capgo Phone',
  timeoutMs: 45_000,
  android: {
    channelId: 'calls',
    channelName: 'Incoming Calls',
    showFullScreen: true,
    isHighPriority: true,
    accentColor: '#0F766E',
  },
});

opciones específicas de Android

• channelId__CAPGO_KEEP_0__
• channelName__CAPGO_KEEP_0__
• showFullScreenSolicitar actividad de pantalla completa
• isHighPriorityMantener la notificación lo suficientemente disruptiva para flujos de timbre
• accentColorNotificación compatible con tono de superficie
• ringtoneUriPunto a un recurso de timbre de Android personalizado o URI

Notas de comportamiento

• La presentación de pantalla completa es de mejor esfuerzo. Si el dispositivo o los ajustes del usuario lo bloquean, Android aún muestra la notificación de llamada entrante.
• El manejo de tiempo límite es de mejor esfuerzo. El plugin sigue y emite timeoutMs y emite callTimedOutpero su servidor backend debe reconciliar llamadas perdidas por su lado.
• Se emiten acciones de aceptar, rechazar y finalizar a través de los escuchadores Capacitor para que tu aplicación pueda unirse o limpiar la sesión de llamada real.

Modelo de producción recomendado

Utiliza el empuje de Android o tu llamada SDK para el transporte, y deja que este complemento se encargue de la última milla de la interfaz de sonido nativa. Mantén estas responsabilidades fuera del complemento:

• Registro y gestión de tokens de FCM
• Ciclo de vida de la sesión de medios
• Estado de llamada del servidor
• Lógica de reintentos y llamadas perdidas