easy-video-player

介绍：

一个使用非常简单的视频播放器。基于原生的MediaPlayer API，支持本地和远程视频。

运行效果：

使用说明：

特点

• 基于原生的MediaPlayer API，支持本地和远程视频。

• 简单。极少的代码就可以完成。

• 易配置。有许多选项可以让你制作满足自己需求的播放器。

• 自适应。播放器自动使用你的Activity的主题颜色。

你可以在这里下载 sample APK。

build.gradle

dependencies {
    // ... other dependencies
    compile 'com.afollestad:easyvideoplayer:0.2.5'
}

你需要一个Activity来持有EasyVideoPlayer的视图和视频内容。只需要一点点配置。

首先，Activity需要使用AppCompat的主题。这里是sample project中的一个例子：

<style name="AppTheme" parent="Theme.AppCompat.NoActionBar">
    <item name="colorPrimary">@color/primary</item>
    <item name="colorPrimaryDark">@color/primary_dark</item>
    <item name="colorAccent">@color/accent</item>
</style>

其次，Activity应该禁止对手机方向改变的反应。这样视频才能在设备方向变化的时候继续播放。播放器将自适应长宽比。你需要在Activity的AndroidManifest.xml中设置 android:configChanges：

<activity
    android:name=".MyPlayerActivity"
    android:label="@string/my_player_activity"
    android:configChanges="orientation|keyboardHidden|screenLayout|screenSize"
    android:theme="@style/AppTheme" />   <!-- Don't need to set the theme here if it's set on your <application /> tag already -->

布局

Activity的布局非常简单。你只需要一个EasyVideoPlayer 视图，所有的控制，所有的东西都是由视频播放视图自己创建的。

<com.afollestad.easyvideoplayer.EasyVideoPlayer xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/player"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

代码

既然你的Activity使用AppCompat主题，那么它必须继承AppCompatActivity。

视频播放器的初始化非常简单。你只需设置一个回调去接收重要事件的通知以及视频源。

public class MyPlayerActivity extends AppCompatActivity implements EasyVideoCallback {
    private static final String TEST_URL = "http://clips.vorwaerts-gmbh.de/big_buck_bunny.mp4";
    private EasyVideoPlayer player;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_myplayer);
        // Grabs a reference to the player view
        player = (EasyVideoPlayer) findViewById(R.id.player);
        // Sets the callback to this Activity, since it inherits EasyVideoCallback
        player.setCallback(this);
        // Sets the source to the HTTP URL held in the TEST_URL variable.
        // To play files, you can use Uri.fromFile(new File("..."))
        player.setSource(Uri.parse(TEST_URL));
        // From here, the player view will show a progress indicator until the player is prepared.
        // Once it's prepared, the progress indicator goes away and the controls become enabled for the user to begin playback.
    }
    @Override
    public void onPause() {
        super.onPause();
        // Make sure the player stops playing if the user presses the home button.
        player.pause();
    }
    // Methods for the implemented EasyVideoCallback
    @Override
    public void onPreparing(EasyVideoPlayer player) {
        // TODO handle if needed
    }
    @Override
    public void onPrepared(EasyVideoPlayer player) {
        // TODO handle
    }
    @Override
    public void onBuffering(int percent) {
        // TODO handle if needed
    }
    @Override
    public void onError(EasyVideoPlayer player, Exception e) {
        // TODO handle
    }
    @Override
    public void onCompletion(EasyVideoPlayer player) {
        // TODO handle if needed
    }
    @Override
    public void onRetry(EasyVideoPlayer player, Uri source) {
        // TODO handle if used
    }
    @Override
    public void onSubmit(EasyVideoPlayer player, Uri source) {
        // TODO handle if used
    }
}

你可以在 sample project中看到基本一致的代码。

Programmatic Control

这里是一些可以用来控制EasyVideoPlayer视图的方法。

