How ashiqualii/vonage_voice works
Vonage Voice is a Flutter plugin for integrating Vonage voice calls with native Android Telecom and iOS CallKit behavior. The principal workflow is: the host app authenticates with a backend-issued JWT, the plugin establishes a Vonage session, and incoming pushes or Flutter-initiated outgoing calls enter the native call stack; call state and controls are then exposed to Flutter. The README documents platform flows and capabilities; source excerpts are partial, so some cross-platform links reflect documented behavior rather than inspected implementation details.
Main entry points: vonage_voice.dart Flutter call API · VonageVoicePlugin.swift iOS call plugin · VonageVoicePlugin.kt Android plugin bridge · TVConnectionService.kt Telecom service
Components 18
Flutter API and state
- Flutter call API
lib/vonage_voice.dart - Platform channels
lib/_internal/method_channel/vonage_call_method_channel.dart - Call models
lib/models/call_session.dart - Call state manager
lib/models/call_session_manager.dart
Android incoming calls
- FCM push handler
android/src/main/kotlin/com/iocod/vonage/vonage_voice/fcm/VonageFirebaseMessagingService.kt - Telecom service
android/src/main/kotlin/com/iocod/vonage/vonage_voice/service/TVConnectionService.kt - Call connections
android/src/main/kotlin/com/iocod/vonage/vonage_voice/call/TVCallInviteConnection.kt - Incoming call UI
android/src/main/kotlin/com/iocod/vonage/vonage_voice/IncomingCallActivity.kt - Answer trampoline
android/src/main/kotlin/com/iocod/vonage/vonage_voice/AnswerCallTrampolineActivity.kt
Android call runtime
- Android plugin bridge
android/src/main/kotlin/com/iocod/vonage/vonage_voice/VonageVoicePlugin.kt - Call preferences
android/src/main/kotlin/com/iocod/vonage/vonage_voice/storage/StorageImpl.kt
iOS call runtime
- iOS call plugin
ios/Classes/VonageVoicePlugin.swift
External systems
- JWT backend
- Vonage Voice
- Firebase FCM
- APNs VoIP
- Mobile call OS
Other components
- Host app user
Connections 21
- Host app user → Flutter call API: initiates calls
README.md - JWT backend → Flutter call API: issues JWT
README.md - Flutter call API → Platform channels: invokes native calls
README.md - Platform channels → Android plugin bridge: dispatches methods
- Platform channels → iOS call plugin: dispatches methods
- Flutter call API → Call models: exposes call state
- Call models → Call state manager: tracks sessions
- Android plugin bridge → Vonage Voice: creates sessions and calls
README.md - Firebase FCM → FCM push handler: delivers incoming push
README.md - FCM push handler → Telecom service: starts call service
android/src/main/kotlin/com/iocod/vonage/vonage_voice/fcm/VonageFirebaseMessagingService.kt - Telecom service → Call connections: manages connections
android/src/main/kotlin/com/iocod/vonage/vonage_voice/service/TVConnectionService.kt - Call connections → Incoming call UI: launches call UI
android/src/main/kotlin/com/iocod/vonage/vonage_voice/call/TVCallInviteConnection.kt - Incoming call UI → Answer trampoline: answers from notification
android/src/main/kotlin/com/iocod/vonage/vonage_voice/AnswerCallTrampolineActivity.kt - Telecom service → Android plugin bridge: broadcasts call events
README.md - Android plugin bridge → Call preferences: persists caller settings
android/src/main/kotlin/com/iocod/vonage/vonage_voice/VonageVoicePlugin.kt - Telecom service → Mobile call OS: integrates Telecom
README.md - iOS call plugin → APNs VoIP: receives VoIP pushes
README.md - iOS call plugin → Mobile call OS: reports calls to CallKit
README.md - iOS call plugin → Vonage Voice: restores sessions and resolves invites
README.md - iOS call plugin → Flutter call API: emits call state
README.md - Android plugin bridge → Flutter call API: emits call events
README.md