Android

How Android behavior works

En Android, el plugin publica una notificación de llamada entrante de alta prioridad y puede levantar una actividad de pantalla completa cuando el sistema operativo y los ajustes del usuario lo permitan.

El manifiesto 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 es suficiente con fusionar esa configuración en tu aplicación de host.

Permisos en tiempo de ejecución

Llame a estos métodos durante la onboarding 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() Solicite permiso de notificación en Android 13 y posterior.
• requestFullScreenIntentPermission() abre la página de ajustes de Android 14 y posterior 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

• channelIdidentificador para el canal de notificación
• channelNamenombre del canal de notificación visible para el usuario
• showFullScreensolicita la actividad de pantalla completa
• isHighPrioritymantener la notificación lo suficientemente disruptiva para flujos de llamada
• accentColortinte compatible con superficies de notificación
• ringtoneUripunte a un tono de llamada de Android personalizado o URI

Observaciones de comportamiento

• La presentación en pantalla completa es de mejor esfuerzo. Si el dispositivo o los ajustes del usuario lo bloquean, Android muestra aún así la notificación de llamada entrante.
• El manejo de tiempos de espera es de mejor esfuerzo. El plugin sigue y emite timeoutMs pero su servidor backend debe reconciliar las llamadas perdidas en su lado. callTimedOutLas acciones de aceptar, rechazar y finalizar se emiten de nuevo a través de los escuchadores __CAPGO_KEEP_0__ para que su aplicación pueda unirse o limpiar la sesión de llamada real.
• Accept, decline, and end actions are emitted back through Capacitor listeners so your app can join or clean up the real call session.

Sección titulada “Modelo de producción recomendado”

Use Android push or your calling SDK for transport, then let this plugin handle the last mile of native ringing UI. Keep these responsibilities outside the plugin:

• El ciclo de vida de la sesión de medios
• Sección titulada “Modelo de producción recomendado”
• Estado de llamada de backend
• Retroalimentación y lógica de llamada perdida

Sigue adelante desde Android

Si estás utilizando Android para planificar la media y el comportamiento de interfaz nativa, conecta con Usando @capgo/capacitor-incoming-call-kit para la capacidad nativa en Usando @capgo/capacitor-incoming-call-kit, Usando @capgo/capacitor-live-activities para la capacidad nativa en Usando @capgo/capacitor-live-activities, @capgo/capacitor-live-activities para el detalle de implementación en @capgo/capacitor-actividades-en-vivo, Usando @capgo/capacitor-reproductor-de-videos para la capacidad nativa en Usando @capgo/capacitor-reproductor-de-videos, y @capgo/capacitor-reproductor-de-videos para el detalle de implementación en @capgo/capacitor-reproductor-de-videos.