Android

How Android behavior works

Sur Android, le plugin envoie une notification d'appel entrant de priorité élevée et peut afficher une activité à pleine écran lorsque la plateforme et les paramètres 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 est suffisant pour fusionner cette configuration dans votre application hôte.

Les permissions d'exécution

Appelez ces méthodes pendant 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 Android 14 et ultérieure pour les intentions plein écran lorsque nécessaire.

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

• channelIdidentifiant de la chaîne de notification
• channelNamenom de la chaîne de notification visible pour l'utilisateur
• showFullScreendemande l'activité plein écran
• isHighPrioritygardez la notification suffisamment perturbante pour les flux sonnants
• accentColortintez les surfaces de notification compatibles
• ringtoneUripointez vers une ressource de tonnerre personnalisée Android ou URI

Remarques sur le comportement

• La présentation plein écran est de meilleure qualité. Si le dispositif ou les paramètres utilisateur l'empêchent, Android affiche toujours la notification d'appel entrant.
• La gestion des temps d'attente est de meilleure qualité. Le plugin suit timeoutMs et émet callTimedOutmais votre serveur doit toujours réconcilier les appels manqués de son côté.
• Les actions d'acceptation, de refus et de fin sont émises à nouveau à travers les écouteurs Capacitor afin que votre application puisse rejoindre ou nettoyer la session de l'appel réel.

Modèle de production recommandé

Utilisez la push 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 en dehors du plugin :

• Inscription et gestion des jetons FCM
• Cycle de vie de la session multimédia
• État de l'appel backend
• Logique de rappel et d'appel manqué

Continuez depuis Android

Si vous utilisez Android pour planifier le comportement de médias et d'interface natifs, connectez-l’à En utilisant @capgo/capacitor-incoming-call-kit pour la capacité native dans En utilisant @capgo/capacitor-incoming-call-kit, En utilisant @capgo/capacitor-live-activities pour la capacité native dans En utilisant @capgo/capacitor-live-activities, @capgo/capacitor-live-activities pour les détails d'implémentation dans @capgo/capacitor-activités-en-vivre- En utilisant @capgo/capacitor-joueur-de-videos pour la capacité native dans En utilisant @capgo/capacitor-joueur-de-videos, et @capgo/capacitor-joueur-de-videos pour les détails d'implémentation dans @capgo/capacitor-joueur-de-videos.