🚀 Flutter WebRTC Fixed v0.12.0

🎯 Production-Ready WebRTC Plugin for Flutter

Cross-platform real-time communication with enhanced stability and performance

✨ What's New

🎉 This is a fixed and improved version of the original flutter_webrtc package with:

🔧 Enhanced Stability - Additional bug fixes and optimizations
🚀 Production Ready - Tested and optimized for production use
📱 Cross-Platform - iOS, Android, Web, macOS, Windows, Linux support
🛠️ Easy Integration - Simple API with comprehensive documentation

Sponsored with 💖 by

Enterprise Grade APIs for Feeds, Chat, & Video. Try the Flutter Video tutorial 💬

LiveKit - Open source WebRTC infrastructure

📦 Installation

🎯 Quick Start (Recommended)

Add this to your package's pubspec.yaml file:

dependencies:
  flutter_webrtc_fixed_v0_12_0: ^0.12.0

Then run:

flutter pub get

🔗 Alternative Installation Methods

📥 From GitHub Repository

dependencies:
  flutter_webrtc_fixed_v0_12_0:
    git:
      url: https://github.com/boughdiri-dorsaf/flutter_webrtc_fixed_v0.12.0.git
      ref: main

📁 From Local Path

dependencies:
  flutter_webrtc_fixed_v0_12_0:
    path: ./flutter_webrtc_fixed_v0_12_0

🚀 Features

🌟 Core Capabilities

🎯 Feature	🤖 Android	🍎 iOS	🌐 Web	💻 macOS	🪟 Windows	🐧 Linux	📱 Embedded
🎥 Audio/Video	✅	✅	✅	✅	✅	✅	✅
📡 Data Channel	✅	✅	✅	✅	✅	✅	✅
📺 Screen Capture	✅	✅*	✅	✅	✅	✅	✅
🔄 Unified-Plan	✅	✅	✅	✅	✅	✅	✅
📊 Simulcast	✅	✅	✅	✅	✅	✅	✅
🎬 MediaRecorder	⚠️	⚠️	✅	❌	❌	❌	❌
🔐 End-to-End Encryption	✅	✅	✅	✅	✅	✅	✅
🔌 Insertable Streams	❌	❌	❌	❌	❌	❌	❌

_{iOS Screen Sharing requires additional setup - See Guide}

🎨 Key Highlights

🎯 Cross-Platform Support - Works seamlessly across all major platforms
🔧 Production Ready - Battle-tested in real-world applications
🚀 High Performance - Optimized for low latency and high quality
🛡️ Secure - Built-in encryption and security features
📱 Mobile First - Designed with mobile devices in mind
🌐 Web Compatible - Full support for Flutter Web with WASM compatibility
📦 Swift Package Manager - Native iOS/macOS support via SPM
⚡ Modern Web - WASM-compatible for better performance

Additional platform/OS support from the other community

flutter-tizen: https://github.com/flutter-tizen/plugins/tree/master/packages/flutter_webrtc
flutter-elinux(WIP): https://github.com/sony/flutter-elinux-plugins/issues/7

🛠️ Setup

📱 iOS Setup

🔧 Required Permissions

Add the following entries to your Info.plist file, located in <project root>/ios/Runner/Info.plist:

<key>NSCameraUsageDescription</key>
<string>$(PRODUCT_NAME) Camera Usage!</string>
<key>NSMicrophoneUsageDescription</key>
<string>$(PRODUCT_NAME) Microphone Usage!</string>

This allows your app to access camera and microphone.

⚠️ Important iOS Configuration

The WebRTC.xframework compiled after the m104 release no longer supports iOS arm devices. Add this to your ios/Podfile:

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)
    target.build_configurations.each do |config|
      # Workaround for https://github.com/flutter/flutter/issues/64502
      config.build_settings['ONLY_ACTIVE_ARCH'] = 'YES' # <= this line
    end
  end
end

🤖 Android Setup

🔧 Required Permissions

Add these permissions to your AndroidManifest.xml file:

<uses-feature android:name="android.hardware.camera" />
<uses-feature android:name="android.hardware.camera.autofocus" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />

🎧 Bluetooth Support (Optional)

For Bluetooth device support, add these permissions:

<uses-permission android:name="android.permission.BLUETOOTH" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" android:maxSdkVersion="30" />

⚙️ Java 8 Configuration

Add this to your app-level build.gradle:

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

🔧 Usage

🚀 Quick Start

📡 Basic WebRTC Setup

