onecxi_flutter_sdk 1.0.0+1

A Flutter SDK for OneCxi calling functionality with WebSocket and VoIP support

Changelog

All notable changes to the OneCxi Flutter SDK will be documented in this file.

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

1.0.0+1 2025-10-XX

Added

• Initial release of OneCxi Flutter SDK
• Support for inbound, outbound, and app-to-app calls
• Real-time audio streaming via WebSocket
• CallKit integration for iOS
• Native foreground service for Android
• Push notification support (VoIP for iOS, FCM for Android)
• Call persistence when app is killed
• Lock screen calling interface
• Call controls (mute, hold, speaker, DTMF)
• Comprehensive error handling
• Detailed logging

1.1.0 - 2025-10-15

Added 🎉

Call Persistence

• Android: Native foreground service keeps calls alive when app is killed
• iOS: Background service with CallKit ensures call persistence
• Automatic UI synchronization when app is reopened during an active call
• Call timer resumes correctly from native call duration
• getNativeCallStatus() method to retrieve active call information
• isCallActive() method to check call status from native layer
• forceEndCall() method for cleanup operations

Lock Screen Calling

• Android: Native lock screen UI with accept/decline actions
• iOS: Full CallKit integration with native lock screen interface
• Works seamlessly with device lock/unlock
• Automatic transition between lock screen and in-app UI
• showWhenLocked and turnScreenOn support for Android MainActivity

Enhanced App-to-App Calls

• Cross-platform: Android ↔ iOS app-to-app calls now fully supported
• Smart WebSocket: Uses Dart WebSocket for app-to-app (better backend compatibility)
• Native WebSocket: Uses native service for inbound/outbound (better persistence)
• Automatic call decline API integration with backend
• Proper WebSocket header configuration for app-to-app calls

UI Synchronization

• App lifecycle monitoring for accurate call status
• Native-to-Flutter state synchronization
• Proper cleanup of UI resources
• Call timer stops and resets properly when call ends
• refreshCallStatus() method for manual sync

Changed 🔄

WebSocket Management

• App-to-app calls now use Dart WebSocket instead of native (resolves backend compatibility)
• Inbound/outbound calls continue using native WebSocket for persistence
• Improved WebSocket connection handling for different call types

Call Status Tracking

• Android: Dynamic call status from OneCxiCallService companion object
• iOS: Call state persisted in UserDefaults for cross-session tracking
• Enhanced getNativeCallStatus with call type, DID, registered number, and duration

Decline API

• Implemented decline API integration with backend
• Uses specific long API key for decline requests
• Sends proper parameters: mobileNO, event, callType, timestamp
• Handles 403 responses as expected behavior for unanswered calls

Fixed 🐛

Call Timer Issues

• Fixed timer not stopping when call ends
• Fixed timer not resetting to 00:00 after call
• Fixed timer not starting correctly when app is reopened
• Fixed timer synchronization with native call duration

UI Synchronization

• Fixed call active status not updating properly
• Fixed UI not syncing when app resumes from background
• Fixed dual screens appearing on Android (native + Flutter)
• Removed automatic app launch, rely on user interaction with notification

App-to-App Calls

• Fixed Android → iOS app-to-app calls not connecting
• Fixed WebSocket EOFException for app-to-app calls
• Fixed incorrect DID in native call status for app-to-app
• Fixed wrong x-did header for app-to-app calls

Native Service

• Fixed Android foreground service notification management
• Fixed call state not clearing properly on end
• Fixed broadcast receiver not being registered correctly
• Fixed iOS call state not persisting across app restarts

Technical Details 🔧

Android Native Service

// New foreground service implementation
class OneCxiCallService : Service() {
    // Keeps calls alive when app is killed
    // Manages notification and wake lock
    // Handles WebSocket connection
}

iOS Call State Tracking

// Call state persistence
UserDefaults.standard.set(callState, forKey: "OneCxi_CallActive")
// Retrieved on app restart for UI sync

Smart WebSocket Selection

// App-to-app: Dart WebSocket
if (Platform.isAndroid && callType == 'app_to_app') {
  useFlutterAudioHelper();
}
// Inbound/Outbound: Native WebSocket
else if (Platform.isAndroid) {
  useNativeService();
}

Migration Guide 📝

From v1.0.0 to v1.1.0:

1. Update Android Permissions:

<uses-permission android:name="android.permission.FOREGROUND_SERVICE_PHONE_CALL" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_MICROPHONE" />
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

2. Update MainActivity (Android):

<activity
    android:name=".MainActivity"
    android:showWhenLocked="true"
    android:turnScreenOn="true"
    ...>
</activity>

3. Implement Lifecycle Monitoring:

class _MyAppState extends State<MyApp> with WidgetsBindingObserver {
  @override
  void didChangeAppLifecycleState(AppLifecycleState state) {
    if (state == AppLifecycleState.resumed) {
      _sdk.refreshCallStatus();
    }
  }
}

No breaking changes! All existing code continues to work.

---

1.0.0 - 2025-09-01

Added

• Initial release of OneCxi Flutter SDK
• Support for inbound, outbound, and app-to-app calls
• Real-time audio streaming via WebSocket
• CallKit integration for iOS
• ConnectionService integration for Android
• Push notification support (VoIP for iOS, FCM for Android)
• User registration system
• Call controls (mute, hold, speaker, DTMF)
• Comprehensive error handling
• Detailed logging

Features

• Multiple call types support
• Cross-platform compatibility (iOS & Android)
• Native UI integration
• Audio recording and playback
• WebSocket communication
• Permission management
• Call state management

---

Release Notes

v1.1.0 - Major Update ✨

This release brings significant improvements to call reliability and user experience:

Key Highlights:

• 📱 Calls now persist when app is killed (both iOS and Android)
• 🔒 Native lock screen calling interface
• 🔄 Cross-platform app-to-app calls work seamlessly
• 🎯 Improved UI synchronization and state management

What This Means for Users:

• No dropped calls when app is closed
• Professional calling experience on lock screen
• Reliable app-to-app communication across platforms
• Smooth UI updates and timer accuracy

For Developers:

• Easy migration with no breaking changes
• Better debugging with enhanced logging
• Improved error handling and recovery
• Production-ready reliability

Testing Checklist for v1.1.0:

• ✅ Call persistence when app is killed (Android)
• ✅ Call persistence when app is killed (iOS)
• ✅ Lock screen calling (Android)
• ✅ Lock screen calling (iOS)
• ✅ App-to-app calls (Android → iOS)
• ✅ App-to-app calls (iOS → Android)
• ✅ UI timer synchronization
• ✅ Call status sync on app resume
• ✅ Decline API integration
• ✅ Cross-platform compatibility

---

Upgrade Path

From 1.0.0 to 1.1.0

• Difficulty: Easy
• Breaking Changes: None
• Estimated Time: 15 minutes
• Required Changes: Add new permissions, update MainActivity (Android)
• Optional Changes: Implement lifecycle monitoring for better UX

From 0.9.x to 1.1.0

• Difficulty: Medium
• Breaking Changes: Yes (removed shared_preferences dependency)
• Estimated Time: 30 minutes
• Required Changes: Update dependencies, update error handling, migrate storage

---

Support

For issues, questions, or feedback regarding this release:

• Check the Integration Guide
• Review the Troubleshooting section
• Contact support with detailed logs and reproduction steps

---

Last Updated: October 15, 2025
Current Version: 1.1.0+1