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 mostrar una actividad de pantalla completa cuando el sistema operativo y los ajustes del usuario lo permiten.

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() solicite permiso de notificación en Android 13 y versiones posteriores.
• 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

• channelId: identificador para el canal de notificación
• channelName: nombre del canal visible para el usuario
• showFullScreen: solicita la actividad de pantalla completa
• isHighPriority: mantenga la notificación lo suficientemente disruptiva para flujos de llamadas
• accentColor: tinte compatibles de superficies de notificación
• ringtoneUri: apunte a un recurso de tono de llamada personalizado de Android o URI

Notas de comportamiento

• La presentación en 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 tiempos de espera es de mejor esfuerzo. El plugin sigue timeoutMs y emite callTimedOut, pero su servidor debe reconciliar las llamadas perdidas en su lado.
• Las acciones de aceptar, rechazar y finalizar se emiten de nuevo a través de los Capacitor listeners para que su aplicación pueda unirse o limpiar la sesión de llamada real.

Modelo de producción recomendado

Utilice el empuje de Android o su llamada SDK para el transporte, luego deje que este plugin maneje la última milla de la interfaz de usuario de sonido nativo. Mantenga estas responsabilidades fuera del plugin:

• Registro y gestión de tokens de FCM
• Ciclo de vida de la sesión de medios
• Estado de llamada de backend
• Razonamiento de negocio de llamada perdida y reintentos

Sigue adelante desde Android

Si estás utilizando Android para planificar el comportamiento de medios y interfaz nativa, conecta con Usando @capgo/capacitor-kit-de-llamada-incompleta para la capacidad nativa en Usando @capgo/capacitor-kit-de-llamada-incompleta, Usando @capgo/capacitor-actividades-en-vivo para la capacidad nativa en Usando @capgo/capacitor-actividades-en-vivo, @capgo/capacitor-actividades-en-vivo 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.