Skip to content
An android library that wraps the ExoPlayer and the IMA Android SDK which plays a video advertisement. This is written in Kotlin.
Kotlin
Branch: master
Clone or download

Latest commit

Latest commit b795766 Oct 19, 2018

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.idea Initial commit. Mar 3, 2017
app Fix custom data source factory. Oct 19, 2018
art Initial commit. Mar 3, 2017
gradle/wrapper Update gradle version. Jan 6, 2018
ima Modify support library import. Oct 19, 2018
playermanager Fix custom data source factory. Oct 19, 2018
.gitignore Initial commit. Mar 3, 2017
README.md Update read. Jun 12, 2018
build.gradle Modify support library import. Oct 19, 2018
gradle.properties Refactoring gradle. Aug 22, 2017
gradlew Initial commit. Mar 3, 2017
gradlew.bat Initial commit. Mar 3, 2017
settings.gradle Initial commit. Mar 3, 2017

README.md

ExoPlayerManager

An android library that wraps the ExoPlayer and the IMA Android SDK which plays a video advertisement.
This is written in Kotlin.

Platform Language License Download PlayerManager Download IMA plugin

Preview

Play a HLS video

HLS_SAMPLE

Play a video advertisement

IMA_SAMPLE

Features

  • Play a HLS video
  • Play a video advertisement using the IMA SDK v3.
  • 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

// 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 version="1.0" encoding="UTF-8"?>
<RelativeLayout 
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:keepScreenOn="true">

    <com.google.android.exoplayer2.ui.PlayerView
        android:id="@+id/playerView"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:focusable="true"
        app:surface_type="texture_view"
        app:use_controller="false" />
</RelativeLayout>

Play a video advertisement

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

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

reference : exoplayer-textureview

Author

Akira Aratani

  • Twitter
  • Mail

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.
You can’t perform that action at this time.