Skip to content

Latest commit

 

History

History
291 lines (207 loc) · 8.43 KB

README.md

File metadata and controls

291 lines (207 loc) · 8.43 KB

Fenster

A library to display videos in a TextureView using a custom MediaPlayer controller as described in this blog post http://www.malmstein.com/blog/2014/08/09/how-to-use-a-textureview-to-display-a-video-with-custom-media-player-controls/

Demo gif

Install

Download

To get the current snapshot version:

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.malmstein:fenster:0.0.2'
    }
}

minSDK

The minSDK for the use of the library is minSDK 16

Displaying a video with custom controller

Add a TextureVideoView and a PlayerController to your Activity or Fragment

<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:tools="http://schemas.android.com/tools"
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  android:background="@color/default_bg"
  tools:context=".DemoActivity">

  <com.malmstein.fenster.view.FensterVideoView
    android:id="@+id/play_video_texture"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:keepScreenOn="true"
    android:fitsSystemWindows="true" />

  <com.malmstein.fenster.controller.MediaFensterPlayerController
    android:id="@+id/play_video_controller"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:layout_alignParentBottom="true"
    android:animateLayoutChanges="true"
    android:fitsSystemWindows="true" />

</FrameLayout>

Setting video URL

In order to display a video, simply set the video URL and call start. You can also start the video from a desired second too.

@Override
protected void onPostCreate(Bundle savedInstanceState) {
    super.onPostCreate(savedInstanceState);

    textureView = (TextureVideoView) findViewById(R.id.play_video_texture);
    playerController = (PlayerController) findViewById(R.id.play_video_controller);

    textureView.setMediaController(playerController);

    textureView.setVideo("http://clips.vorwaerts-gmbh.de/big_buck_bunny.mp4",
                PlayerController.DEFAULT_VIDEO_START);
    textureView.start();
}

Exposed listeners

By default there are the exposed listeners. The NavigationListener will listen to the to Previous and Next events triggered by the controller. The VisibilityListener will be triggered when the PlayerController visibility changes.

playerController.setNavigationListener(this);
playerController.setVisibilityListener(this);

Using the Gesture Detection Player Controller

Attach a listener to your player controller

As described in this blog post http://www.malmstein.com/how-to-use-a-textureview-to-display-a-video-with-custom-media-player-controls/ it's very simple to use. Just add a listener to Player Controller

playerController.setFensterEventsListener(this);

The Fenster Events Listener allows you to react to the gestures

public interface FensterEventsListener {

    void onTap();

    void onHorizontalScroll(MotionEvent event, float delta);

    void onVerticalScroll(MotionEvent event, float delta);

    void onSwipeRight();

    void onSwipeLeft();

    void onSwipeBottom();

    void onSwipeTop();
}

Use MediaPlayerController instead of SimpleMediaPlayerController

MediaFensterPlayerController also shows volume and brightness controls, if you just want to use a simple media controller then the recommendation is to use SimpleMediaFensterPlayerController

<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:tools="http://schemas.android.com/tools"
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  android:background="@color/default_bg"
  tools:context=".DemoActivity">

  <com.malmstein.fenster.view.FensterVideoView
    android:id="@+id/play_video_texture"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:keepScreenOn="true"
    android:fitsSystemWindows="true" />

  <com.malmstein.fenster.controller.SimpleMediaFensterPlayerController
    android:id="@+id/play_video_controller"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:layout_alignParentBottom="true"
    android:animateLayoutChanges="true"
    android:fitsSystemWindows="true" />

</FrameLayout>

Using the Volume and Brightness Seekbar

Add them to your layout:

  <com.malmstein.fenster.seekbar.BrightnessSeekBar
    android:id="@+id/media_controller_volume"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content" />
  <com.malmstein.fenster.seekbar.VolumeSeekBar
    android:id="@+id/media_controller_volume"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content" />

Initialise them from your Fragment or Activity:

mVolume = (VolumeSeekBar) findViewById(R.id.media_controller_volume);
mVolume.initialise(this);

mBrightness = (BrightnessSeekBar) findViewById(R.id.media_controller_brightness);
mBrightness.initialise(this);

You'll get a callback when the seekbar is being dragged:

@Override
public void onVolumeStartedDragging() {
    mDragging = true;
}

@Override
public void onVolumeFinishedDragging() {
    mDragging = false;
}

@Override
public void onBrigthnessStartedDragging() {
    mDragging = true;
}

@Override
public void onBrightnessFinishedDragging() {
    mDragging = false;
}

Support for different video origins

The setVideo() method allows you to load remote or local video files. You can also set the start time of the video (useful if you want to resume content), passing in a integer which corresponds to Milliseconds.

Loading a remote stream

@Override
protected void onPostCreate(Bundle savedInstanceState) {
    super.onPostCreate(savedInstanceState);

    textureView = (TextureVideoView) findViewById(R.id.play_video_texture);
    playerController = (PlayerController) findViewById(R.id.play_video_controller);

    textureView.setMediaController(playerController);

    textureView.setVideo("http://clips.vorwaerts-gmbh.de/big_buck_bunny.mp4");
    textureView.start();
}

Loading a local stream

Fenster uses the AssetFileDescriptor in order to load a local video stream.

@Override
protected void onPostCreate(Bundle savedInstanceState) {
    super.onPostCreate(savedInstanceState);

    textureView = (TextureVideoView) findViewById(R.id.play_video_texture);
    playerController = (PlayerController) findViewById(R.id.play_video_controller);

    textureView.setMediaController(playerController);
    
    AssetFileDescriptor assetFileDescriptor = getResources().openRawResourceFd(R.raw.big_buck_bunny);
    textureView.setVideo(assetFileDescriptor);
   
    textureView.start();
}

Support for video scaling modes

Sets video scaling mode. To make the target video scaling mode effective during playback, the default video scaling mode is VIDEO_SCALING_MODE_SCALE_TO_FIT. Uses setVideoScalingMode

There are two different video scaling modes: scaleToFit and crop

In order to use it, Fenster allows you to pass in an argument from the xml layout:

<com.malmstein.fenster.view.FensterVideoView
  android:id="@+id/play_video_texture"
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  app:scaleType="crop" />

License

(c) Copyright 2016 David Gonzalez

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.