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 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 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
• ringtoneUriapunta a un recurso de tono de llamada Android personalizado o URI

Observaciones de comportamiento

• La presentación en pantalla 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 y, sin embargo, su servidor 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.

Título de la sección “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
• El manejo de tiempos de espera es de mejor esfuerzo. El plugin sigue __CAPGO_KEEP_0__ y emite __CAPGO_KEEP_1__ pero su servidor debe reconciliar las llamadas perdidas en su lado.
• Estado de llamada de backend
• Retroalimentación y lógica de llamada perdida

Sigue adelante desde Android

Si estás utilizando Android para planificar el comportamiento de medios y 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 los detalles 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 los detalles de implementación en @capgo/capacitor-reproductor-de-videos.