Skip to content
/ Player Public

为视频复杂业务解决方案框架，该框架采用组件化的思想。核心组件：解码器组件、视图组件、显示组件。使各个组件间的业务分离互不干扰，大大简化了视频复杂业务。提高生产效率、降低耦合度、扩展能力

15 stars 6 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

JakePrim/Player

BranchesTags

Repository files navigation

Welcome PrimPlayerCC

This What?

这是一个为多媒体复杂业务解决方案框架，该框架采用组件化的思想。主要涉及到四个核心组件：解码器组件、视图组件、显示组件、数据资源组件。 使各个组件间的业务分离互不干扰。

实现的功能

  • 数据资源组件:数据提供者,可自定义数据，存储到数据池中
  • 解码器组件:可自定义解码器,支持动态切换解码器
  • 视频显示组件:可自定义显示组件
  • 呈现视频组件:允许自动呈现视频view,灵活切换
  • 高度可定制的视图组件
  • 统一事件分发，各个视图组件的业务完全隔离
  • 支持视图组件的热插拔，可动态的添加移除视图组件
  • 可定制视图组，添加视图的拦截规则
  • 可定制化的事件分发机制
  • 支持各种场景下的全屏切换无缝续播，丝毫不入侵任何代码
  • 支持手势滑动
  • 支持自动播放下一条
  • 支持手动播放下一条/上一条，以及播放index位置的资源
  • 支持动态切换解码器
  • 支持动态切换呈现view(SurfaceView/TextureView)
  • 支持调整视频显示比例
  • 支持倍速播放
  • 支持视频旋转

更新版本说明

1.0.0-beta (开发版本)

1.0.1-beta (开发版本-框架架构调整)

  • 列表播放
  • 完善视频基础功能

基础功能

1. 初始化

        //视频播放器组件配置初始化
        PrimPlayerCC.getInstance().init()
                .setLogEnable(true)
                .addDecoder(new DecoderWrapper(11, DefaultDecoder.class, "default player 11"))
                .addDecoder(new DecoderWrapper(12, DefaultDecoder.class,"default player 12"))
                .setUseDecoderId(11)
                .build(this);

2. 使用

自由切换解码器组件
       playerCCView = (DefaultPlayerCCView) findViewById(R.id.player_cc);
       playerCCView.switchDecoder(12);//切换解码器
高度可完全定制的视图组件
        //使用自定义的视图组
        PrimPlayerCC.getCoverCCManager()
                .addCover(DefaultCoverKey.DEFAULT_LOAD_COVER, new DefaultLoadCover(this))
                .addCover(DefaultCoverKey.DEFAULT_CONTROL_COVER, new DefaultControlCover(this))
                .addCover(DefaultCoverKey.DEFAULT_ERROR_COVER,new DefaultErrorCover(this))
                .addCover(DefaultCoverKey.DEFAULT_COMPLETE_COVER,new DefaultCompleteCover(this))
                .insertCoverGroup(playerCCView);

        //使用框架中默认的视图组
        playerCCView.usedDefaultCoverGroup();
设置视图组拦截器，可定义拦截规则
        //只添加视图等级 > 0 的视图
        playerCCView.setCoverGroupFilter(new ICoverGroup.OnCoverFilter() {
            @Override
            public boolean filter(ICover cover) {
                return cover.getCoverLevel() > 0;
            }
        });
设置呈显视频的组件，允许自定义
        //设置呈现视频的RenderView
        //使用框架默认的surfaceView
        playerCCView.setRenderView(IRender.SURFACE_VIEW);
        /**
          * 使用自定的view,从解码器中返回 {@link IDecoder#getRenderView()}
          */
        playerCCView.setRenderView(IRender.CUSTOM_VIEW);

        /**
          * 使用框架默认的textureView
          */
        playerCCView.setRenderView(IRender.TEXTURE_VIEW);
设置数据提供者，适用于播放资源列表，方便播放资源的切换 详情看Demo

 //设置数据提供者 多个数据资源
        List<TestVideoBean> testVideoBeanList = new ArrayList<>(100);
        for (int i = 0; i < 2; i++) {
            TestVideoBean testVideoBean = new TestVideoBean();
            testVideoBean.setId(10 + i);
            testVideoBean.setCount(i * 100);
            testVideoBean.setImgUrl("http:www.baidu");
            testVideoBean.setTitle("测试标题:" + i);
            testVideoBean.setUrl("http://rmrbtest-image.peopleapp.com/upload/video/201809/153723951440062dcc54a0912f.mp4");
            testVideoBeanList.add(testVideoBean);
        }

        final TestDataProvider testDataProvider = new TestDataProvider(testVideoBeanList);

        playerCCView.setDataProvider(testDataProvider);
设置单个的播放资源，如果设置了数据提供者，默认使用数据提供者的数据
 //设置播放资源
        playerCCView.setDataSource(
                new PlayerSource("http://rmrbtest-image.peopleapp.com/upload/video/201809/153723951440062dcc54a0912f.mp4"));
如果为资源列表，可设置自动播放下一条
        //播放完成后的等待时间，然后自动播放下一条
        playerCCView.autoNextPlayWaitTime(3000);
         //允许自动播放下一条
        playerCCView.autoPlayNext(true);
        //支持播放资源列表中的某一个资源
        playerCCView.selectDataPlay(position);
手势控制
//开启/关闭手势
playerCCView.setGesture(isChecked);
//开启/关闭滑动手势
playerCCView.setScrollGesture(isChecked);
手动调用播放上一条或下一条
 playerCCView.playerForward();
 playerCCView.playerNext();

 //MedaiPlayer
 playerNext()
 playerNext()
