call_detector_plugin 1.0.1

A Flutter plugin for detecting incoming, outgoing, and active calls on Android and iOS devices

📞 CallDetector

Written using the languages

Demo

Installation

Add the following to your pubspec.yaml file:

dependencies:
  call_detector_plugin: ^[latest_version]

Then run:

flutter pub get

Features and purpose of CallDetector

CallDetector is designed to monitor the status of GSM/CDMA (VoIP/Video Call) phone calls in Flutter applications. It helps you respond to changes in the call status — for example, when a user accepts a call, ends a conversation, or when a call arrives.

The main tasks that CallDetector solves:

• Tracking incoming, outgoing, and active calls
  Allows the application to determine when a GSM/CDMA (VoIP/Video Call) call is taking place, and at what stage it is currently (active or completed).

• Real-time response to a call status change
  Provides a stream of events that notifies all subscribers at once upon any change in the status of the call.

• Synchronization with the native platform layer
  Bidirectional interaction with Android and iOS takes place through the MethodChannel and EventChannel, which allows you to receive reliable information about calls.

• Providing multiple event subscribers
  A broadcast stream is used so that multiple components in the same application can receive call updates at the same time.

• Saving the last known call status
  A new subscriber immediately receives up-to-date information without having to wait for a new event, which simplifies status management.

In which scenarios is CallDetector useful:

• Multimedia applications where you need to pause an incoming call.
• Call recording apps that need to know when a conversation starts and ends.
• Social and communication applications that respond to the state of the network and calls.
• Any applications with a user interface that changes during phone events.

---

Thus, the CallDetector is an important tool for creating a more responsive and "smart" user experience when the state of the call directly affects the logic and behavior of the application.

---

Usage Example

mixin for [Bloc and Cubit]

class MyBloc extends Bloc<MyEvent, MyState> with CallDetectorMixin {
  MyBloc() : super(MyState()) {
    on<_WatchDetector>(_watchDetector);
    on<_GetCurrentCallStatus>(_getCurrentCallStatus);

    add(_WatchDetector());
  }

  Future<void> _watchDetector(_WatchDetector event, Emitter<MyState> emit) {
    return emit.forEach(
      callDetectStream,
      onData: (callStatus) {
        print('Current call status: $callStatus');
        return state.copyWith(isInCall: callStatus);
      },
    );
  }

  Future<void> _getCurrentCallStatus(_GetCurrentCallStatus event, Emitter<MyState> emit) async {
    // ...
    final currentCallValue = await getCurrentCallStatus();
    // ...
  }
}

class MyCubit extends Cubit<MyState> with CallDetectorMixin {
  StreamSubscription<bool>? subscription;

  MyCubit() : super(const MyState());

  void init() {
    subscription ??= callDetectStream.listen((isCalling) {
      if (isCalling) {
        print('Call is active in MyCubit!');
      }
    });
  }

  Future<void> checkStatus() async {
    bool status = await getCurrentCallStatus();
    print('Current call status: $status');
  }

  @override
  Future<void> close() async {
    await subscription?.cancel();
    return super.close();
  }
}

mixin for [StatefulWidget and StatelessWidget]

class MyWidget extends StatefulWidget {
  const MyWidget({super.key});

  @override
  State<MyWidget> createState() => _MyWidgetState();
}

class _MyWidgetState extends State<MyWidget> with CallDetectorMixin {

  @override
  Widget build(BuildContext context) {
    return StreamBuilder<bool>(
      stream: singletonCallDetectStream,
      builder: (context, snapshot) {
        return Text('Current call status: ${snapshot.data}');
      }
    );
  }
}

class MyWidget extends StatelessWidget with CallDetectorMixin {
  const MyWidget({super.key});

  @override
  Widget build(BuildContext context) {
    return StreamBuilder<bool>(
      stream: singletonCallDetectStream,
      builder: (context, snapshot) {
        return Text('Current call status: ${snapshot.data}');
      }
    );
  }
}

Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository.
2. Create a new branch (git checkout -b feature/your-feature).
3. Commit your changes (git commit -m 'Add your feature').
4. Push to the branch (git push origin feature/your-feature).
5. Open a Pull Request.

Contacts

For issues or suggestions, please open an issue on the GitHub repository.