Capacitor Native Ringer

Capacitor 7+ plugin for displaying incoming calls using Android's native ConnectionService API. Provides system-level call integration with native ringing UI.

Install

npm install capacitor-native-ringer
npx cap sync

API

displayIncomingCall(options)

import { NativeRinger } from "capacitor-native-ringer";

await NativeRinger.displayIncomingCall({
  callId: "unique-call-id",
  callerName: "John Doe",
  callerNumber: "+1234567890",
  hasVideo: false,
});

Event Listeners

NativeRinger.addListener("callAnswered", ({ callId }) => {
  console.log("Call answered:", callId);
});

NativeRinger.addListener("callRejected", ({ callId }) => {
  console.log("Call rejected:", callId);
});

NativeRinger.addListener("callEnded", ({ callId }) => {
  console.log("Call ended:", callId);
});

answerCall / rejectCall / endCall

await NativeRinger.answerCall({ callId: "call-id" });
await NativeRinger.rejectCall({ callId: "call-id" });
await NativeRinger.endCall({ callId: "call-id" });

Android Requirements

• Minimum SDK: 23 (Android 6.0)
• Target SDK: 34+
• Permissions are automatically added via manifest merging