Android

Comment fonctionne le comportement d'Android

Sur Android, le plugin publie une notification d'appel entrant de priorité élevée et peut faire apparaître une activité à pleine écran lorsque la plateforme et les paramètres 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 il suffit de fusionner cette configuration dans votre application hôte.

Autorisations en temps d'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() demandez la permission de notification sur Android 13 et ultérieurement.
• requestFullScreenIntentPermission() ouvre la page de paramètres Android 14 et ultérieur 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
• isHighPrioritygarde la notification suffisamment perturbante pour les flux sonores
• accentColortinte les surfaces de notification compatibles
• ringtoneUripointe vers une ressource ou une URI de tonnerre personnalisé Android

Remarques sur le comportement

• La présentation plein écran est de bonne volonté. Si le dispositif ou les paramètres de l'utilisateur l'empêchent, Android affiche toujours la notification d'appel entrant.
• La gestion des temps limites est de bonne volonté. Le plugin suit timeoutMs et émet callTimedOut, mais 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 le push Android ou votre service d'appel SDK pour le transport, puis laissez ce plugin gérer la dernière étape de l'interface utilisateur de sonnerie native. Gardez ces responsabilités à l'extérieur du plugin :

• L'enregistrement et la gestion de jeton FCM
• Le cycle de vie de la session multimédia
• État de l'appel backend
• Logique de rappel et d'appel manqué

Continuer depuis Android

Si vous utilisez Android pour planifier le comportement de médias et d'interface natifs, connectez-l’avec Utiliser @capgo/capacitor-incoming-call-kit pour la capacité native dans Utiliser @capgo/capacitor-incoming-call-kit, Utiliser @capgo/capacitor-live-activities pour la capacité native dans Utiliser @capgo/capacitor-live-activities, @capgo/capacitor-live-activities pour les détails d'implémentation dans @capgo/capacitor-activités-en-ligne, En utilisant @capgo/capacitor-joueur-de-videos pour la capacité native 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.