Skip to main content

callwave_flutter 0.7.0 copy "callwave_flutter: ^0.7.0" to clipboard
callwave_flutter: ^0.7.0 copied to clipboard

Flutter plugin for WhatsApp, Google Meet, and Teams-style VoIP call UX. Incoming/outgoing notifications, accept/decline/timeout, CallKit and Android full-screen intents.

Changelog #

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased] #

0.7.0 - 2026-11-04 #

Added #

  • CallData.ringbackStartMode with automatic (default) and appControlled modes.
  • CallSession.allowOutgoingRingback() lets the host grant playback permission after preparing its audio route. App-controlled playback also requires a visible call screen; iOS additionally requires CallKit audio activation.
  • CallwaveCallScreenReady reports readiness for custom call screens.
  • Raw-event APIs for reporting screen visibility and granting playback permission using the outgoing attempt's request ID.

Changed #

  • Android ringback waits until the call screen is visible and its entrance animation has completed. Built-in screens report readiness automatically. Custom screens must use CallwaveCallScreenReady or report visibility directly.
  • iOS automatic mode keeps CallKit-based startup. Its ringback duration cap now starts when playback succeeds and is not extended by audio reactivation.
  • Repeated outgoing setup updates the call without starting signaling again.
  • Updated both federated dependencies to ^0.4.0.

Fixed #

  • Cached screens report visibility again after hiding and reopening.
  • Automatically created sessions retain native ringback settings. Reused call IDs do not inherit settings from ended sessions awaiting cleanup.
  • Stale readiness signals and CallKit callbacks cannot affect replacement attempts. Connection, cleanup, and engine teardown invalidate pending playback.

0.6.0 - 2026-10-28 #

Added #

  • CallData.playRingback (default true). Outgoing calls play a ringback tone until the session is reported connected or ends; set it to false when your media stack plays its own.
  • CallData.maxRingbackDuration (default 120 seconds). Safety cap that stops the ringback tone if the call is never reported connected or ended. Sent in whole seconds, minimum 1.

Changed #

  • Updated callwave_flutter_platform_interface constraint to ^0.3.0 and callwave_flutter_method_channel to ^0.3.0.

0.5.1 - 2026-09-11 #

Fixed #

  • iOS 13: missed-call notifications still appear when the app is in the foreground. iOS 14+ keeps banner and Notification Center presentation.

Changed #

  • Updated callwave_flutter_method_channel constraint to ^0.2.1.

0.5.0 - 2026-04-23 #

Added #

  • iOS: Swift Package Manager support alongside existing CocoaPods support.
  • iOS: bundled Apple privacy manifest declaring UserDefaults access for plugin-owned call state.

Changed #

  • Breaking: minimum SDK constraints are now Dart ^3.11.0 and Flutter >=3.41.0.
  • Updated federated implementation dependencies to callwave_flutter_platform_interface: ^0.2.0 and callwave_flutter_method_channel: ^0.2.0.

0.4.1 - 2026-03-19 #

Added #

  • CallEventExtraKeys values for iOS CallKit failure handling: nativeErrorDescription, outcomeReasonCallkitStartFailed, outcomeReasonCallkitEndFailed, outcomeReasonIncomingPresentationFailed

Fixed #

  • iOS: CallKit transaction and incoming-presentation failures are surfaced on events with structured extra instead of false started / silent incoming failure; headless background validation timeouts align with Android (8s)
  • CallEventType.ended with CallEventExtraKeys.outcomeReasonCallkitEndFailed no longer ends the CallSession or calls native clearCallState, so the app stays aligned with CallKit until endCall succeeds

Notes for integrators #

  • On iOS, not every CallEventType.ended means the call is finished: when extra[CallEventExtraKeys.outcomeReason] is CallEventExtraKeys.outcomeReasonCallkitEndFailed, treat it as a failed hang-up attempt and retry endCall rather than tearing down session/UI as terminal.

0.4.0 - 2026-03-10 #

Added #

  • canScheduleExactAlarms() — returns whether the app can schedule exact alarms (Android 12+). On iOS, always returns true.
  • requestExactAlarmPermission() — opens system settings for exact alarm permission (Android 12+). No-op on iOS. Use before showing incoming calls to ensure reliable timeout scheduling.

Fixed #

  • Missed and timeout terminal events no longer clear native call state, preserving the platform missed-call UI (e.g. Android missed call notification)

0.3.1 - 2026-03-07 #

Fixed #

  • Shortened pubspec description to meet pub.dev 60–180 character requirement
  • Tightened dependency constraints (callwave_flutter_platform_interface and callwave_flutter_method_channel to ^0.1.2) for pub.dev compatibility scoring

0.3.0 - 2026-03-07 #

