Android

Comment fonctionne le comportement d'Android

Sur Android, le plugin envoie une notification d'appel entrant de priorité élevée et peut faire apparaître 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.

Autorisations en temps de exécution

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 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 pour le canal de notification
• channelNamenom du canal visible pour l'utilisateur
• showFullScreendemande l'activité plein écran
• isHighPriority: Gardez la notification suffisamment perturbante pour les flux d'appel
• accentColor: Teinte les surfaces de notification compatibles
• ringtoneUri: Pointez vers une ressource ou une URI de tonnerre personnalisé Android

Notes de comportement

• La présentation plein écran est de meilleure volonté. Si le dispositif ou les paramètres de l'utilisateur bloquent cela, Android affiche toujours la notification d'appel entrant.
• Traitement du temps limite est de meilleure volonté. Le plugin suit timeoutMs et émet callTimedOut, mais votre serveur devrait 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 Capacitor écouteurs 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 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 d'appel de backend
• Logique de reprise et d'appel manqué

Gardez-vous de continuer à partir d'Android

Android pour planifier le comportement de média et d'interface native, connectez-le avec En utilisant @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-incoming-call-kit pour la capacité native en utilisant En @capgo/capacitor-incoming-call-kit for the native capability in Using @capgo/capacitor-incoming-call-kit, Utiliser @capgo/capacitor-activités-en-vive pour la capacité native dans Utiliser @capgo/capacitor-activités-en-vive, @capgo/capacitor-activités-en-vive pour le détail d'implémentation dans @capgo/capacitor-activités-en-vive, Utiliser @capgo/capacitor-joueur-de-videos pour la capacité native dans Utiliser @capgo/capacitor-joueur-de-videos, et @capgo/capacitor-joueur-de-videos pour le détail d'implémentation dans @capgo/capacitor-joueur-de-videos.