Troubleshooting Overview
This guide provides solutions to common issues encountered when using the social.plus Video SDK. Whether you’re experiencing streaming problems, playback issues, or integration challenges, you’ll find help here.Quick Diagnostic Steps
1. Check SDK Version
Ensure you’re using the latest version of the social.plus Video SDK:2. Verify API Key
Confirm your API key is valid and has the correct permissions:3. Check Network Connectivity
Test your network connection and firewall settings:Common Issues and Solutions
Installation Issues
Issue: Package Installation Fails
Issue: TypeScript Declaration Files Missing
Authentication Issues
Issue: API Key Rejected
- Verify API key format and characters
- Check API key permissions in dashboard
- Ensure correct environment (production vs sandbox)
- Regenerate API key if compromised
Issue: Token Expired
Streaming Issues
Issue: Cannot Start Stream
- Check browser permissions
- Verify camera/microphone availability
- Test on different devices
Issue: Poor Stream Quality
- Check upload bandwidth
- Adjust stream settings
- Optimize encoding parameters
Playback Issues
Issue: Video Won’t Play
- Check stream availability
- Verify network connection
- Test different quality settings
Issue: Audio/Video Sync Issues
Platform-Specific Issues
Web Browser Issues
Issue: WebRTC Not SupportedMobile App Issues
Issue: iOS Background StreamingPerformance Optimization
Memory Management
Issue: Memory Leaks
Network Optimization
Issue: High Bandwidth Usage
Debugging Tools
Enable Debug Logging
Network Diagnostics
Performance Monitoring
Error Reporting
Automatic Error Reporting
Manual Error Reporting
Getting Help
Support Resources
- Documentation: Check our comprehensive docs
- GitHub Issues: Report bugs and feature requests
- Community Forum: Ask questions and share solutions
- Support Tickets: For urgent issues or enterprise support
Collecting Debug Information
When reporting issues, please include:- SDK version
- Platform information
- Browser/device details
- Network conditions
- Error logs
- Performance metrics
Next Steps
- Platform-Specific Troubleshooting - Platform-specific solutions
- Notifications Troubleshooting - Push notification issues
- Events Troubleshooting - Real-time event problems
- Core Concept References: Streaming Basics, Lifecycle Management, Permissions
Related Topics
- Core Concepts - Understanding the fundamentals
- Getting Started - Initial setup and configuration
- Platform-Specific Guides - Platform implementation details