Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aakira/exoplayermanager
An android library that wraps the ExoPlayer and the IMA Android SDK which plays a video advertisement. This is written in Kotlin.
https://github.com/aakira/exoplayermanager
android android-library exoplayer hls-sample hls-video ima-sdk kotlin
Last synced: 3 months ago
JSON representation
An android library that wraps the ExoPlayer and the IMA Android SDK which plays a video advertisement. This is written in Kotlin.
- Host: GitHub
- URL: https://github.com/aakira/exoplayermanager
- Owner: AAkira
- Created: 2017-03-03T10:35:01.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2018-10-19T09:42:11.000Z (over 6 years ago)
- Last Synced: 2024-08-07T23:41:21.147Z (6 months ago)
- Topics: android, android-library, exoplayer, hls-sample, hls-video, ima-sdk, kotlin
- Language: Kotlin
- Size: 545 KB
- Stars: 79
- Watchers: 7
- Forks: 24
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ExoPlayerManager
An android library that wraps the ExoPlayer and the IMA Android SDK which plays a video advertisement.
This is written in Kotlin.
[](http://developer.android.com/index.html)
[](https://kotlinlang.org)
[](http://www.apache.org/licenses/LICENSE-2.0)
[](https://bintray.com/aakira/maven/exoplayer-manager/_latestVersion)
[](https://bintray.com/aakira/maven/exoplayer-manager-ima/_latestVersion)
## Preview
### Play a HLS video
![HLS_SAMPLE][hls_sample]
### Play a video advertisement
![IMA_SAMPLE][ima_sample]
## Features
* Play a HLS video
* Play a video advertisement using the [IMA SDK v3](https://github.com/googleads/googleads-ima-android).
* Can limit the bitrate
## Requirements
* Kotlin 1.1.0 or above
* ExoPlayer 2.8 or above
* Android SDK version 4.1 or above (ExoPlayer requirements)
## Usage
### Play HLS
```Kotlin
// inject from xml
val playerView: PlayerView by bindView(R.id.playerView)
val playerManager: ExoPlayerManager = ExoPlayerManager.Builder(context).run {
build(
renderersFactory = createRenderersFactory(), // You can set your RenderersFactory
loadControl = createDefaultLoadControl( // You can set your LoadControl
minBufferMs = 15000,
maxBufferMs = 50000,
bufferForPlaybackMs = 2500,
bufferForPlaybackAfterRebufferMs = 5000
),
drmSessionManager = null // You can set your drmSessionManager
)
}
// inject PlayerView
playerManager.injectView(playerView)
val dataSource = DataSourceCreator.UrlBuilder(
url = HLS_SAMPLE_URL,
userAgent = Util.getUserAgent(this, "UserAgent"),
okHttpClient = your ok http client, // you can use your okhttp client if you want use it.
dataSourceCreatorInterface = your data source // you can use your data source if you want use it.
)
playerManager.setHlsSource(dataSource.build())
// play
playerManager.play()
// pause
playerManager.pause()
// stop
playerManager.stop()
// release
playerManager.release()
// mute
playerManager.toMute()
// limit bitrate
playerManager.setMaxVideoBitrate((60 * 1000).toLong())
// change playback speed (speed, pitch)
playerManager.setPlaybackParameters(2f, 2f)
// state listener
playerManager.addOnStateChangedListener { playWhenReady: Boolean, playbackState: Int ->
}
// error listener
playerManager.addOnPlayerErrorListener {
}
```
```xml
```
### Play a video advertisement
```Kotlin
val adPlayerController: AdPlayerController = AdPlayerController.Builder(
context = this,
playerView = playerView,
adUiContainer = adUiContainer,
language = "us",
userAgent = Util.getUserAgent(this, "UserAgent"),
playerManager = playerManager)
.create()
// call in Activity onResume()
adPlayerController.resume()
// call in Activity onPause()
adPlayerController.pause()
// call in Activity onDestroy()
adPlayerController.destroy()
// call in Activity detachedFromWindow()
adPlayerController.release()
```
## Setup
### Gradle
Add the dependency in your `build.gradle`
```groovy
buildscript {
repositories {
jcenter()
}
}
dependencies {
implementation 'com.github.aakira:exoplayer-manager:0.13.0@aar'
implementation 'com.github.aakira:exoplayer-manager-ima:0.13.0@aar' // if you use an IMA SDK
}
```
## Using libraries
* [Exo Player r2.x](https://github.com/google/ExoPlayer)
* [googleads-ima-android(IMA Android SDK v3)](https://github.com/googleads/googleads-ima-android) (plugin)
* [kotterknife](https://github.com/JakeWharton/kotterknife) (only sample)
* [timber](https://github.com/JakeWharton/timber) (only sample)
reference : [exoplayer-textureview](https://github.com/satorufujiwara/exoplayer-textureview)
## Author
### Akira Aratani
* Twitter
- [@_a_akira](https://twitter.com/_a_akira)
* Mail
- [email protected]
## License
```
Copyright (C) 2017 A.Akira
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.
```
[hls_sample]: /art/hls_sample.gif
[ima_Sample]: /art/ima_sample.gif