Added #

  • Ongoing-call restoration after process death: native layer persists call state and connectedAtMs; restoreActiveSessions() restores sessions with correct elapsed time. CallwaveEngine.onResumeCall for rejoin logic; default falls back to onAnswerCall/onStartCall. CallEventExtraKeys.connectedAtMs in event extra.
  • Missed-call startup actions: CallStartupAction, CallStartupActionType, and CallStartupRouteDecision.pendingAction() for when the app is launched from a missed-call notification (tap body or "Call Back")
  • prepareStartupRouteDecision() now returns pendingAction when the user launched from a missed-call notification and no active call session exists
  • CallEventExtraKeys.launchActionOpenMissedCall and launchActionCallback for launch action values in callback/missed events
  • backgroundIncomingCallDeclineValidator, CallDeclineDecision, and CallDeclineFailureReason for headless decline reporting from terminated incoming-call UI without opening the app

Breaking for custom platform implementations #

  • Custom CallwaveFlutterPlatform implementations must implement takePendingStartupAction() (returns null by default). For ongoing-call restoration, implement syncCallConnectedState and clearCallState (default no-ops).
  • Custom CallwaveFlutterPlatform implementations must update markMissed to accept optional extra. Override confirmAcceptedCall only if using [IncomingAcceptStrategy.deferOpenUntilConfirmed]; it has a default no-op. The method channel implementation already includes these changes.
  • registerBackgroundIncomingCallValidator signature changed: backgroundCallbackHandle is now optional, and backgroundDeclineCallbackHandle was added. Custom platforms must update their override to accept both optional handles.

0.2.1 - 2026-03-06 #

Fixed #

  • started event no longer regresses connected or reconnecting outgoing sessions to connecting state when cold-start routing (e.g. user taps ongoing call notification)

Changed #

  • Clarified pubspec description for pub.dev

0.2.0 - 2026-03-06 #

Added #

  • Conference session models: CallParticipant and ConferenceState
  • CallSession.updateConferenceState(...) and participantCount for in-app conference orchestration
  • Built-in conference CallScreen mode when participant count is greater than 1
  • CallwaveScope conference customization hooks: conferenceScreenBuilder, participantTileBuilder, and conferenceControlsBuilder
  • CallwaveThemeData for built-in conference styling while preserving current Callwave defaults
  • CallDataExtraKeys.androidMissedCallNotificationText for customizable Android missed call notification body text
  • CallEventExtraKeys with launchAction and launchActionOpenOngoing for platform launch actions (e.g. Android ongoing call notification tap)

Changed #

  • Conference layout: primary and local panels now in left column; rail on right. Primary panel title simplified to "Current Speaker"
  • Conference mode uses the current Callwave style and keeps controls as a plain bottom row with no rounded dock container
  • Default conference controls are now call-type aware: video calls show Mic, Speaker, Cam, End; audio calls show Mic, Speaker, End
  • One-to-one call UI remains unchanged and is still used for participantCount <= 1
  • Refactored call actions layout and enhanced test coverage for video call actions
  • Enhanced documentation and example app for missed call notifications

0.1.1 - 2026-03-05 #

Changed #

  • Extended pubspec description for pub.dev
  • Example app moved to packages/callwave_flutter/example for pub.dev recognition
  • Example imports refactored to relative paths for IDE compatibility
  • Listener function declaration in callwave_flutter_impl.dart clarified
  • Deduplication logic in call_session.dart simplified with map literal
  • Action button size made constant in call_action_button.dart
  • Conference state instantiation in tests updated to use const constructor
  • README enhanced with "Why callwave_flutter?" and platform status details

0.1.0 - 2025-03-04 #

Added #

  • Initial release of callwave_flutter
  • CallwaveFlutter singleton with showIncomingCall, showOutgoingCall, endCall, markMissed, and Stream<CallEvent> events
  • CallwaveEngine and CallSession for session-first orchestration
  • CallScreen widget for full-screen call UI (incoming/outgoing, accept/decline, mute/speaker/end)
  • CallwaveScope and CallStartupRouteDecision for cold-start routing
  • Android implementation: full-screen call intents, notifications, timeout scheduling (AlarmManager)
  • iOS implementation: CallKit integration
  • Event buffering for cold-start delivery (max 50 events, 10-minute TTL)
  • PostCallBehavior for background-on-ended (Android)
  • CallDataExtraKeys constants for WebRTC backends (roomId, meetingId, token, etc.)
6
likes
150
points
1.49k
downloads

Documentation

API reference

Publisher

verified publishereffdel.com

Weekly Downloads

Flutter plugin for WhatsApp, Google Meet, and Teams-style VoIP call UX. Incoming/outgoing notifications, accept/decline/timeout, CallKit and Android full-screen intents.

Repository (GitHub)
View/report issues

License

BSD-3-Clause (license)

Dependencies

callwave_flutter_method_channel, callwave_flutter_platform_interface, flutter

More

Packages that depend on callwave_flutter

Packages that implement callwave_flutter