Android

Comment fonctionne le comportement Android

Sur Android, le plugin envoie une notification d'appel entrant de priorité élevée et peut afficher une activité à pleine écran lorsque les paramètres de la plateforme et de l'utilisateur le permettent.

Le manifeste du plugin comprend déjà :

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

Après l'installation, cap sync C'est suffisant pour fusionner cette configuration dans votre application hôte.

Permissions de runtime

Appelez ces méthodes lors de l'inscription ou avant de vous appuyer sur la présentation de l'appel entrant :

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

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

• requestPermissions() demande la permission de notification sur Android 13 et ultérieur.
• requestFullScreenIntentPermission() ouvre la page de paramètres d'Android 14 et ultérieur pour les intents plein écran lorsqu'il le faut.

Exemple de base

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',
  },
});

Options spécifiques à Android

• channelId__CAPGO_KEEP_0__
• channelName__CAPGO_KEEP_1__
• showFullScreen__CAPGO_KEEP_2__
• isHighPriority__CAPGO_KEEP_3__
• accentColor__CAPGO_KEEP_4__
• ringtoneUri__CAPGO_KEEP_5__

Notes sur le comportement

• Gestion des temps limites : c'est une tentative. Le plugin suit et émet
• et timeoutMs émet callTimedOut, mais votre serveur doit toujours réconcilier les appels manqués de son côté.
• Les actions Accepter, refuser et terminer sont émises à nouveau à travers les écouteurs Capacitor afin que votre application puisse rejoindre ou nettoyer la session d'appel réelle.

Modèle de production recommandé

Utilisez la poussée Android ou votre appel SDK pour le transport, puis laissez ce plugin gérer la dernière mile de l'interface utilisateur de sonnerie native. Gardez ces responsabilités à l'extérieur du plugin :

• Inscription et gestion de jeton FCM
• Cycle de vie de la session multimédia
• État de l'appel du serveur
• Logique commerciale de la reprise et des appels manqués