Platform-Specific Troubleshooting
This guide addresses common issues specific to different platforms when using the social.plus Video SDK. Each platform has unique characteristics and potential problems that require targeted solutions.iOS Troubleshooting
Camera and Microphone Issues
Issue: Camera Permission Denied
Issue: Audio Session Conflicts
Background Streaming Issues
Issue: Stream Stops in Background
- Enable Background App Refresh in iOS Settings
- Configure background modes in Info.plist:
- Implement background task handling:
Memory Management Issues
Issue: Memory Warnings and Crashes
Android Troubleshooting
Permission Management
Issue: Runtime Permissions Not Granted
Camera2 API Issues
Issue: Camera Initialization Fails
Network Configuration Issues
Issue: Network Security Policy Blocks Connections
- Configure network security in
res/xml/network_security_config.xml:
- Reference in AndroidManifest.xml:
Background Service Issues
Issue: Service Killed by System
Web Browser Troubleshooting
WebRTC Issues
Issue: WebRTC Not Supported
HTTPS Requirements
Issue: getUserMedia Requires HTTPS
- Use HTTPS in production
- For development, use localhost or configure browser flags
- Alternative for testing:
Cross-Origin Issues
Issue: CORS Blocking Requests
Browser-Specific Issues
Safari Issues
Firefox Issues
React Native Troubleshooting
Metro Bundler Issues
Issue: Module Resolution Fails
- Clear Metro cache:
- Configure Metro bundler in
metro.config.js:
Native Module Linking Issues
Issue: Native Modules Not Found
- For React Native >= 0.60 (auto-linking):
- For older versions:
- Manual linking if needed:
Platform-Specific Code Issues
Issue: Platform-Specific Code Not Working
Flutter Troubleshooting
Plugin Registration Issues
Issue: Plugin Not Registered
- Run
flutter cleanandflutter pub get - For iOS, run
cd ios && pod install - Ensure plugin is properly registered:
Platform Channel Issues
Issue: Platform Channel Communication Fails
Widget State Management
Issue: Widget Disposed During Async Operation
Universal Troubleshooting Tips
Debug Mode Setup
Performance Monitoring
Next Steps
- Troubleshooting Overview - General troubleshooting guide
- Notifications Troubleshooting - Push notification issues
- Events Troubleshooting - Real-time event problems
- Platform-Specific Guides - Detailed implementation guides
Getting Platform-Specific Help
For platform-specific issues:- iOS: Check Xcode console for detailed error messages
- Android: Use Android Studio’s Logcat for debugging
- Web: Use browser developer tools and console
- React Native: Use React Native debugger and platform logs
- Flutter: Use Flutter inspector and platform channels debugging