https://github.com/siprix/flutterpluginfederated
Siprix VoIP SDK federated plugin for embedding voice/video calls based on SIP/RTP protocols into Flutter applications.
https://github.com/siprix/flutterpluginfederated
Last synced: 7 months ago
JSON representation
Siprix VoIP SDK federated plugin for embedding voice/video calls based on SIP/RTP protocols into Flutter applications.
- Host: GitHub
- URL: https://github.com/siprix/flutterpluginfederated
- Owner: siprix
- License: mit
- Created: 2024-11-28T19:29:19.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-09T00:40:40.000Z (over 1 year ago)
- Last Synced: 2025-02-09T01:27:45.108Z (over 1 year ago)
- Language: C++
- Size: 186 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# siprix_voip_sdk
Siprix VoIP SDK plugin for embedding voice and video communication (based on SIP/RTP protocols) into Flutter applications.
It contains native SIP client implementations for 5 platforms: Android, iOS, MacOS, Windows, Linux and unified API for all them.
Plugin implements ready to use SIP VoIP Client with ability to:
- Add multiple SIP accounts
- Send/receive multiple calls (Audio and Video)
- Manage calls with: hold, mute microphone/camera, play sound to call from file, send/receive DTMF,...
- Join calls to conference, blind and attended transfer
- Secure SIP signaling (using TLS) and call media (using SRTP)
- Detect network changes and automatically update registration/switch and restore call(s) media
- Echo cancelation and noise suppression
- Create BLF/Presence subscriptions and monitor state of remote extension(s)
- Send/receive text messages
- Ready to use models for fast and easy UI creating
- Embedded CallKit/PushKit support in iOS version of plugin
## Usage
### Add dependency in pubspec.yaml
```
dependencies:
siprix_voip_sdk: ^1.0.11
provider: ^6.1.1
```
### Add imports
```
import 'package:provider/provider.dart';
import 'package:siprix_voip_sdk/accounts_model.dart';
import 'package:siprix_voip_sdk/network_model.dart';
import 'package:siprix_voip_sdk/calls_model.dart';
import 'package:siprix_voip_sdk/cdrs_model.dart';
import 'package:siprix_voip_sdk/devices_model.dart';
import 'package:siprix_voip_sdk/logs_model.dart';
import 'package:siprix_voip_sdk/siprix_voip_sdk.dart';
```
### Prepare models
```dart
void main() async {
AccountsModel accountsModel = AccountsModel();
CallsModel callsModel = CallsModel(accountsModel);
runApp(
MultiProvider(providers:[
ChangeNotifierProvider(create: (context) => accountsModel),
ChangeNotifierProvider(create: (context) => callsModel),
],
child: const MyApp(),
));
}
```
### Init SDK
```dart
class _MyAppState extends State {
@override
void initState() {
super.initState();
_initializeSiprix();
}
void _initializeSiprix([LogsModel? logsModel]) async {
InitData iniData = InitData();
iniData.license = "...license-credentials...";
iniData.logLevelFile = LogLevel.info;
SiprixVoipSdk().initialize(iniData, logsModel);
}
```
### Build UI, add accounts/calls
```dart
Widget buildBody() {
final accounts = context.watch();
final calls = context.watch();
return Column(children: [
ListView.separated(shrinkWrap: true,
itemCount: accounts.length,
separatorBuilder: (BuildContext context, int index) => const Divider(height: 1),
itemBuilder: (BuildContext context, int index) {
AccountModel acc = accounts[index];
return
ListTile(title: Text(acc.uri, style: Theme.of(context).textTheme.titleSmall),
subtitle: Text(acc.regText),
tileColor: Colors.blue
);
},
),
ElevatedButton(onPressed: _addAccount, child: const Icon(Icons.add_card)),
ElevatedButton(onPressed: _addCall, child: const Icon(Icons.add_call)),
...
}
void _addAccount() {
AccountModel account = AccountModel();
account.sipServer = "192.168.0.122";
account.sipExtension = "1016";
account.sipPassword = "12345";
account.expireTime = 300;
context.read().addAccount(account)
.catchError(showSnackBar);
}
void _addCall() {
final accounts = context.read();
if(accounts.selAccountId==null) return;
CallDestination dest = CallDestination("1012", accounts.selAccountId!, false);
context.read().invite(dest)
.catchError(showSnackBar);
}
```
[More detailed integration guide](https://docs.siprix-voip.com/rst/flutter.html#integration-into-flutter-application)
## How to use this library without provider?
Library doesn't have any limitations related to provider.
You can copy source code of existing models to your project and use as you need/want.
Also you can create own classes and directly invoke library's methods like:\
`int callId = await SiprixVoipSdk().invite(dest) ?? 0;`\
`int accId = await SiprixVoipSdk().addAccount(acc) ?? 0;`\
The same is true for listening events - add own class as listener which will handles events:\
`SiprixVoipSdk().accListener = MyAccStateListener(regStateChanged : onRegStateChanged);`
Use source code of existing models as implementation hint or ask support@siprix-voip.com in case of difficulties.
## Limitations
Siprix doesn't provide VoIP services, but in the same time doesn't have backend limitations and can connect to any SIP (Server) PBX or make direct calls between clients.
For testing app you need an account(s) credentials from a SIP service provider(s).
Some features may be not supported by all SIP providers.
Attached Siprix SDK works in trial mode and has limited call duration - it drops call after 60sec.
Upgrading to a paid license removes this restriction, enabling calls of any length.
Please contact [sales@siprix-voip.com](mailto:sales@siprix-voip.com) for more details.
## More resources
Product web site: [siprix-voip.com](https://siprix-voip.com)
Manual: [docs.siprix-voip.com](https://docs.siprix-voip.com)
## Screenshots
