sjs/media
1
0
Fork 0
mirror of https://github.com/samsonjs/media.git synced 2026-03-28 09:55:48 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
No description
2764 commits 7 branches 40 tags 626 MiB
Java 98.5%
C++ 0.4%
Kotlin 0.4%
GLSL 0.3%
PostScript 0.2%
Other 0.1%
Find a file
olly 8bffe5d11e Add DummySurface for use with MediaCodec 
A DummySurface is useful with MediaCodec on API levels 23+.
Rather than having to release a MediaCodec instance when the
app no longer has a real surface to output to, it's possible
to retain the MediaCodec, using MediaCodec.setOutputSurface
to target a DummySurface instance instead. When the app has
a real surface to output to again, it can call swap this
surface back in instantaneously. Without DummySurface a new
MediaCodec has to be instantiated at this point, and decoding
can only start from a key-frame in the media.

A future change may hook this up internally in MediaCodecRenderer
for supported use cases, although this looks a little awkward. If
this approach isn't viable, we can require applications wanting
this to set a DummySurface themselves. This isn't easy to do with
the way SimpleExoPlayerView.setPlayer works at the moment, however,
so some changes will be needed either way.

Issue: #677

-------------
Created by MOE: https://github.com/google/moe
MOE_MIGRATED_REVID=154931778
2017-05-11 07:41:45 +01:00
demo Move renderer building into a factory class. 2017-04-26 15:49:35 +01:00
extensions vp9_extension: Include cstring explicitly 2017-04-26 15:17:41 +01:00
gradle/wrapper Update gradle version 2017-03-13 15:54:10 +00:00
library Add DummySurface for use with MediaCodec 2017-05-11 07:41:45 +01:00
playbacktests Move renderer building into a factory class. 2017-04-26 15:49:35 +01:00
testutils Updates for ExoPlayer modularization 2017-04-18 19:43:41 +01:00
.gitignore Cronet extension project setup 2016-08-10 20:06:43 +01:00
build.gradle Bump version and update release notes 2017-04-26 15:15:32 +01:00
CONTRIBUTING.md Fix broken documentation 2016-08-31 15:25:25 +01:00
gradle.properties Tweak project structure 2016-08-08 11:53:22 +01:00
gradlew Initial drop. 1.0.10. 2014-06-16 12:56:04 +01:00
gradlew.bat Cleanup following #884 2015-10-27 21:03:16 +00:00
ISSUE_TEMPLATE Try and get people to stop ignoring the issue template. Again. 2017-03-10 14:24:43 +00:00
javadoc_combined.gradle Generate combined Javadoc 2017-03-22 19:11:28 +00:00
javadoc_library.gradle Generate combined Javadoc 2017-03-22 19:11:28 +00:00
LICENSE Initial drop. 1.0.10. 2014-06-16 12:56:04 +01:00
publish.gradle Improve publishing to Bintray 2017-03-15 15:54:43 +00:00
README.md Updates for ExoPlayer modularization 2017-04-18 19:43:41 +01:00
RELEASENOTES.md Fill in release note TODOs 2017-04-26 16:16:28 +01:00
settings.gradle Split DASH into a separate module 2017-03-22 19:09:04 +00:00

README.md

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.

Documentation

Using ExoPlayer

The easiest way to get started using ExoPlayer is to add it as a gradle dependency. You need to make sure you have the jcenter repository included in the build.gradle file in the root of your project:

repositories {
    jcenter()
}

Next add a gradle compile dependency to the build.gradle file of your app module. The following will add a dependency to the full ExoPlayer library:

compile 'com.google.android.exoplayer:exoplayer:r2.X.X'

where r2.X.X is your preferred version. Alternatively, you can depend on only the library modules that you actually need. For example the following will add dependencies on the Core, DASH and UI library modules, as might be required for an app that plays DASH content:

compile 'com.google.android.exoplayer:exoplayer-core:r2.X.X'
compile 'com.google.android.exoplayer:exoplayer-dash:r2.X.X'
compile 'com.google.android.exoplayer:exoplayer-ui:r2.X.X'

The available modules are listed below. Adding a dependency to the full ExoPlayer library is equivalent to adding dependencies on all of the modules individually.

  • exoplayer-core: Core functionality (required).
  • exoplayer-dash: Support for DASH content.
  • exoplayer-hls: Support for HLS content.
  • exoplayer-smoothstreaming: Support for SmoothStreaming content.
  • exoplayer-ui: UI components and resources for use with ExoPlayer.

For more details, see the project on Bintray. For information about the latest versions, see the Release notes.

Developing ExoPlayer

Project branches

  • The project has dev-vX and release-vX branches, where X is the major version number.
  • Most development work happens on the dev-vX branch with the highest major version number. Pull requests should normally be made to this branch.
  • Bug fixes may be submitted to older dev-vX branches. When doing this, the same (or an equivalent) fix should also be submitted to all subsequent dev-vX branches.
  • A release-vX branch holds the most recent stable release for major version X.

Using Android Studio

To develop ExoPlayer using Android Studio, simply open the ExoPlayer project in the root directory of the repository.