Android

Comment fonctionne le comportement Android

Sur Android, le plugin affiche une notification d'appel entrant de priorité élevée et peut ouvrir 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 Cela suffit à fusionner cette configuration dans votre application hôte.

Autorisations en temps de cours

Appeler ces méthodes pendant l'inscription ou avant de compter sur la présentation d'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

• channelId : identifiant de la chaîne de notification
• channelName: nom de la chaîne de notification visible pour l'utilisateur
• showFullScreen : demande l'activité plein écran
• isHighPriority : garde la notification suffisamment perturbante pour les flux d'appel en sonnerie
• accentColor: notification surfaces compatibles avec la teinte
• ringtoneUri: pointe vers une ressource de tonnalité Android personnalisée ou URI

Remarques sur le comportement

• Présentation plein écran est de bonne volonté. Si le dispositif ou les paramètres utilisateur l'empêchent, Android affiche toujours la notification d'appel entrant.
• Gestion des temps limites est de meilleure qualité. Le plugin suit timeoutMs et émet callTimedOut, mais votre serveur doit toujours réconcilier les appels manqués de son côté.
• Acceptez, refusez et terminez les actions qui 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 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 :

• Enregistrement et gestion de jeton FCM
• Cycle de vie de la session multimédia
• État d'appel vers le serveur
• Logique de rappel et de missed-call

Continuez de là depuis Android

Si vous utilisez Android pour planifier un comportement multimédia et d'interface natif, connectez-l’à 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 Utiliser @capgo/capacitor-activités en direct, @capgo/capacitor-activités en direct pour le détail d'implémentation dans @capgo/capacitor-activités en direct, Utiliser @capgo/capacitor-joueur de vidéo pour la capacité native dans Utiliser @capgo/capacitor-joueur de vidéo, et @capgo/capacitor-joueur de vidéo pour le détail d'implémentation dans @capgo/capacitor-joueur de vidéo.