How google/exoplayer works
ExoPlayer is an Android media playback and processing library, with downloadable media and adapters for alternate transports, codecs, ads, sessions, and remote playback. The principal workflow is an application controlling a player that loads a media source, extracts and decodes samples, and renders audio/video; transformation is a separate export workflow. The tree and index establish these product areas, but sampled source does not show the central player/source wiring, so those relationships are marked unverified rather than asserted. The README only documents project deprecation and migration to Media3.
Main entry points: Player.java Player API · source Media sources · exoplayer2 Playback engine · SamplePipeline.java Export sample base
Components 27
Playback core
- Player API
library/common/src/main/java/com/google/android/exoplayer2/Player.java - Media types
library/common/src/main/java/com/google/android/exoplayer2 - Playback engine
library/core/src/main/java/com/google/android/exoplayer2 - Media sources
library/core/src/main/java/com/google/android/exoplayer2/source - Stream formats
library/dash/src/main/java/com/google/android/exoplayer2/source/dash - Container extractors
library/extractor/src/main/java/com/google/android/exoplayer2/extractor - Decoder framework
library/decoder/src/main/java/com/google/android/exoplayer2/decoder - Audio/video renderers
library/core/src/main/java/com/google/android/exoplayer2 - Data sources
library/datasource/src/main/java/com/google/android/exoplayer2/upstream
Media processing
- Audio processing
library/common/src/main/java/com/google/android/exoplayer2/audio/AudioProcessingPipeline.java - Video effects
library/effect/src/main/java/com/google/android/exoplayer2/effect/ExternalTextureManager.java - Audio export pipeline
library/transformer/src/main/java/com/google/android/exoplayer2/transformer/AudioSamplePipeline.java - Video export pipeline
library/transformer/src/main/java/com/google/android/exoplayer2/transformer/VideoSamplePipeline.java - Export sample base
library/transformer/src/main/java/com/google/android/exoplayer2/transformer/SamplePipeline.java - Output muxer
library/transformer/src/main/java/com/google/android/exoplayer2/transformer/MuxerWrapper.java - Export errors
library/transformer/src/main/java/com/google/android/exoplayer2/transformer/ExportException.java
Offline media
- Download service
library/core/src/main/java/com/google/android/exoplayer2/offline/DownloadService.java - Download manager
library/core/src/main/java/com/google/android/exoplayer2/offline/DownloadManager.java - Download database
library/database/src/main/java/com/google/android/exoplayer2/database/DefaultDatabaseProvider.java
Playback integrations
- Player UI
library/ui/src/main/java/com/google/android/exoplayer2/ui/PlayerNotificationManager.java - Media sessions
extensions/mediasession/src/main/java/com/google/android/exoplayer2/ext/mediasession/MediaSessionConnector.java - Ad insertion
extensions/ima/src/main/java/com/google/android/exoplayer2/ext/ima/ImaAdsLoader.java - Cast playback
extensions/cast/src/main/java/com/google/android/exoplayer2/ext/cast/CastPlayer.java
Optional extensions
- Network adapters
extensions/cronet/src/main/java/com/google/android/exoplayer2/ext/cronet/CronetDataSource.java - Codec extensions
extensions/av1/src/main/java/com/google/android/exoplayer2/ext/av1/Libgav1VideoRenderer.java - Other extensions
extensions
Other components
- Application
Connections 26
- Application → Player API: controls
- Player API → Playback engine: delegates to
library/core/src/main/java/com/google/android/exoplayer2/AudioFocusManager.java - Playback engine → Media sources: requests media
library/core/src/main/java/com/google/android/exoplayer2/analytics/DefaultPlaybackSessionManager.java - Media sources → Stream formats: loads streams
library/dash/src/main/java/com/google/android/exoplayer2/source/dash/PlayerEmsgHandler.java - Media sources → Container extractors: parses samples
- Media sources → Data sources: reads media
- Playback engine → Decoder framework: decodes samples
- Playback engine → Audio/video renderers: dispatches tracks
- Media types → Player API: defines contracts
library/common/src/main/java/com/google/android/exoplayer2/util/Util.java - Player API → Player UI: controls
library/ui/src/main/java/com/google/android/exoplayer2/ui/PlayerNotificationManager.java - Player API → Media sessions: controls
- Player API → Cast playback: remote playback
- Media sources → Ad insertion: inserts ads
- Download service → Download manager: manages downloads
library/core/src/main/java/com/google/android/exoplayer2/offline/DownloadService.java - Download manager → Download database: persists state
- Audio export pipeline → Export sample base: extends
library/transformer/src/main/java/com/google/android/exoplayer2/transformer/AudioSamplePipeline.java - Video export pipeline → Export sample base: extends
library/transformer/src/main/java/com/google/android/exoplayer2/transformer/VideoSamplePipeline.java - Audio export pipeline → Audio processing: processes audio
library/transformer/src/main/java/com/google/android/exoplayer2/transformer/AudioSamplePipeline.java - Video export pipeline → Video effects: processes frames
library/transformer/src/main/java/com/google/android/exoplayer2/transformer/VideoSamplePipeline.java - Export sample base → Output muxer: writes output
library/transformer/src/main/java/com/google/android/exoplayer2/transformer/SamplePipeline.java - Audio export pipeline → Output muxer: writes output
library/transformer/src/main/java/com/google/android/exoplayer2/transformer/AudioSamplePipeline.java - Video export pipeline → Output muxer: writes output
library/transformer/src/main/java/com/google/android/exoplayer2/transformer/VideoSamplePipeline.java - Export sample base → Export errors: reports failures
library/transformer/src/main/java/com/google/android/exoplayer2/transformer/SamplePipeline.java - Network adapters → Data sources: supplies transport
- Codec extensions → Audio/video renderers: adds codecs
- Other extensions → Playback engine: extends playback
extensions/workmanager/src/main/java/com/google/android/exoplayer2/ext/workmanager/WorkManagerScheduler.java