README.md

MagicalExoPlayer

The Easiest Way To Play Video Using ExoPlayer In Your Android Application. Add Dependencies Into Your Gadle File, Sync Your Project And Then Just Pass Your Url Or Local Video Address To The Player. MagicalExoPlayer Support MP4, HLS, DASH And MP3.

Getting Started

These instructions will help you to use this library inside your projects

Prerequisites

This library was built with androidX, so you should migrate into androidX to use this library with out any problem. For migration you can use Migrating to AndroidX

Installing

Step 1. Add the JitPack repository to your build file, Add it in your root build.gradle at the end of repositories:

allprojects {
        repositories {
            maven { url 'https://jitpack.io' }
        }
    }

Step 2. Add the dependency

dependencies {
    implementation 'com.github.HamidrezaAmz:MagicalExoPlayer:X.X.X'
}

Here we go for implementation

Add player view into your XML

<com.potyvideo.library.AndExoPlayerView
        android:id="@+id/andExoPlayerView"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />

Refrence to custom-view inside your activity or fragment (I use butterknife), Or you can use findViewById()

 @BindView(R.id.andExoPlayerView)
 AndExoPlayerView andExoPlayerView;

Or

 AndExoPlayerView andExoPlayerView = findViewById(R.id.andExoPlayerView);

Implementation Example

 andExoPlayerView.setSource("URL OR FILE ADDRESS");

Custom Attributes

Command	Description
andexo_resize_mode	Type Of Video Player Size, you can pass Fill,Fit,Zoom
andexo_full_screen	Show FullScreen Toggle Button, you can Pass True,False
andexo_play_when_ready	Player Start Playing On Stream Is Ready True,False
andexo_aspect_ratio	In Order To Get The Desired Playerr Size, You Can Pass The Aspect Ratios You Need ASPECT_1_1, ASPECT_16_9, ASPECT_4_3, ASPECT_MATCH, ASPECT_MP3
andexo_show_controller	Show Or Hide Player Controller True,False
andexo_loop	Play video with loop modes Infinite,Finite

XML With Custom Attrs.

<com.potyvideo.library.AndExoPlayerView
        android:id="@+id/andExoPlayerView"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        app:andexo_aspect_ratio="aspect_16_9"
        app:andexo_full_screen="true"
        app:andexo_play_when_ready="true"
        app:andexo_show_controller="true"
        app:andexo_resize_mode="Fit" />

TIP

• If you wan to support full screen, please add this config into your activity in manifest.xml

android:configChanges="keyboard|keyboardHidden|orientation|screenSize|screenLayout|smallestScreenSize|uiMode"

For example your activity with be something like this

<activity
      android:name=".MainActivity"
      android:configChanges="keyboard|keyboardHidden|orientation|screenSize|screenLayout|smallestScreenSize|uiMode">
      <intent-filter>
          <action android:name="android.intent.action.MAIN" />

          <category android:name="android.intent.category.LAUNCHER" />
      </intent-filter>
</activity>

• If you want to pass custom headers over your stream url, you can just pass them as a hashmap like this:

  HashMap<String , String> extraHeaders = new HashMap<>();
  extraHeaders.put("foo","bar");
  andExoPlayerView.setSource("STREAM_URL", extraHeaders);

Other Libraries

• ExoPlayer - Google Player - Version 2.15.0

---

❤️ Support My Projects

However, if you get some profit from this or just want to encourage me to continue creating stuff, there are few ways you can do it. ☕ 🍔 🍟 🍎

• Starring: You may give a star or share the projects you like.