ExoPlayer HLS播放器接口说明

构造方法

ExoHlsPlayer(Context context);

设置M3U8播放地址

/**
   * 设置播放源
   * @param url M3U8地址
  void setDataSource(String url);

按云存储录像的文件名设置视频数据源

/**
   * 按云存储录像的文件名设置视频数据源
   * @param iotId    设备iotId
   * @param fileName 录像文件名
   void setDataSourceByIPCRecordFileName(String iotId, String fileName);

校验和准备数据

/**
   * 校验和准备数据
  void prepare();

开始或恢复播放视频

/**
   * 开始播放或恢复播放视频
  void start();

暂停播放

/**
   * 暂停播放, 调用start()恢复播放
  void pause();

跳转到指定位置

/**
   * 跳转到指定位置
   * @param position 单位为毫秒
  void seekTo(long positionInMs);

停止播放

**
   * 停止播放
  void stop();

重置播放器

/**
   * 重置播放器
  void reset();

释放播放器资源

/**
   * 释放播放器资源
  void release();

设置是否循环播放

/**
  * 设置是否循环播放
  * @param circlePlay true为循环播放
  void setCirclePlay(boolean circlePlay);

设置回放速率

/**
  * 设置回放的播放速率
  * @param speed 表示速率因子，取值范围为(0,2]，1表示正常速率
  void setPlaybackSpeed(float speed);

设置播放器音量

/**
   * 设置播放器音量
   * @param audioVolume范围为0~1，0为静音
  void setVolume(float audioVolume);

设置音频流通道类型

/**
   * 设置音频流通道类型，参见{@link android.media.AudioManager}
   * 如果音频正在播放，则会因为重新创建AudioTrack导致有短暂停顿
   * @param audioStreamType
  void setAudioStreamType(int audioStreamType);

设置画面缩放模式

/**
   * 设置视频画面缩放模式，默认为{@link android.media.MediaCodec#VIDEO_SCALING_MODE_SCALE_TO_FIT_WITH_CROPPING}
   * @param videoScalingMode 参见：
   * {@link android.media.MediaCodec#VIDEO_SCALING_MODE_SCALE_TO_FIT}
   * {@link android.media.MediaCodec#VIDEO_SCALING_MODE_SCALE_TO_FIT_WITH_CROPPING}
  void setVideoScalingMode(int videoScalingMode);

设置SurfaceView

/**
   * 设置SurfaceView
   * @param surfaceview
  void setSurfaceView(SurfaceView surfaceview);

清除SurfaceView

/**
   * 清除surfaceview
  void clearSurfaceView();

设置TextureView

/**
     * 设置TextureView，同一个TextureView不可被多个播放器共享，提供支持手势操作的控件ZoomableTextureView可做参照
     * @param textureview
    void setTextureView(TextureView textureView);

清除TextureView

/**
     * 清除textureview
    void clearTextureView();

设置数据源准备就绪事件监听器

/**
   * 设置数据源准备就绪事件监听器
   * @param listener
  void setOnPreparedListener(OnPreparedListener listener);
interface OnPreparedListener {
     * 数据源准备就绪回调
    void onPrepared();
}

设置播放器错误事件监听器

/**
   * 设置播放器错误事件监听器，错误类型参见：
   * {@link PlayerException.SOURCE_ERROR}
   * {@link PlayerException.RENDER_ERROR}
   * {@link PlayerException.UNEXPECTED_ERROR}
   * @param listener
  void setOnErrorListener(OnErrorListener listener);
interface OnErrorListener{
     * 播放器错误回调，参见
     * {@link PlayerException}
     * @param exception
    void onError(PlayerException exception);
}

设置播放状态变更事件监听器

/**
   * 设置播放状态变更事件监听器
   * @param listener
  void setOnPlayerStateChangedListener(OnPlayerStateChangedListener listener);
interface OnPlayerStateChangedListener{
     * 播放器状态变更回调
     * @param playerState 参见
     *                    {@link PlayerState#STATE_IDLE}
     *                    {@link PlayerState#STATE_BUFFERING}
     *                    {@link PlayerState#STATE_READY}
     *                    {@link PlayerState#STATE_ENDED}
    void onPlayerStateChange(int playerState);
}

设置首帧被渲染事件监听器

/**
   * 设置首帧被渲染事件监听器
   * @param listener
  void setOnRenderedFirstFrameListener(OnRenderedFirstFrameListener listener);
 interface OnRenderedFirstFrameListener {
     * 首帧被渲染回调
    void onRenderedFirstFrame();
}

设置视频内容宽高变更回调

    /**
     * 设置视频内容宽高变更回调
     * @param listener
    void setOnVideoSizeChangedListener(OnVideoSizeChangedListener listener);
 interface OnVideoSizeChangedListener{
     * 内容宽高改变时的回调
     * @param width  视频内容宽，单位为像素
     * @param height 视频内容高，单位为像素
    void onVideoSizeChanged(int width, int height);
}

获取当前播放进度

/**
   * 获取当前播放进度，相对于开始位置的偏移量
   * 播放器状态为{@link PlayerState#STATE_READY}时调用有效
   * @return 单位MS
  long getCurrentPosition();

获取视频总时长

/**
   * 获取视频总时长
   * 播放器状态为{@link #STATE_READY}时调用有效
   * @return 单位MS
  long getDuration();

获取音量

/**
   * 获取音量
   * @return 取值范围0~1
  float getVolume();

获取播放器状态

/**
   * 获取播放状态
   * @return 状态枚举：
   * {@link PlayerState#STATE_IDLE} 播放器初始状态
   * {@link PlayerState#STATE_BUFFERING} 缓冲中状态
   * {@link PlayerState#STATE_READY} 缓冲结束开始播放状态
   * {@link PlayerState#STATE_ENDED} 播放完成状态
  int getPlayState();

ZoomableTextureView相关接口

    /**
     * 设置画面放大倍数上限
     * 默认为4倍
     * @param scale 倍数
    void setMaxScale(float scale);

    /**
     * 重置画面缩放比例为1
     * @param smooth 是否带有平滑变化效果
    void zoomOut(boolean smooth);

    /**
     * 获取当前缩放比
     * @return  未放缩时为1.0f
    float getScale();

    /* 设置监听器
     * @param listener
    void setOnZoomableTextureListener(OnZoomableTextureListener listener);
    public interface OnZoomableTextureListener{
         * 当画面缩放比例发生变化时回调
         * @param zoomableTextureView
         * @param scale               画面缩放比例
        void onScaleChanged(ZoomableTextureView zoomableTextureView, float scale);
         * view双击事件回调
         * @param zoomableTextureView
         * @param e                   MotionEvent
         * @return 事件是否被处理，如果返回false，则会启用内部缩放逻辑
        boolean onDoubleTap(ZoomableTextureView zoomableTextureView, MotionEvent e);
         * view单击事件回调
         * @param zoomableTextureView
         * @param e                   MotionEvent
         * @return 事件是否被处理
        boolean onSingleTapConfirmed(ZoomableTextureView zoomableTextureView, MotionEvent e);
         * view长按事件回调
         * @param zoomableTextureView
         * @param e                   MotionEvent
        void onLongPress(ZoomableTextureView zoomableTextureView, MotionEvent e);
    }

     void setOnViewEdgeListener(OnViewEdgeListener listener)
     interface OnViewEdgeListener{
         * 当第一次拖动到view的边缘
        void onViewEdgeFirstTouched();
         * 当拖动到view下边缘，持续拖动会持续回调
         * @param zoomableTextureView
         * @param delta    持续处于边缘时触摸移动相对上次的差值
        void onBottomEdge(ZoomableTextureView zoomableTextureView, float delta);
         * 当拖动到view上边缘，持续拖动会持续回调
         * @param zoomableTextureView
         * @param delta               持续处于边缘时触摸移动相对上次的差值
        void onTopEdge(ZoomableTextureView zoomableTextureView, float delta);
         * 当拖动到view右边缘，持续拖动会持续回调
         * @param zoomableTextureView
         * @param delta               持续处于边缘时触摸移动相对上次的差值
        void onRightEdge(ZoomableTextureView zoomableTextureView, float delta);
         * 当拖动到view左边缘，持续拖动会持续回调
         * @param zoomableTextureView
         * @param delta               持续处于边缘时触摸移动相对上次的差值
        void onLeftEdge(ZoomableTextureView zoomableTextureView, float delta);