import 'package:flutter_webrtc_fixed_v0_12_0/flutter_webrtc_fixed_v0_12_0.dart';

// Create RTCPeerConnection
final configuration = {
  'iceServers': [
    {'urls': 'stun:stun.l.google.com:19302'},
  ]
};

RTCPeerConnection pc = await createPeerConnection(configuration);

// Add local stream
MediaStream localStream = await navigator.mediaDevices.getUserMedia({
  'audio': true,
  'video': true
});

localStream.getTracks().forEach((track) {
  pc.addTrack(track, localStream);
});

📱 Complete Example App

Check out the complete example app that demonstrates:

Video capture and rendering
Peer connection management
Audio/video controls
Cross-platform compatibility

To run the example:

cd example
flutter pub get
flutter run

🎥 Video Rendering

RTCVideoRenderer localRenderer = RTCVideoRenderer();
RTCVideoRenderer remoteRenderer = RTCVideoRenderer();

@override
void initState() {
  super.initState();
  localRenderer.initialize();
  remoteRenderer.initialize();
}

@override
void dispose() {
  localRenderer.dispose();
  remoteRenderer.dispose();
  super.dispose();
}

// Set video stream
localRenderer.srcObject = localStream;
remoteRenderer.srcObject = remoteStream;

🌐 Web & WASM Support

⚡ WASM Compatibility

This package includes WASM-compatible implementations for better web performance:

Modern Web Standards: Uses latest web APIs
Better Performance: WASM provides faster execution
Future-Proof: Ready for upcoming web technologies
Automatic Fallback: Gracefully falls back to standard web implementation

📦 Swift Package Manager Support

Native iOS/macOS support via Swift Package Manager:

// Add to your Package.swift
dependencies: [
    .package(url: "https://github.com/boughdiri-dorsaf/flutter_webrtc_fixed_v0.12.0.git", from: "0.12.0")
]

Benefits:

Native Integration: Direct Swift/Objective-C integration
Better Performance: Optimized for iOS/macOS
Modern Tooling: Works with Xcode's modern build system
Dependency Management: Clean dependency resolution

📋 API Reference

🏗️ Core Classes

Class	Description
`RTCPeerConnection`	WebRTC peer connection management
`MediaStream`	Audio/video stream handling
`RTCVideoRenderer`	Video rendering widget
`RTCDataChannel`	Data channel for messaging

🔧 Key Methods

Method	Description
`createPeerConnection(configuration)`	Create peer connection
`getUserMedia(constraints)`	Get media stream
`addTrack(track, stream)`	Add media track
`createOffer()` / `createAnswer()`	Create SDP offer/answer
`setLocalDescription(description)`	Set local SDP
`setRemoteDescription(description)`	Set remote SDP

🚨 Troubleshooting

🔍 Common Issues

📷 Camera Permission Issues

Ensure camera permissions are properly set in platform-specific files
Check Info.plist (iOS) and AndroidManifest.xml (Android)
Verify runtime permission requests

🎤 Audio Issues

Check microphone permissions and audio settings
Verify audio device selection
Test with different audio configurations

🌐 Network Issues

Verify STUN/TURN server configuration
Check firewall and NAT settings
Test with different network conditions

🍎 iOS Build Issues

Ensure ONLY_ACTIVE_ARCH is set to 'YES' in Podfile
Check Xcode version compatibility
Verify iOS deployment target

🐛 Debug Information

// Check peer connection state
pc.onConnectionState = (RTCPeerConnectionState state) {
  print('Connection state: $state');
};

// Check ICE connection state
pc.onIceConnectionState = (RTCIceConnectionState state) {
  print('ICE connection state: $state');
};

🤝 Contributing

We welcome contributions! Here's how you can help:

🍴 Fork the repository
🌿 Create a feature branch (git checkout -b feature/amazing-feature)
✏️ Make your changes
🧪 Test thoroughly
📤 Submit a pull request

📋 Contribution Guidelines

Follow the existing code style
Add tests for new features
Update documentation as needed
Ensure all tests pass

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

📞 Support

🆘 Need Help?

🐛 Report Issues: GitHub Issues
📖 Documentation: Check the troubleshooting section above
🔍 API Reference: Review the comprehensive API documentation
💡 This is a fixed version of the original flutter_webrtc package

🌟 Show Your Support

If this package helped you, please give it a ⭐ on GitHub!

🔄 Updates

This package is maintained and updated regularly. Check the CHANGELOG.md for version history and updates.

🎯 Ready to build amazing real-time communication apps?

This version is optimized for production use and includes all necessary fixes and improvements.