调整视频显示比例
int AR_ASPECT_FIT_PARENT = 0;//自适应屏幕
int AR_ASPECT_FILL_PARENT = 1;//全屏截取中间
int AR_ASPECT_WRAP_CONTENT = 2;//原始视频
int AR_MATCH_PARENT = 3;//铺满屏幕
int AR_16_9_FIT_PARENT = 4;//16:9
int AR_4_3_FIT_PARENT = 5;//4:3
playerCCView.setDiaplayAspectRatio(IRenderView.AR_ASPECT_FIT_PARENT);

设置倍速播放

playerCCView.setSpeed(0.5f);

调整视频角度

playerCCView.setVideoRotation(90);

事件分发码详解

PlayerEventCode

    /**
     * 当给解码器设置播放地址时，分发的事件码
     */
    public static final int PRIM_PLAYER_EVENT_DATA_SOURCE = -1010;

    /**
     * 当解码器处于准备中，分发的事件码
     */
    public static final int PRIM_PLAYER_EVENT_PREPARING = -2010;

    /**
     * 当解码器准备完毕，分发的事件码
     */
    public static final int PRIM_PLAYER_EVENT_PREPARED = -1011;

    /**
     * 缓冲结束的事件码
     */
    public static final int PRIM_PLAYER_EVENT_BUFFERING_END = -3000;

    /**
     * 开始缓冲的事件码
     */
    public static final int PRIM_PLAYER_EVENT_BUFFERING_START = -3001;

    /**
     * 视频角度改变
     */
    public static final int PRIM_PLAYER_EVENT_ROTATION_CHANGED = -3002;

    /**
     * 视频渲染完成，加载第一贞
     */
    public static final int PRIM_PLAYER_EVENT_PANDERING_START = -3003;

    /**
     * 视频大小改变监听
     */
    public static final int PRIM_PLAYER_EVENT_VIDEO_SIZE_CHANGE = -1021;

    /**
     * when decoder info listener
     */
    public static final int PRIM_PLAYER_EVENT_INFO = -1022;

    /**
     * when decoder info seek complete listener
     */
    public static final int PRIM_PLAYER_SEEK_COMPLETE = -1023;

    /**
     * when decoder timed text listener
     */
    public static final int PRIM_PLAYER_TIMED_TEXT = -1024;

    /**
     * when decoder completion listener
     */
    public static final int PRIM_PLAYER_EVENT_COMPLETION = -1019;

    /**
     * when you call {@link IDecoder#start()}
     */
    public static final int PRIM_PLAYER_EVENT_START = -1012;

    /**
     * when you call {@link IDecoder#pause()}
     */
    public static final int PRIM_PLAYER_EVENT_PAUSE = -1013;

    /**
     * when you call {@link IDecoder#resume()}
     */
    public static final int PRIM_PLAYER_EVENT_RESUME = -1014;

    /**
     * when you call {@link IDecoder#stop()}
     */
    public static final int PRIM_PLAYER_EVENT_STOP = -1015;

    /**
     * when you call {@link IDecoder#reset()}
     */
    public static final int PRIM_PLAYER_EVENT_RESET = -1016;

    /**
     * when you call {@link IDecoder#release()}
     */
    public static final int PRIM_PLAYER_EVENT_RELEASE = -1025;

    /**
     * when you call {@link com.prim_player_cc.decoder_cc.IDecoder#destroy()}
     */
    public static final int PRIM_PLAYER_EVENT_DESTROY = -1017;

    /**
     * on player timer progress update
     * {@link com.prim_player_cc.decoder_cc.helper.TimerUpdateHelper}
     */
    public static final int PRIM_PLAYER_EVENT_TIMER_UPDATE = -1018;

    /**
     * when player status change {@link com.prim_player_cc.status.Status}
     */
    public static final int PRIM_PLAYER_EVENT_STATUS_CHANGE = -1020;

    /**
     * when player advert prompt event
     */
    public static final int PRIM_PLAYER_EVENT_ADVERT_PROMPT = -2000;

    /**
     * when net/wifi --> net player prompt event
     */
    public static final int PRIM_PLAYER_EVENT_NET_DATA_PROMPT = -2001;

    /**
     * when net --> wifi player prompt event
     */
    public static final int PRIM_PLAYER_EVENT_WIFI_PROMPT = -2004;

    /**
     * when player completion auto player next
     */
    public static final int PRIM_PLAYER_EVENT_AUTO_PLAY_NEXT = -2002;

    /**
     * when player buffering update listener
     */
    public static final int PRIM_PLAYER_EVENT_BUFFER_UPDATE = -2003;

    /**
     * when {@link com.prim_player_cc.view.BasePlayerCCView} full --> vertical
     */
    public static final int PRIM_PLAYER_EVENT_FULL_VERTICAL = -2004;

    /**
     * when {@link com.prim_player_cc.view.BasePlayerCCView} vertical --> full
     */
    public static final int PRIM_PLAYER_EVENT_VERTICAL_FULL = -2005;

    /**
     * when event more info
     */
    public static final int PRIM_PLAYER_EVENT_MORE_INFO = -2006;

框架设计思想

无标题绘图.png

About

为视频复杂业务解决方案框架，该框架采用组件化的思想。核心组件：解码器组件、视图组件、显示组件。使各个组件间的业务分离互不干扰，大大简化了视频复杂业务。提高生产效率、降低耦合度、扩展能力

Resources

Readme
Activity

Stars

15 stars

Watchers

2 watching

Forks

6 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages