ExoPlayerManager

Additional

Language
Kotlin
Version
0.14.0 (Oct 19, 2018)
Created
Mar 3, 2017
Updated
Oct 19, 2018 (Retired)
Owner
Akira Aratani (AAkira)
Contributor
Akira Aratani (AAkira)
1
Activity
Badge
Generate
Download
Source code

ExoPlayerManager

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

Preview

Play a HLS video

Play a video advertisement

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.