SDK: v1.0.31

Author: siprix

siprix_voip_sdk/CHANGELOG.md

@@ -1,3 +1,15 @@
+## 1.0.31
+- Updated upgradeToVideo implementation. Added new mode 'manual'
+- Added new event 'onCallVideoUpgradeRequested'
+  Triggered when specified 'acc.upgradeToVideo=manual' and remote side requests to add video
+- Added new method 'acceptVideoUpgrade'
+  App has invoke it from 'onCallVideoUpgradeRequested' event handler
+- iOS: Added new method 'endCallKitCall'
+  Example app uses it to end CallKit calls when SIP INVITE hasn't received
+- Android: Added ability to disable displaying activity on lock screen by adding to manifest
+  `<meta-data android:name="com.siprix.DontShowWhenLocked" android:value="true" />`
+  //2025.11.16
+
 ## 1.0.30
 - Added new setting 'acc.upgradeToVideo' and event 'onCallVideoUpgraded'
   //2025.11.07

siprix_voip_sdk/example/android/gradle/wrapper/gradle-wrapper.properties

@@ -1,5 +1,7 @@
-distributionBase=GRADLE_USER_HOME
-distributionPath=wrapper/dists
-zipStoreBase=GRADLE_USER_HOME
-zipStorePath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.0-all.zip
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.5-bin.zip
+networkTimeout=10000
+validateDistributionUrl=true
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists

siprix_voip_sdk/example/android/settings.gradle

@@ -23,7 +23,7 @@ pluginManagement {
 
 plugins {
     id "dev.flutter.flutter-plugin-loader" version "1.0.0"
-    id "com.android.application" version '8.1.4' apply false
+    id "com.android.application" version '8.2.1' apply false
 }
 
 include ":app"

siprix_voip_sdk/example/lib/account_add.dart

@@ -309,6 +309,7 @@ class AccountPageState extends State<AccountPage> {
         onChanged: (String? value) { setState(() { _account.userAgent = value; }); },
         initialValue: _account.userAgent,
       ),
+      _buildUpgradeToVideModeDropDown()
     ];
   }
 
@@ -354,6 +355,26 @@ class AccountPageState extends State<AccountPage> {
     );
   }
 
