Zum Hauptinhalt springen
@capgo/capacitor-incoming-call-kit Kommunikation Open Source

Eingehender Anruf über Call Kit Capacitor Plugin

Native Anruferkennung-UI mit iOS CallKit und Android Full-Screen-Benachrichtigungen anzeigen

Installieren

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

Anleitung

Incoming Call Kit in Capacitor nutzen

@capgo/capacitor-incoming-call-kit verwenden

Capacitor API, um eine native Oberfläche für eingehende Anrufe anzuzeigen.

Installieren

bun add @capgo/capacitor-incoming-call-kit
bunx cap sync

bunx cap sync kopiert den nativen code des Plugins in deine nativen Projekte. Nach jedem Plugin-Upgrade erneut ausführen.

Importieren

import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';

API auf einen Blick

Methode Beschreibung
showIncomingCall Zeigt das native UI für eingehende Anrufe an.
endCall Beendet einen spezifischen, getrackten Anruf.
endAllCalls Beendet alle getrackten Anrufe.
getActiveCalls Gibt die aktuell getrackten Anrufe zurück.
checkPermissions Gibt den aktuellen Berechtigungsstatus für Benachrichtigungen und Full-Screen-Intents zurück.
requestPermissions Fordert die Benachrichtigungsberechtigung an, sofern die Plattform dies unterstützt.
requestFullScreenIntentPermission Öffnet die Android 14+ Einstellungen für Full-Screen-Intents, falls verfügbar.

Beispiele

showIncomingCall()

Zeigt das native UI für eingehende Anrufe an.

import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';

const result = await IncomingCallKit.showIncomingCall({
  callId: 'call-id-123',
  callerName: 'caller',
});
console.log(result);

endCall()

Beendet einen spezifischen, getrackten Anruf.

import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';

const result = await IncomingCallKit.endCall({ callId: 'call-id-123' });
console.log(result);

endAllCalls()

Beendet alle getrackten Anrufe.

import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';

const result = await IncomingCallKit.endAllCalls();
console.log(result);

getActiveCalls()

Gibt die aktuell getrackten Anrufe zurück.

import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';

const result = await IncomingCallKit.getActiveCalls();
console.log(result);

checkPermissions()

Gibt den aktuellen Berechtigungsstatus für Benachrichtigungen und Full-Screen-Intents zurück.

import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';

const result = await IncomingCallKit.checkPermissions();
console.log(result);

requestPermissions()

Fordert die Benachrichtigungsberechtigung an, sofern die Plattform dies unterstützt.

import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';

const result = await IncomingCallKit.requestPermissions();
console.log(result);

Die obige Tabelle listet die 7 Kernmethoden auf. Listener, Version-Helper und der vollständige Contract jeder Methode sind in der GitHub Repository.

Events abonnieren

addListener gibt ein Handle zurück. Rufe handle.remove() auf, wenn der Screen unmountet, oder IncomingCallKit.removeAllListeners() auf, um alle Listener zu entfernen.

Vollständige Referenz

Weiterlesen: @capgo/capacitor-incoming-call-kit verwenden

Wenn du es nutzt @capgo/capacitor-incoming-call-kit verwenden um Dashboard- und API-Operationen zu planen, verbinde es mit @capgo/capacitor-incoming-call-kit für Details zur Implementierung in @capgo/capacitor-incoming-call-kit, Erste Schritte für die Implementierungsdetails in Erste Schritte, API Übersicht für Details zur Implementierung im API Overview, Einführung für die Implementierungsdetails in der Einleitung und API Schlüssel für die Implementierungsdetails in den API Keys.

FAQ

Incoming Call Kit Plugin FAQ

Wie installiere ich das Incoming Call Kit Plugin in einer Capacitor App?

Führe "bun add @capgo/capacitor-incoming-call-kit" (oder "npm install @capgo/capacitor-incoming-call-kit") aus und danach "bunx cap sync", damit die iOS- und Android-Projekte das native code übernehmen. Importiere es in deiner App code aus "@capgo/capacitor-incoming-call-kit".

Funktioniert @capgo/capacitor-incoming-call-kit mit React, Vue und Angular?

Ja. Incoming Call Kit ist ein Capacitor Package und funktioniert daher mit jedem Web-Framework, das in Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und reinem JavaScript.

Welche Capacitor Version wird von @capgo/capacitor-incoming-call-kit unterstützt?

Capgo Plugins folgen der Major-Version von Capacitor: Nutze die Plugin-Major-Version, die zu deiner Capacitor Major-Version passt (z. B. Plugin v8 bei Capacitor 8). Die Kompatibilitätstabelle im GitHub README listet die gepflegten Versionen auf.

Ist @capgo/capacitor-incoming-call-kit kostenlos und Open Source?

Ja. Der code Source-Code ist öffentlich auf GitHub unter https://github.com/Cap-go/capacitor-incoming-call-kit/ einsehbar und das Paket kann kostenlos via npm installiert werden. Bug-Reports und Pull Requests sind willkommen.

Kann ich code mit Incoming Call Kit ohne App Store Review aktualisieren?

Die Installation oder ein Upgrade des Plugins ändert den nativen code, weshalb ein neuer Store-Build nötig ist. Danach können JavaScript-, HTML- und CSS-Änderungen, die das Plugin aufrufen, sofort per Capgo Live Updates ausgeliefert werden.

Incoming Call Kit Änderungen ohne App-Review ausrollen

Sobald das Plugin in deinem Store-Build ist, bringt Capgo mit Live-Updates deine JavaScript-, HTML- und CSS-Änderungen in Minuten zu den Nutzern.

Starte mit Capgo