CallBundle class

CallBundle — Native incoming & outgoing call UI for Flutter.

This is the app-facing public API. Import package:callbundle/callbundle.dart to access all functionality.

Quick Start

// 1. Configure once during app startup
await CallBundle.configure(NativeCallConfig(
  appName: 'MyApp',
  android: AndroidCallConfig(phoneAccountLabel: 'MyApp Calls'),
  ios: IosCallConfig(includesCallsInRecents: true),
));

// 2. Listen for call events
CallBundle.onEvent.listen((event) {
  switch (event.type) {
    case NativeCallEventType.accepted:
      print('Call ${event.callId} accepted by user');
      break;
    case NativeCallEventType.declined:
      print('Call ${event.callId} declined');
      break;
    case NativeCallEventType.ended:
      if (event.isUserInitiated) {
        print('User ended call ${event.callId}');
      } else {
        print('Call ${event.callId} ended programmatically');
      }
      break;
    default:
      break;
  }
});

// 3. Show incoming call (safe from background isolates)
await CallBundle.showIncomingCall(NativeCallParams(
  callId: 'abc-123',
  callerName: 'Ravi Kumar',
  callType: NativeCallType.video,
  extra: {'userId': '456', 'roomId': 'xyz'},
));

// 4. End a call programmatically
await CallBundle.endCall('abc-123');

Background Isolate Safety

showIncomingCall and endCall can be called from FCM background handlers without additional setup. The plugin automatically initializes BackgroundIsolateBinaryMessenger support.

Cold-Start Handling

When a user taps "Accept" while the app is killed, the plugin stores the event in PendingCallStore. After the Dart side calls configure, pending events are automatically delivered via onEvent. No hardcoded delays are needed.

Static Methods