96 lines
2.9 KiB
Markdown
96 lines
2.9 KiB
Markdown
# ExoPlayer #
|
||
|
||
ExoPlayer is an application level media player for Android. It provides an
|
||
alternative to Android’s MediaPlayer API for playing audio and video both
|
||
locally and over the Internet. ExoPlayer supports features not currently
|
||
supported by Android’s MediaPlayer API, including DASH and SmoothStreaming
|
||
adaptive playbacks. Unlike the MediaPlayer API, ExoPlayer is easy to
|
||
customize and extend, and can be updated through Play Store application
|
||
updates.
|
||
|
||
## News ##
|
||
|
||
Read news, hints and tips on the [news][] page.
|
||
|
||
[news]: https://google.github.io/ExoPlayer/news.html
|
||
|
||
## Documentation ##
|
||
|
||
* The [developer guide][] provides a wealth of information to help you get started.
|
||
* The [class reference][] documents the ExoPlayer library classes.
|
||
* The [release notes][] document the major changes in each release.
|
||
|
||
[developer guide]: https://google.github.io/ExoPlayer/guide.html
|
||
[class reference]: https://google.github.io/ExoPlayer/doc/reference
|
||
[release notes]: https://github.com/google/ExoPlayer/blob/dev/RELEASENOTES.md
|
||
|
||
## Using ExoPlayer ##
|
||
|
||
##### Via jCenter #####
|
||
|
||
The easiest way to get started using ExoPlayer is by including the following in your project's `build.gradle` file:
|
||
|
||
```
|
||
gradle
|
||
compile 'com.google.android.exoplayer:exoplayer:rX.X.X'
|
||
```
|
||
|
||
where `rX.X.X` is the your preferred version. For the latest version, see the project's [Releases][]. For more details,
|
||
see the project on [Bintray][].
|
||
|
||
[Releases]: https://github.com/google/ExoPlayer/releases
|
||
[Bintray]: https://bintray.com/google/exoplayer/exoplayer/view
|
||
|
||
##### as source #####
|
||
|
||
ExoPlayer can also be built from source using Gradle. You can include it as a dependent project like so:
|
||
|
||
```
|
||
gradle
|
||
// settings.gradle
|
||
include ':app', ':..:ExoPlayer:library'
|
||
|
||
// app/build.gradle
|
||
dependencies {
|
||
compile project(':..:ExoPlayer:library')
|
||
}
|
||
```
|
||
|
||
##### As a jar #####
|
||
|
||
If you want to use ExoPlayer as a jar, run:
|
||
|
||
```
|
||
sh
|
||
./gradlew jarRelease
|
||
```
|
||
|
||
and copy `library.jar` to the libs folder of your new project.
|
||
|
||
## Developing ExoPlayer ##
|
||
|
||
##### Project branches #####
|
||
|
||
* The [`master`][master] branch holds the most recent minor release.
|
||
* Most development work happens on the [`dev`][dev] branch.
|
||
* Additional development branches may be established for major features.
|
||
|
||
[master]: https://github.com/google/ExoPlayer/tree/master
|
||
[dev]: https://github.com/google/ExoPlayer/tree/dev
|
||
|
||
##### Using Android Studio #####
|
||
|
||
To develop ExoPlayer using Android Studio, simply open the ExoPlayer project in the root directory of the repository.
|
||
|
||
##### Using Eclipse #####
|
||
|
||
The repository includes Eclipse projects for both the ExoPlayer library and its
|
||
accompanying demo application. To get started:
|
||
|
||
1. Install Eclipse and setup the [Android SDK][].
|
||
1. Open Eclipse and navigate to File->Import->General->Existing Projects into Workspace.
|
||
1. Select the root directory of the repository.
|
||
1. Import the projects.
|
||
|
||
[Android SDK]: http://developer.android.com/sdk/index.html
|