+  Widget _buildUpgradeToVideModeDropDown() {
+    return ButtonTheme(alignedDropdown: true, child:
+      DropdownButtonFormField<UpgradeToVideoMode>(
+        decoration: InputDecoration(
+          border: const UnderlineInputBorder(),
+          labelText: 'Upgrade to video mode:',
+          labelStyle: TextStyle(color: isAddMode() ? null : Theme.of(context).disabledColor),
+        ),
+        value: _account.upgradeToVideo,
+        onChanged: (UpgradeToVideoMode? value) { setState(() { _account.upgradeToVideo = value!; }); },
+        items: UpgradeToVideoMode.values.map((t) => _upgradeTovideoModeItem(t)).toList()
+    ));
+  }
+
+  DropdownMenuItem<UpgradeToVideoMode> _upgradeTovideoModeItem(UpgradeToVideoMode mode) {
+    return DropdownMenuItem<UpgradeToVideoMode>(value: mode, child:
+      Text(mode.name, style:Theme.of(context).textTheme.bodyMedium,)
+    );
+  }
+
   void _submit() {
     final form = _formKey.currentState;
     if (form == null || !form.validate() ||

siprix_voip_sdk/example/lib/calls_model_app.dart

@@ -1,5 +1,6 @@
 // ignore_for_file: non_constant_identifier_names
 
+import 'dart:async';
 import 'dart:io';
 
 import 'package:siprix_voip_sdk/calls_model.dart';
@@ -18,6 +19,8 @@ class CallMatcher {
   String push_Hint;
   ///Id assigned by library when SIP INVITE received
   int    sip_CallId;
+  ///Timestamp when this item has been created
+  DateTime timestamp = DateTime.now();
 
   CallMatcher(this.callkit_CallUUID, this.push_Hint, [this.sip_CallId=0]);
 }
@@ -31,6 +34,7 @@ class AppCallsModel extends CallsModel {
 
   final ILogsModel? _logs;
   final List<CallMatcher> _callMatchers=[];//iOS PushKit specific impl
+  Timer? _pushNotifTimer;
 
    /// Handle iOS Pushkit notification received by library (parse payload, update CallKit window, store data from push payload)
   @override
@@ -62,6 +66,9 @@ class AppCallsModel extends CallsModel {
 
     //Update CallKit
     SiprixVoipSdk().updateCallKitCallDetails(callkit_CallUUID, sipCallId, localizedCallerName, genericHandle, withVideo);
+
+    //Start timer which cleanups CallKit calls when SIP not received
+    _startPushNotifTimer();
   }
 
   @override
@@ -102,6 +109,30 @@ class AppCallsModel extends CallsModel {
       }
     }
   }
+
+  void _startPushNotifTimer() {
+    if(_pushNotifTimer != null) return;
+
+    const Duration kTimerDelay = Duration(seconds: 1);
+    const Duration kEndCallDelay = Duration(seconds: 15);
+
+    _pushNotifTimer = Timer.periodic(kTimerDelay, (Timer timer) {
+      DateTime now = DateTime.now();
+      for(int i = _callMatchers.length-1; i>=0; --i) {
+        //End CallKit call when SIP INVITE hasn't received during kEndCallDelay
+        CallMatcher cm = _callMatchers[i];
+        if((cm.sip_CallId==0) && now.difference(cm.timestamp) > kEndCallDelay) {
+          SiprixVoipSdk().endCallKitCall(cm.callkit_CallUUID);
+          _callMatchers.removeAt(i);
+        }
+      }
+
+      if(_callMatchers.isEmpty) {
+        _pushNotifTimer?.cancel();
+        _pushNotifTimer = null;
+      }
+    });
+  }
 }
 
 /*

siprix_voip_sdk/example/lib/main.dart

@@ -207,7 +207,7 @@ class _MyAppState extends State<MyApp> {
     //vdoData.bitrateKbps = 800;
     //SiprixVoipSdk().setVideoParams(vdoData);
 
-    //Detect version
+    //Check the version
     //String? version = await SiprixVoipSdk().version();
     //debugPrint("Siprix version: $version");
   }

siprix_voip_sdk/lib/accounts_model.dart

@@ -269,7 +269,9 @@ enum UpgradeToVideoMode {
   /// Accept video from remote side, don't send (mute) local
   RecvOnly(SiprixVoipSdk.kUpgradeToVideoRecvOnly, "RecvOnly"),
   /// Don't accept video from remote side (continue audio only call)
-  Inactive(SiprixVoipSdk.kUpgradeToVideoInactive, "Inactive");
+  Inactive(SiprixVoipSdk.kUpgradeToVideoInactive, "Inactive"),
+  /// Trigger event 'OnCallVideoUpgradeRequested', ask user confirmation and invoke 'AcceptVideoUpgrade(true/false)'
+  Manual(SiprixVoipSdk.kUpgradeToVideoManual, "Manual");
 
   const UpgradeToVideoMode(this.id, this.name);
   /// Value
@@ -282,6 +284,7 @@ enum UpgradeToVideoMode {
     switch(val) {
       case SiprixVoipSdk.kUpgradeToVideoSendRecv: return UpgradeToVideoMode.SendRecv;
       case SiprixVoipSdk.kUpgradeToVideoInactive: return UpgradeToVideoMode.Inactive;
+      case SiprixVoipSdk.kUpgradeToVideoManual  : return UpgradeToVideoMode.Manual;
       default:                                    return UpgradeToVideoMode.RecvOnly;
     }
   }

siprix_voip_sdk/lib/calls_model.dart

@@ -178,6 +178,7 @@ class CallModel extends ChangeNotifier {
   bool _isMicMuted=false;
   bool _isCamMuted=false;
   bool _isRecStarted=false;
+  bool _isUpgradingToVideo=false;
   final ILogsModel? _logs;
 
   /// State of this call
@@ -205,6 +206,7 @@ class CallModel extends ChangeNotifier {
   bool get isMicMuted => _isMicMuted;
   bool get isCamMuted => _isCamMuted;
   bool get isRecStarted => _isRecStarted;
+  bool get isUpgradingToVideo => _isUpgradingToVideo;
   bool get isFilePlaying => _playerId!=0;
   bool get hasVideo   => _hasVideo;
   int  get playerId   => _playerId;
@@ -419,7 +421,7 @@ class CallModel extends ChangeNotifier {
 
     try{
       await SiprixVoipSdk().upgradeToVideo(myCallId);
-      _hasVideo = true;
+      _isUpgradingToVideo = true;
       notifyListeners();
     } on PlatformException catch (err) {
       _logs?.print('Can\'t upgrade callId:$myCallId Err: ${err.code} ${err.message}');
@@ -470,8 +472,11 @@ class CallModel extends ChangeNotifier {
 
   /// Handle upgrade to video
   void onVideoUpgraded(bool withVideo, bool isUpgradeModeRecvOnly) {
+    //Siprix mutes camera when upgrade video request received from remote side AND mode set as recvOnly
+    if(withVideo && isUpgradeModeRecvOnly && !_isUpgradingToVideo) _isCamMuted = true;
+
     _hasVideo = withVideo;
-    if(isUpgradeModeRecvOnly) _isCamMuted = true;
+    _isUpgradingToVideo = false;
     notifyListeners();
   }
 
@@ -514,7 +519,9 @@ class CallModel extends ChangeNotifier {
 typedef ResolveContactNameCallback = String Function(String phoneNumber);
 /// Callback function which is raised by model when call switched
 typedef CallSwitchedCallCallback = void Function(int callId);
-/// Callback function which is raised by model when new incomning call
+/// Callback function which is raised by model when upgrade to video requeste received
+typedef CallVideoUpgradeRequestedCallback = void Function(int callId);
+/// Callback function which is raised by model when new incoming call received
 typedef NewIncomingCallCallback = void Function();
 
 //--------------------------------------------------------------------------
@@ -542,7 +549,8 @@ class CallsModel extends ChangeNotifier {
       terminated : onTerminated,
       transferred : onTransferred,
       redirected : onRedirected,
-      videoUpgraded: onVideoUpgraded,
+      videoUpgraded : onVideoUpgraded,
+      videoUpgradeRequested : onVideoUpgradeRequested,
       dtmfReceived : onDtmfReceived,
       switched : onSwitched,
       held : onHeld
@@ -553,8 +561,10 @@ class CallsModel extends ChangeNotifier {
   ResolveContactNameCallback? onResolveContactName;
   /// Callback function which is raised by model when call switched
   CallSwitchedCallCallback? onSwitchedCall;
-  /// Callback function which is raised by model when new incomning call received
+  /// Callback function which is raised by model when new incoming call received
   NewIncomingCallCallback? onNewIncomingCall;
+  /// Callback function which is raised by model when video upgrade request received
+  CallVideoUpgradeRequestedCallback? onVideoUpgradeRequestReceived;
 
   /// Returns true when list of calls is empty
   bool get isEmpty => _callItems.isEmpty;
@@ -773,6 +783,12 @@ class CallsModel extends ChangeNotifier {
     _callItems[index].onVideoUpgraded(withVideo, isUpgradeModeRecvOnly);
   }
 
+  /// Handle upgrade to video request
+  void onVideoUpgradeRequested(int callId) {
+    _logs?.print('onVideoUpgradeRequested callId:$callId');
+    onVideoUpgradeRequestReceived?.call(callId);
+  }
+
   /// Handle receive DTMF event raised by library and route it to matched call instance
   void onDtmfReceived(int callId, int tone) {
     _logs?.print('onDtmfReceived callId:$callId tone:$tone');
@@ -804,7 +820,7 @@ class CallsModel extends ChangeNotifier {
   /// Handle call switched event raised by library
   void onPlayerStateChanged(int playerId, PlayerState state) {
     _logs?.print('onPlayerStateChanged playerId:$playerId $state');
-    for(final call in _callItems) 
+    for(final call in _callItems)
       if(call.onPlayerStateChanged(playerId, state)) break;
   }
 

siprix_voip_sdk/lib/siprix_voip_sdk.dart

@@ -221,6 +221,17 @@ class CallVideoUpgradedArg {
   }
 }
 
+/// Helper class for handling 'onCallVideoUpgradeRequested' event raised by library
+class CallVideoUpgradeRequestedArg {
+  int callId=0;
+  bool fromMap(Map<dynamic, dynamic> argsMap) {
+    int argsCounter=0;
+    argsMap.forEach((key, value) {
+      if((key == SiprixVoipSdkPlatform.kArgCallId)&&(value is int))     { callId = value; argsCounter+=1; }
+    });
+    return (argsCounter==1);
+  }
+}
 
 /// Helper class for handling 'onCallRedirected' event raised by library
 class CallRedirectedArg {
@@ -388,8 +399,8 @@ class NetStateListener {
 class CallStateListener {
   CallStateListener({this.proceeding, this.incoming, this.incomingPush, this.acceptNotif,
     this.connected, this.terminated, this.dtmfReceived,
-    this.transferred, this.redirected, this.videoUpgraded, this.held, this.switched,
-    this.playerStateChanged});
+    this.transferred, this.redirected, this.videoUpgraded, this.videoUpgradeRequested, 
+    this.held, this.switched, this.playerStateChanged});
 
   ///Triggered by library when changed player state in specific call
   void Function(int playerId, PlayerState s)? playerStateChanged;
@@ -411,6 +422,8 @@ class CallStateListener {
   void Function(int origCallId, int relatedCallId, String referTo)? redirected;
   ///Triggered by library when remote side requested to start send/receive video and request accepted.
   void Function(int callId, bool withVideo)? videoUpgraded;
+  ///Triggered by library when remote side requested to start send/receive video
+  void Function(int callId)? videoUpgradeRequested;
   ///Triggered by library when received DTMF tone from remote side.
   void Function(int callId, int tone)? dtmfReceived;
   ///Triggered by library when local or remote side has put call on hold
@@ -545,6 +558,7 @@ class SiprixVoipSdk {
   static const int kUpgradeToVideoSendRecv = 0;
   static const int kUpgradeToVideoRecvOnly = 1;
   static const int kUpgradeToVideoInactive = 2;
+  static const int kUpgradeToVideoManual   = 3;
 
   ///Error codes constants
   static const int eOK = 0;
@@ -749,6 +763,11 @@ class SiprixVoipSdk {
     return _platform.upgradeToVideo(callId);
   }
 
+  /// Accept requested upgrade of the call's media and specify is allowed to use video
+  Future<void> acceptVideoUpgrade(int callId, bool withVideo) async {
+    return _platform.acceptVideoUpgrade(callId, withVideo);
+  }
+
   /// Stop playing (mute) ringtone.
   Future<void> stopRingtone() async {
     return _platform.stopRingtone();
@@ -900,6 +919,12 @@ class SiprixVoipSdk {
     return _platform.getCallKitCallUUID(sip_callId);
   }
 
+  ///End CallKit call specified by its UUID (Allowed to use only when missed SIP signalling for that call)
+  Future<void>? endCallKitCall(String callkit_CallUUID) {
+    return _platform.endCallKitCall(callkit_CallUUID);
+  }
+
+
   //-//////////////////////////////////////////////////////////////////////////////////////
   //-Android specific implementation
 
@@ -944,6 +969,7 @@ class SiprixVoipSdk {
       case SiprixVoipSdkPlatform.kOnCallTransferred  : _onCallTransferred(argsMap);  break;
       case SiprixVoipSdkPlatform.kOnCallRedirected   : _onCallRedirected(argsMap);   break;
       case SiprixVoipSdkPlatform.kOnCallVideoUpgraded: _onCallVideoUpgraded(argsMap); break;
+      case SiprixVoipSdkPlatform.kOnCallVideoUpgradeRequested: _onCallVideoUpgradeRequested(argsMap); break;
       case SiprixVoipSdkPlatform.kOnCallSwitched     : _onCallSwitched(argsMap);     break;
       case SiprixVoipSdkPlatform.kOnCallHeld         : _onCallHeld(argsMap);         break;
 
@@ -1039,6 +1065,13 @@ class SiprixVoipSdk {
     }
   }
 
+  void _onCallVideoUpgradeRequested(Map<dynamic, dynamic> argsMap) {
+    CallVideoUpgradeRequestedArg arg = CallVideoUpgradeRequestedArg();
+    if(arg.fromMap(argsMap)) {
+      callListener?.videoUpgradeRequested?.call(arg.callId);
+    }
+  }
+
   void _onCallRedirected(Map<dynamic, dynamic> argsMap) {
     CallRedirectedArg arg = CallRedirectedArg();
     if(arg.fromMap(argsMap)) {

siprix_voip_sdk/pubspec.yaml

@@ -3,7 +3,7 @@ description: Siprix VoIP SDK plugin for embedding voice-over-IP (VoIP) audio/vid
 homepage: https://siprix-voip.com
 repository: https://github.com/siprix/FlutterPluginFederated/tree/main/siprix_voip_sdk
 documentation: https://docs.siprix-voip.com
-version: 1.0.30
+version: 1.0.31
 
 environment:
   sdk: ^3.2.0
@@ -27,12 +27,12 @@ dependencies:
   flutter:
     sdk: flutter
   intl: ^0.20.1
-  siprix_voip_sdk_android: ^1.0.23
-  siprix_voip_sdk_ios: ^1.0.27
-  siprix_voip_sdk_linux: ^1.0.17
-  siprix_voip_sdk_macos: ^1.0.17
-  siprix_voip_sdk_windows: ^1.0.18
-  siprix_voip_sdk_platform_interface: ^1.0.9
+  siprix_voip_sdk_android: ^1.0.24
+  siprix_voip_sdk_ios: ^1.0.28
+  siprix_voip_sdk_linux: ^1.0.18
+  siprix_voip_sdk_macos: ^1.0.18
+  siprix_voip_sdk_windows: ^1.0.19
+  siprix_voip_sdk_platform_interface: ^1.0.10
 
 dev_dependencies:
   flutter_test: