Aller au contenu principal
@capgo/capacitor-incoming-call-kit Communication Open source

Kit d'appel entrant Plugin Capacitor

Affichez l'interface native d'appel entrant avec iOS CallKit et les notifications plein écran Android

Installer

bun add @capgo/capacitor-incoming-call-kit bunx cap sync
npm, pnpm ou yarn
  • npm install @capgo/capacitor-incoming-call-kit
  • pnpm add @capgo/capacitor-incoming-call-kit
  • yarn add @capgo/capacitor-incoming-call-kit

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.

FAQ

FAQ du plugin Incoming Call Kit

Comment installer le plugin Incoming Call Kit dans une application Capacitor ?

Exécutez "bun add @capgo/capacitor-incoming-call-kit" (ou "npm install @capgo/capacitor-incoming-call-kit"), puis lancez "bunx cap sync" pour que les projets iOS et Android prennent en compte le code natif. Importez-le depuis "@capgo/capacitor-incoming-call-kit" dans votre code.

Est-ce que @capgo/capacitor-incoming-call-kit fonctionne avec React, Vue et Angular ?

Oui. Incoming Call Kit est un package Capacitor, il fonctionne donc avec n'importe quel framework web tournant sous Capacitor, y compris Ionic, React, Vue, Angular, Svelte et le JavaScript pur.

Quelle version de Capacitor est supportée par @capgo/capacitor-incoming-call-kit ?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à la version majeure de votre Capacitor (par exemple le plugin v8 avec Capacitor 8). Le tableau de compatibilité du README de GitHub recense les versions maintenues.

Est-ce que @capgo/capacitor-incoming-call-kit est gratuit et open source ?

Oui. Le code source de code est public sur GitHub à l'adresse https://github.com/Cap-go/capacitor-incoming-call-kit/ et le package est gratuit à installer via npm. Les rapports de bugs et les pull requests sont les bienvenus.

Puis-je mettre à jour code utilisant Incoming Call Kit sans passer par une revue de l'App Store ?

L'installation ou la mise à jour du plugin modifie le code natif, ce qui impose un nouveau build pour les stores. Ensuite, les changements JavaScript, HTML et CSS qui appellent le plugin peuvent être livrés instantanément via les live updates de Capgo.

Déployez les changements d'Incoming Call Kit sans attendre la validation de l'app

Une fois le plugin intégré à votre build de store, Capgo live updates déploie vos changements JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Commencez avec Capgo