Passer à la navigation

Android

GitHub

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.

Les permissions en temps d'exécution

Section intitulée « Autorisations de runtime »

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 lorsqu'il le faut.
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',
},
});
  • channelId : identifiant de la chaîne de notification
  • channelName : nom de la chaîne de notification visible pour l'utilisateur
  • showFullScreen: demandez la présentation à pleine écran
  • isHighPriority: gardez la notification suffisamment perturbante pour les flux d'appel sonnant
  • accentColor: teintez les surfaces de notification compatibles
  • ringtoneUri: pointez vers une ressource de tonnerre personnalisée Android ou URI
  • La présentation à pleine écran est de meilleure qualité. Si le dispositif ou les paramètres de l'utilisateur bloquent cela, Android affiche toujours la notification d'appel entrant.
  • Gestion des temps limites est de meilleure qualité. Le plugin suit et émet timeoutMs mais votre serveur devrait toujours réconcilier les appels manqués de son côté. callTimedOutLes actions d'acceptation, de refus et de fin sont émises à nouveau à travers les __CAPGO_KEEP_0__ listeners afin que votre application puisse rejoindre ou nettoyer la session d'appel réelle.
  • Accept, decline, and end actions are emitted back through Capacitor listeners so your app can join or clean up the real call session.

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 :

  • La gestion de l'inscription et du jeton FCM
  • Le cycle de vie de la session multimédia
  • L'état des appels vers le serveur
  • La logique des appels manqués et des retours

Si vous utilisez Android pour planifier le comportement de média et d'interface native, connectez-le avec Utilisez @capgo/capacitor-kit-appel-entrant pour la capacité native dans l'utilisation de @capgo/capacitor-kit-appel-entrant, Utilisation de @capgo/capacitor-activités-en-vivre pour la capacité native dans l'utilisation de @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, Utilisation de @capgo/capacitor-joueur-de-videos pour la capacité native dans l'utilisation de @capgo/capacitor-joueur-de-videos, et @capgo/capacitor-joueur-de-videos pour le détail d'implémentation dans @capgo/capacitor-joueur-de-videos.