CarGuo/GSYVideoPlayer
GSYVideoPlayer
GSYVideoPlayer is a versatile video player framework for Android that acts as a multi-engine playback wrapper. It provides a unified playback interface to control different video playback kernels, such as ExoPlayer, IJKplayer, and MediaPlayer, ensuring compatibility across diverse mobile hardware.
The framework distinguishes itself through a flexible architecture that allows for core component swapping, enabling the replacement of playback engines, managers, or rendering layers. It includes a dedicated video caching manager for local storage and a customizable media UI component that supports specialized features like bullet chat and external subtitle management.
The project covers a wide range of capabilities, including adaptive bitrate streaming, graphic surface effects for filters and watermarks, and advanced playback controls such as picture-in-picture mode and screen orientation management. It also provides optimizations for playback within scrollable lists and integration for Jetpack Compose.
The framework includes tools for network traffic management, such as custom request headers and proxy configuration, alongside utilities for video frame capture and advertisement management.
Features
- Unified Playback Engines - Provides a single unified interface to control multiple different playback kernels across diverse mobile devices.
- Playback Frameworks - Provides a comprehensive playback framework for Android with support for multiple kernels and media formats.
- Video Content Caching - Implements a local storage system for streaming media that enables play-while-cache functionality.
- Android Media Rendering Frameworks - Ships a graphic surface layer for applying video filters, watermarks, and screen orientation adaptations.
- Offline Caching - Stores video data locally using proxy or engine-specific managers to enable offline playback.
- Multi-Codec Support - Decodes and renders a wide variety of audio and video codecs to ensure broad hardware compatibility.
- Media Playback UI Components - Provides a customizable user interface for video playback featuring bullet chat, subtitles, and gesture controls.
- Android Media Frameworks - Acts as a versatile media playback wrapper for Android unifying ExoPlayer, IJKplayer, and MediaPlayer.
- Media Proxy Caching - Uses a local proxy server to intercept network traffic and store video data for offline playback.
- Playback Kernel Abstractions - Wraps diverse playback kernels in a common interface to standardize control across different media engines.
- Playback Engine Adapters - Implements an adapter-based architecture to allow swapping playback engines like ExoPlayer and IJKplayer.
- Custom Video Player UIs - Provides a customizable video interface featuring bullet chat, external subtitles, and gesture-based controls.
- Engine Component Swapping - Allows replacing the playback engine, manager, or rendering layer by implementing predefined interfaces.
- Adaptive Bitrate Optimization - Balances visual quality and bandwidth by switching between adaptive bitrate levels or manual quality tracks.
- Jetpack Compose Video Embeds - Embeds video playback into declarative Jetpack Compose screens using wrappers for legacy views.
- Media Text Overlays - Renders synchronized text elements such as subtitles and bullet chats as an overlay on the video surface.
- Subtitle Management Systems - Parses and displays external subtitle files in various formats as a user interface overlay.
- Media Engine Tuning - Allows adjustment of buffer sizes, decoding methods, and frame dropping to optimize performance.
- Audio Focus Management - Manages how video playback reacts when other system sounds or applications request audio priority.
- Playback Speed Controllers - Enables real-time changes to the video playback rate while maintaining a consistent audio pitch.
- Overlay Rendering Engines - Implements a system for rendering scrolling text overlays (bullet chat) on top of the video content.
- Adaptive Streaming Players - Supports adaptive bitrate streaming for formats like HLS and DASH to adjust resolutions dynamically.
- Streaming Optimizations - Improves streaming performance using local caching, adaptive bitrate switching, and scrollable list optimizations.
- Surface Effect Rendering - Applies filters, watermarks, and visual effects by manipulating the graphic surface view used for video output.
- Video Rendering Effects - Provides real-time visual filters, watermarks, and frame captures using a graphic surface.
- List Scrolling Optimizations - Prevents lag in scrolling lists using lazy initialization and optimized transitions for embedded players.
- Adaptive Bitrate Controllers - Provides mechanisms to dynamically adjust video resolution and bitrate based on network conditions.
- Video Surface Visual Effects - Renders video filters, watermarks, image masks, and blurred backgrounds using a graphic surface view.
- Video Aspect Ratio Configurations - Provides multiple options for video rendering aspect ratios, such as crop-to-fill and stretch-to-fill.
- Interface Layout Customization - Allows developers to override layout identifiers, initialization methods, and touch gestures for custom UI behavior.
- Picture-in-Picture Interfaces - Provides the capability to transition the video player into a small, floating picture-in-picture window.
- Playback Controllers - Provides APIs for programmatically setting specific timestamps or seeking to precise frames in a video.
- List Playback Optimization - Handles playback within scrollable lists by automatically releasing players when items scroll out of view.
- Complex Playback Workflows - Manages complex workflows including pre-roll ads, picture-in-picture mode, and synchronized state transitions.
- Playback State Synchronizations - Provides logic to maintain consistent playback parameters when transitioning between embedded and fullscreen display modes.
- Screen Orientation Management - Manages automatic and manual rotation between portrait and landscape modes, including notch-screen adaptations.
- Playback State Transitions - Maintains consistent playback parameters and logic when switching between embedded and fullscreen modes.
