PLDroidPlayer

PLDroidPlayer 是一个适用于 Android 的音视频播放器 SDK，可高度定制化和二次开发，特色是支持 RTMP 和 HLS 直播流媒体、以及常见音视频文件（如 MP4、M4A ）播放。

功能特性

内容摘要

播放器对比
使用方法
- 配置工程
- 示例代码
依赖库
版本历史

播放器对比

-	ijkplayer	PLDroidPlayer
Shared Library Size	较大	较小
Shared Library Count	5个	1个
Widget	有商业授权风险	无商业授权风险
MediaController	难以定制化	容易定制化

使用方法

项目配置

从 releases/ 目录获取：

pldroid-player-xxx.jar
ijkmediaplayer-xxx.jar
armeabi-v7a/libpldroidplayer.so
arm64-v8a/libpldroidplayer.so
armeabi/libpldroidplayer.so
x86/libpldroidplayer.so

并在项目中加入对应的 jar/so 文件的依赖关系。可参考 PLDroidPlayerDemo 中的做法。

示例代码

Video 播放

1 初始化 VideoView 及其布局

<com.pili.pldroid.player.widget.VideoView
    android:id="@+id/video_view"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:layout_gravity="center" />

  mVideoView = (VideoView) findViewById(R.id.video_view);

2 VideoView 与 MediaController 建立联系

  mMediaController.setMediaPlayer(mVideoView);
  mVideoView.setMediaController(mMediaController);

3 传入播放地址，可以是 /path/to/local.mp4 本地文件绝对路径，或 HLS URL，或 RTMP URL

  mVideoView.setVideoPath(mVideoPath);

4 设置 Listener

public class VideoPlayerActivity extends Activity implements
        OnCompletionListener,
        OnInfoListener,
        OnVideoSizeChangedListener,
        OnErrorListener,
        OnPreparedListener {
...
  mVideoView.setOnErrorListener(this);
  mVideoView.setOnCompletionListener(this);
  mVideoView.setOnInfoListener(this);
  mVideoView.setOnPreparedListener(this);
  mVideoView.setOnVideoSizeChangedListener(this);
...

@Override
public void onCompletion(IMediaPlayer mp) {
  ...
}

@Override
public boolean onError(IMediaPlayer mp, int what, int extra) {
  if (what == -10000) {
    switch (extra) {
        case PlayerCode.EXTRA_CODE_404_NOT_FOUND:
            break;
        case PlayerCode.EXTRA_CODE_CONNECTION_REFUSED:
            break;
        case PlayerCode.EXTRA_CODE_CONNECTION_TIMEOUT:
            break;
        case PlayerCode.EXTRA_CODE_EMPTY_PLAYLIST:
            break;
        case PlayerCode.EXTRA_CODE_INVALID_URI:
            break;
        case PlayerCode.EXTRA_CODE_IO_ERROR:
            break;
        case PlayerCode.EXTRA_CODE_STREAM_DISCONNECTED:
            break;
    }
  }
}

@Override
public boolean onInfo(IMediaPlayer mp, int what, int extra) {
  switch (what) {
    case IMediaPlayer.MEDIA_INFO_BUFFERING_START:
        break;
    case IMediaPlayer.MEDIA_INFO_BUFFERING_END:
        break;
    case IMediaPlayer.MEDIA_INFO_AUDIO_RENDERING_START:
        break;
    case IMediaPlayer.MEDIA_INFO_VIDEO_RENDERING_START:
        break;
    }
}

@Override
public void onPrepared(IMediaPlayer mp) {
  ...
}

@Override
public void onVideoSizeChanged(IMediaPlayer iMediaPlayer, int width, int height, int sarNum, int sarDen) {
  ...
}

5 设置 AVOptions

// Tip: you can custom the variable depending on your situation
if (mIsLiveStream) {
    options.setInteger(AVOptions.KEY_BUFFER_TIME, 1000); // the unit of buffer time is ms
    options.setInteger(AVOptions.KEY_GET_AV_FRAME_TIMEOUT, 10 * 1000); // the unit of timeout is ms
    options.setString(AVOptions.KEY_FFLAGS, AVOptions.VALUE_FFLAGS_NOBUFFER); // "nobuffer"
    options.setInteger(AVOptions.KEY_LIVE_STREAMING, 1);
}
mAudioPlayer.setAVOptions(options);

AVOptions.KEY_FFLAGS , AVOptions.KEY_BUFFER_TIME 仅对 RTMP 有效；AVOptions 需要在 start()/setVideoPath() 前设置

6 全屏播放

您只需在 VideoView 的布局文件中设置对应的属性即可，例如：

<com.pili.pldroid.player.widget.VideoView
        android:id="@+id/video_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:layout_centerInParent="true"
        android:layout_alignParentTop="true"
        android:layout_alignParentBottom="true"
        android:layout_alignParentLeft="true"
        android:layout_alignParentRight="true"
        />

纯音频播放

1 实例化 AudioPlayer

mAudioPlayer = new AudioPlayer(this);

2 AudioPlayer 与 MediaController 建立联系

mMediaController.setMediaPlayer(mAudioPlayer);
mAudioPlayer.setMediaController(mMediaController);

3 传入播放地址，可以是 /path/to/local.mp3 本地音频文件绝对路径，或 HLS URL，或 RTMP URL

mAudioPlayer.setAudioPath(mAudioPath);