EasyVideoPlayer player = // ...
// Sets a video source to be played.
player.setSource(Uri);
// Sets a callback to receive normal player events.
player.setCallback(EasyVideoCallback);
// Sets a callback that can be used to retrieve updates of the current playback position.
player.setProgressCallback(EasyVideoProgressCallback);
// Starts or resumes playback.
player.start();
// Seeks to a position in the video.
player.seekTo(int);
// Pauses playback.
player.pause();
// Stops playback.
player.stop();
// Resets the player, allowing a new source to be set.
player.reset();
// Releases the underlying MediaPlayer and cleans up resources.
player.release();
// Shows the default controls. They can be hidden again if the user taps the player.
player.showControls();
// Hides the default controls. They can be shown again if the user taps the player.
player.hideControls().
// Shows the controls if they're hidden, hides them if they're shown.
player.toggleControls();
// Returns true if the default controls are currently shown.
player.isControlsShown();
// Hide the default controls and prevents them from being shown.
player.disableControls();
// Undoes disableControls()
player.enableControls();
// Returns true if the player has prepared for playback entirely
player.isPrepared();
// Returns true if the player is NOT paused.
player.isPlaying();
// Returns the current position of playback.
player.getCurrentPosition();
// Returns the total duration of the video.
player.getDuration();

Programmatic Configuration

这里有一些用于改变EasyVideoPlayer默认行为的选项：

EasyVideoPlayer player = // ...
// EasyVideoPlayer.LEFT_ACTION_NONE:     hides all left actions.
// EasyVideoPlayer.LEFT_ACTION_RESTART:  the default, shows the skip back to beginning button.
// EasyVideoPlayer.LEFT_ACTION_RETRY:    shows a textual 'Retry' button, invokes the onRetry() callback method.
player.setLeftAction(int);
// EasyVideoPlayer.RIGHT_ACTION_NONE:    the default, hides all right actions.
// EasyVideoPlayer.RIGHT_ACTION_SUBMIT:  shows a textual 'Submit' button, invokes the onSubmit() callback method.
// EasyVideoPlayer.RIGHT_ACTION_LABEL:   shows a textual label that can be customized with setCustomLabelText(CharSequence) and setCustomLabelTextRes(int);
player.setRightAction(int);
// Defaults to true. The controls fade out when playback starts.
player.setHideControlsOnPlay(boolean);
// Defaults to false. Immediately starts playback when the player becomes prepared.
player.setAutoPlay(boolean);
// Sets a position that will be skipped to right when the player becomes prepared. Only happens once when set.
player.setInitialPosition(int);
// Sets a custom string for the left retry action.
player.setRetryText(CharSequence);
player.setRetryTextRes(int);
// Sets a custom string for the right submit action.
player.setSubmitText(CharSequence);
player.setSubmitTextRes(int);
// Sets a custom drawable for the left restart action.
player.setRestartDrawable(Drawable);
player.setRestartDrawableRes(int);
// Sets a custom drawable for the play button.
player.setPlayDrawable(Drawable);
player.setPlayDrawableRes(int);
// Sets a custom drawable for the pause button.
player.setPauseDrawable(Drawable);
player.setPauseDrawableRes(int);
// Sets a theme color used to color the controls and labels. Defaults to your activity's primary theme color.
player.setThemeColor(int);
player.setThemeColorRes(int);
// Sets the left and right volume levels. The player must be prepared first.
player.setVolume(float, float);

XML Configuration

上面使用代码配置的东西也可以直接在布局中配置：

<com.afollestad.easyvideoplayer.EasyVideoPlayer xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/player"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:evp_autoPlay="false"
    app:evp_customLabelText="Custom label text if rightAction is customLabel"
    app:evp_disableControls="false"
    app:evp_hideControlsOnPlay="true"
    app:evp_leftAction="restart"
    app:evp_pauseDrawable="@drawable/evp_action_pause"
    app:evp_playDrawable="@drawable/evp_action_play"
    app:evp_restartDrawable="@drawable/evp_action_restart"
    app:evp_retryText="@string/evp_retry"
    app:evp_rightAction="none"
    app:evp_source="http://clips.vorwaerts-gmbh.de/big_buck_bunny.mp4"
    app:evp_submitText="@string/evp_submit"
    app:evp_themeColor="@color/color_primary" />