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 inclut 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.

Permissions de runtime

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() demandez la permission de notification Android 13 et ultérieur.
• requestFullScreenIntentPermission() ouvre la page de paramètres Android 14 et ultérieur pour les intents 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
• showFullScreenDemander l'activité en plein écran
• isHighPriorityConserver la notification suffisamment perturbante pour les flux d'appel sonnant
• accentColorCompatibilité de la teinte des surfaces de notification
• ringtoneUriPoint vers une ressource ou une URI de tonnerre personnalisé pour Android

Remarques sur le comportement

• La présentation en plein écran est de meilleure qualité. Si le dispositif ou les paramètres de l'utilisateur l'empêchent, Android affiche toujours la notification d'appel entrant.
• Gestion des temps d'attente est effectuée au mieux. Le plugin suit timeoutMs et émet callTimedOutmais votre serveur backend devrait 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 le 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 à l'extérieur du plugin :

• Inscription et gestion de jetons FCM
• Cycle de vie de la session multimédia
• État des appels backend
• Logique commerciale de la reprise et des appels manqués

Continuez depuis Android

Si vous utilisez Android pour planifier le comportement de médias et d'interface natifs, connectez-le à En utilisant @capgo/capacitor-kit-appel-entrant pour la capacité native dans En utilisant @capgo/capacitor-kit-appel-entrant, En utilisant @capgo/capacitor-activités-en-vivre pour la capacité native dans En utilisant @capgo/capacitor-activités-en-vivre, @capgo/capacitor-activités-en-vivre pour le détail 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-player vidéo pour les détails d'implémentation dans @capgo/capacitor-player vidéo.