Guide
Comment utiliser Incoming Call Kit dans Capacitor
Utilisation de @capgo/capacitor-incoming-call-kit
Capacitor API pour afficher une interface d'appel entrant native.
Installer
bun add @capgo/capacitor-incoming-call-kit
bunx cap sync
bunx cap sync copie le code natif du plugin dans vos projets natifs. Relancez-l’après chaque mise à jour du plugin.
Importer
import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';
Aperçu de API
| Méthode | Description |
|---|---|
showIncomingCall |
Affiche l'interface native d'appel entrant. |
endCall |
Termine un appel suivi spécifique. |
endAllCalls |
Termine tous les appels suivis. |
getActiveCalls |
Retourne les appels actuellement suivis. |
checkPermissions |
Retourne l'état actuel des permissions pour les notifications et les intents plein écran. |
requestPermissions |
Demande la permission de notification quand la plateforme le permet. |
requestFullScreenIntentPermission |
Ouvre la page des paramètres d'intent plein écran sur Android 14+ si disponible. |
Exemples
showIncomingCall()
Affiche l'interface native d'appel entrant.
import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';
const result = await IncomingCallKit.showIncomingCall({
callId: 'call-id-123',
callerName: 'caller',
});
console.log(result);
endCall()
Termine un appel suivi spécifique.
import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';
const result = await IncomingCallKit.endCall({ callId: 'call-id-123' });
console.log(result);
endAllCalls()
Termine tous les appels suivis.
import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';
const result = await IncomingCallKit.endAllCalls();
console.log(result);
getActiveCalls()
Retourne les appels actuellement suivis.
import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';
const result = await IncomingCallKit.getActiveCalls();
console.log(result);
checkPermissions()
Retourne l'état actuel des permissions pour les notifications et les intents plein écran.
import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';
const result = await IncomingCallKit.checkPermissions();
console.log(result);
requestPermissions()
Demande la permission de notification quand la plateforme le permet.
import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';
const result = await IncomingCallKit.requestPermissions();
console.log(result);
Le tableau ci-dessus liste les 7 méthodes principales. Les listeners, les helpers de version et le contrat complet de chaque méthode sont documentés dans la dépôt GitHub.
Écouter les événements
addListener renvoie un handle. Appelez handle.remove() lors du démontage de l'écran, ou IncomingCallKit.removeAllListeners() pour supprimer tous les listeners.
Référence complète
Continuer avec l'utilisation de @capgo/capacitor-incoming-call-kit
Si vous utilisez Utilisation de @capgo/capacitor-incoming-call-kit pour planifier les opérations du dashboard et de API, connectez-l’avec @capgo/capacitor-incoming-call-kit pour les détails d'implémentation dans @capgo/capacitor-incoming-call-kit, Prise en main pour les détails d'implémentation dans Getting Started Aperçu de API pour les détails d'implémentation dans « Vue d'ensemble de API », Introduction pour les détails d'implémentation dans l'Introduction, et Clés API pour les détails d'implémentation dans les clés API.