Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/brianwernick/ExoMedia
An Android ExoPlayer wrapper to simplify Audio and Video implementations
https://github.com/brianwernick/ExoMedia
android android-mediaplayer audioplayer exoplayer mediaplayer videoview
Last synced: 3 months ago
JSON representation
An Android ExoPlayer wrapper to simplify Audio and Video implementations
- Host: GitHub
- URL: https://github.com/brianwernick/ExoMedia
- Owner: brianwernick
- License: apache-2.0
- Created: 2015-03-14T19:52:36.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2023-12-02T17:01:24.000Z (12 months ago)
- Last Synced: 2024-07-27T11:38:47.340Z (4 months ago)
- Topics: android, android-mediaplayer, audioplayer, exoplayer, mediaplayer, videoview
- Language: Kotlin
- Size: 3.01 MB
- Stars: 2,130
- Watchers: 81
- Forks: 378
- Open Issues: 21
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
ExoMedia
============
ExoMedia is an audio/video playback library for Android built on top of the ExoPlayer
with straightforward APIs and integrations. This library focuses on quick setup, handling
common audio and video playback needs while also providing extensibility for more custom
use cases.
ExoMedia vs ExoPlayer
------
The [ExoPlayer][ExoPlayer] is an advanced media player for Android that is highly customizable,
however that comes at the cost of a more complex setup and configuration process. This customizability
is great when it's needed however can be daunting when you need to play a simple audio or video file.
ExoMedia is a more high-level abstraction of media playback that abstracts some of the customizability
provided by the [ExoPlayer][ExoPlayer] into simple functions and callbacks, keeping the required
configuration to a minimum.
Use
-------
The latest version can be found at [Maven Central][MavenCentral].
```gradle
repositories {
mavenCentral()
}
dependencies {
implementation 'com.devbrackets.android:exomedia:5.1.0'
}
```
Quick Start
-------
The ExoMedia VideoView can be added in your layout files like any other Android view.
```xml
```
While in your Activity or Fragment you treat it like a standard Android VideoView
```kotlin
private lateinit var videoView: VideoView
private fun setupVideoView() {
// Make sure to use the correct VideoView import
videoView = findViewById(R.id.video_view) as VideoView
videoView.setOnPreparedListener(this)
// For now we just picked an arbitrary item to play
videoView.setMedia(Uri.parse("https://www.devbrackets.com/media/samples/video/big_buck_bunny.mp4"))
}
@Override
fun onPrepared() {
//Starts the video playback as soon as it is ready
videoView.start()
}
```
License
-------
Copyright 2015-2023 ExoMedia Contributors
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Attribution
-----------
* Uses [Kotlin](https://kotlinlang.org/) licensed under [Apache 2.0][Apache 2.0]
* Uses [AndroidX Media3](https://developer.android.com/jetpack/androidx/releases/media3) licensed under [Apache 2.0][Apache 2.0]
* Uses [ConstraintLayout](https://developer.android.com/training/constraint-layout) licensed under [Apache 2.0][Apache 2.0]
* Uses [AndroidX AppCompat](https://developer.android.com/jetpack/androidx/releases/appcompat) licensed under [Apache 2.0][Apache 2.0]
* Uses [Material Design icons][Design Icons] licensed under [Apache 2.0][Apache 2.0]
[Apache 2.0]: http://www.apache.org/licenses/LICENSE-2.0
[CTS]: https://source.android.com/compatibility/cts/index.html
[Design Icons]: https://github.com/google/material-design-icons
[ExoPlayer]: https://github.com/androidx/media
[MavenCentral]: https://search.maven.org/artifact/com.devbrackets.android/exomedia