VideoLiveSession (yyvideolib 200.2.9.14.2 API)

java.lang.Object
- com.yy.mediaframework.VideoLiveSession

All Implemented Interfaces:

IEncoderListener, ILiveSession, IYYVideoSurfaceInfoListener

Direct Known Subclasses:

VideoOutdoorSession
```
public class VideoLiveSession
extends java.lang.Object
implements IYYVideoSurfaceInfoListener, IEncoderListener, ILiveSession
```
TODO: 视频SDK总入口，初始化摄像头采集、预处理、本地预览、编码和裁剪模块

Field Summary

Fields
Modifier and Type	Field and Description
`CameraCaptureFilter`	`mCaptureFilter`
`ClipFilter`	`mCliperFilter`
`VideoEncoderGroupFilter`	`mEncoderGroupFilter`
`VideoEndPointFilter`	`mEndPointFilter`
`ExternalDecoderFilter`	`mExternalDecoderFilter`
`VideoLiveFilterContext`	`mFilterContext`
`PeripheralsDecoderFilter`	`mPeripheralsDecoderFilter` PeripheralsDecoderFilter --> CameraCaptureFilter-->VideoLiveQualityFilter -->GPUPreprocessFilter--> ClipFilter--> -->PreviewFilter -->VideoEncoderGroupFilter-->TransmitUploadFilter
`GPUPreprocessFilter`	`mPreprocessFilter`
`PreviewFilter`	`mPreviewFilter`

Fields inherited from interface com.yy.mediaframework.IYYVideoSurfaceInfoListener
EVENT_SURFACE_AVAIBLE, EVENT_SURFACE_DESTROYED, EVENT_SURFACE_SIZE_CHANGED

Constructor Summary

Constructors
Constructor and Description

VideoLiveSession(android.content.Context context)
默认的开播的VideoLiveSession

Constructors
Constructor and Description
`VideoLiveSession(android.content.Context context)` 默认的开播的VideoLiveSession

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`adjustEncoderBitrate(int bitRate)`
`void`	`enableColorChartLive(boolean enable)` 色卡开播，参数设为true时，观看端看到的是色卡，主播段不变。
`void`	`enableMirror(boolean enable)` 镜像开关设置
`boolean`	`isHardwareEncoderAvailable()` 获取是否允许硬编开播
`void`	`onDualOpen(boolean flag)`
`void`	`onDualPictureSwitch()` 双摄开播大小画面切换
`void`	`onEncodeEncParam(java.lang.String param)` sdk内部编码参数通知.
`void`	`onEncodeFirstFrame()` 编码头一帧回调接口.
`void`	`onEncodeFrameData(byte[] data, int len, long pts, long dts, int frameType, VideoEncoderType encodeType, int svcTid, int svcSid)` 编码后一帧视频数据的输出回调函数.
`void`	`onEncodeResolution(int width, int height)` 实际编码的分辨率回调接口，每3秒钟回调一次.
`void`	`onEncoderSwitch()` 切换视频编码器
`void`	`onEncodeStat(int bitRate, int frameRate)` 编码码率，帧率统计数据回调接口, 每3秒钟回调一次.
`void`	`onExternalVideoEnd()`
`void`	`onHardEncoderError()` 硬编出错，通知上层禁用硬编
`void`	`onOutdoorVideoConfigReceived(DecodeVideoConfig config)`
`void`	`onOutdoorVideoDataReceived(DecodeVideoSample sample)` 收到户外的视频数据
`void`	`onPeripheralsVideoConfigReceived(DecodeVideoConfig config)`
`void`	`onPeripheralsVideoDataReceived(DecodeVideoSample sample)` 收到外设的视频数据
`void`	`onPeripheralsVideoEnd()`
`void`	`onSurfaceInfoEvent(int evtType, AbstractSurfaceInfo surfaceInfo)` 此函数不要做太多事情, 因为可能VideoLiveSession正在被调用StopAndRelease, 会有一些线程同步的问题.
`void`	`onWaterMarkSizeChange(int w, int h)` 切换弱网之后，编码分辨率变更，需要变换水印的坐标和宽高
`void`	`registerPreviewCallback(PreviewFrameCallback callback)`
`void`	`requestIFrame()`
`void`	`setBackground(Background background)`
`void`	`setDeltaYYPtsMillions(long deltaPtsDts)`
`void`	`setDynamicTexture(IDynamicTexture dynamicTexture)`
`void`	`setEncoderConfig(VideoEncoderConfig config)` 配置编码器(软编硬编都需要配置)
`void`	`setEncoderListener(IEncoderListener listener)`
`void`	`setExternalCameraDataCallback(ExternalInterface.IExternalCameraData IExternalCameraData)`
`void`	`setExternalDecodeInterface(ExternalInterface.IExternalDecode IExternalDecode)`
`void`	`setExtraPerformance(Constant.ExtraPerformance extraPerformance, java.lang.Boolean on, int value)`
`void`	`setFilterInfo(FilterType filterType, java.util.Map<java.lang.String,java.lang.String> params)`
`void`	`setFilterType(FilterType filterType)`
`void`	`setGLManagerRunnable(java.lang.Runnable runnable)`
`void`	`setGPUImageBeautyFilter(IGPUProcess gpuImageProcess)`
`void`	`setHardwareEncoderAvailable(boolean available)` 设置是否允许硬编开播
`void`	`setLowDelayMode(boolean enable)`
`void`	`setNetworkBitrateSuggest(int bitrate)`
`void`	`setResolutionModifyConfigs(java.util.List<ResolutionModifyConfig> configs, int intervalSecs)`
`void`	`setScreenShot(ScreenShot screenShot)`
`void`	`setSessionLiveMode(LiveSessionType type)`
`void`	`setSurfaceChanged(int w, int h)` 在3人连麦的场景会直接变更cameraSurfaceView的大小，导致中间出现一个onsurfaceChange和实际执行handlerSurfacechanged之间有时间差，大约500ms，导致出现画面异常，此接口只在3人竞技场的时候调用
`void`	`setUserLiveConfig(YYUserLiveConfig userLiveConfig)` 不频繁调用，且销毁内存不多，所以每次调用copy一个新的config，以防线程竞争.
`void`	`setVideoRenderPostion(VideoRenderPosition position)`
`void`	`setWaterMark(android.graphics.Bitmap bitmap, int offsetX, int offsetY)`
`void`	`setWaterMark(WaterMark waterMark)`
`void`	`startEncodeExternalData(YYMediaSample sample)`
`void`	`startEncoder()` 启动编码器
`void`	`startPreview(int previewWidth, int previewHeight, int cameraFacing, CameraInterface.CameraResolutionMode resMode)`
`void`	`startRvSensor()` 注册旋转矢量传感器
`void`	`stopAndRelease()`
`void`	`stopEncoder()` 关闭编码器
`void`	`stopRvSensor()` 反注册旋转矢量传感器
`void`	`takeScreenShot(ScreenShotCallback callback)` 设置截屏回调接口.
`void`	`unregisterPreviewCallback(PreviewFrameCallback callback)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - mPeripheralsDecoderFilter
```
public PeripheralsDecoderFilter mPeripheralsDecoderFilter
```
    PeripheralsDecoderFilter --> CameraCaptureFilter-->VideoLiveQualityFilter -->GPUPreprocessFilter--> ClipFilter--> -->PreviewFilter -->VideoEncoderGroupFilter-->TransmitUploadFilter
  - mExternalDecoderFilter
```
public ExternalDecoderFilter mExternalDecoderFilter
```
  - mCaptureFilter
```
public CameraCaptureFilter mCaptureFilter
```
  - mPreprocessFilter
```
public GPUPreprocessFilter mPreprocessFilter
```
  - mCliperFilter
```
public ClipFilter mCliperFilter
```
  - mPreviewFilter
```
public PreviewFilter mPreviewFilter
```
  - mEncoderGroupFilter
```
public VideoEncoderGroupFilter mEncoderGroupFilter
```
  - mFilterContext
```
public VideoLiveFilterContext mFilterContext
```
  - mEndPointFilter
```
public VideoEndPointFilter mEndPointFilter
```
- Constructor Detail
  - VideoLiveSession
```
public VideoLiveSession(android.content.Context context)
```
    默认的开播的VideoLiveSession
- Method Detail
  - startPreview
```
public void startPreview(int previewWidth,
                         int previewHeight,
                         int cameraFacing,
                         CameraInterface.CameraResolutionMode resMode)
```
  - stopAndRelease
```
public void stopAndRelease()
```
    Specified by:
    
    stopAndRelease in interface ILiveSession
  - startEncoder
```
public void startEncoder()
```
    Description copied from interface: ILiveSession
    
    启动编码器
    
    Specified by:
    
    startEncoder in interface ILiveSession
  - stopEncoder
```
public void stopEncoder()
```
    Description copied from interface: ILiveSession
    
    关闭编码器
    
    Specified by:
    
    stopEncoder in interface ILiveSession
  - onSurfaceInfoEvent
```
public void onSurfaceInfoEvent(int evtType,
                               AbstractSurfaceInfo surfaceInfo)
```
    此函数不要做太多事情, 因为可能VideoLiveSession正在被调用StopAndRelease, 会有一些线程同步的问题. 目前此函数中只是向 VideoLiveSession 和 glmanager线程post消息, 最多只是post消息时候产生的异常, 已经被catch住了.
    
    Specified by:
    
    onSurfaceInfoEvent in interface IYYVideoSurfaceInfoListener
    
    Parameters:
    
    evtType -
    
    surfaceInfo -
  - setScreenShot
```
public void setScreenShot(ScreenShot screenShot)
```
  - setFilterInfo
```
public void setFilterInfo(FilterType filterType,
                          java.util.Map<java.lang.String,java.lang.String> params)
```
  - setFilterType
```
public void setFilterType(FilterType filterType)
```
  - setWaterMark
```
public void setWaterMark(WaterMark waterMark)
```
  - setBackground
```
public void setBackground(Background background)
```
  - setDynamicTexture
```
public void setDynamicTexture(IDynamicTexture dynamicTexture)
```
    Specified by:
    
    setDynamicTexture in interface ILiveSession
  - takeScreenShot
```
public void takeScreenShot(ScreenShotCallback callback)
```
    设置截屏回调接口.
    
    Specified by:
    
    takeScreenShot in interface ILiveSession
    
    Parameters:
    
    callback - 截屏回调接口，详细见 ScreenShotCallback
  - setNetworkBitrateSuggest
```
public void setNetworkBitrateSuggest(int bitrate)
```
    Specified by:
    
    setNetworkBitrateSuggest in interface ILiveSession
  - setResolutionModifyConfigs
```
public void setResolutionModifyConfigs(java.util.List<ResolutionModifyConfig> configs,
                                       int intervalSecs)
```
    Specified by:
    
    setResolutionModifyConfigs in interface ILiveSession
  - setEncoderListener
```
public void setEncoderListener(IEncoderListener listener)
```
    Specified by:
    
    setEncoderListener in interface ILiveSession
  - setEncoderConfig
```
public void setEncoderConfig(VideoEncoderConfig config)
```
    Description copied from interface: ILiveSession
    
    配置编码器(软编硬编都需要配置)
    
    Specified by:
    
    setEncoderConfig in interface ILiveSession
  - setLowDelayMode
```
public void setLowDelayMode(boolean enable)
```
    Specified by:
    
    setLowDelayMode in interface ILiveSession
  - adjustEncoderBitrate
```
public void adjustEncoderBitrate(int bitRate)
```
    Specified by:
    
    adjustEncoderBitrate in interface ILiveSession
  - onEncodeStat
```
public void onEncodeStat(int bitRate,
                         int frameRate)
```
    Description copied from interface: IEncoderListener
    
    编码码率，帧率统计数据回调接口, 每3秒钟回调一次.
    
    Specified by:
    
    onEncodeStat in interface IEncoderListener
    
    Parameters:
    
    bitRate - 实际编码输出的码率.
    
    frameRate - 实际编码输出的帧率.
  - onEncodeResolution
```
public void onEncodeResolution(int width,
                               int height)
```
    Description copied from interface: IEncoderListener
    
    实际编码的分辨率回调接口，每3秒钟回调一次.
    
    Specified by:
    
    onEncodeResolution in interface IEncoderListener
    
    Parameters:
    
    width - 实际编码分辨率宽度
    
    height - 实际编码分辨率高度.
  - onEncodeFirstFrame
```
public void onEncodeFirstFrame()
```
    Description copied from interface: IEncoderListener
    
    编码头一帧回调接口.
    
    Specified by:
    
    onEncodeFirstFrame in interface IEncoderListener
  - onHardEncoderError
```
public void onHardEncoderError()
```
    Description copied from interface: IEncoderListener
    
    硬编出错，通知上层禁用硬编
    
    Specified by:
    
    onHardEncoderError in interface IEncoderListener
  - onEncodeFrameData
```
public void onEncodeFrameData(byte[] data,
                              int len,
                              long pts,
                              long dts,
                              int frameType,
                              VideoEncoderType encodeType,
                              int svcTid,
                              int svcSid)
```
    Description copied from interface: IEncoderListener
    
    编码后一帧视频数据的输出回调函数.
    
    Specified by:
    
    onEncodeFrameData in interface IEncoderListener
    
    Parameters:
    
    data - 编码后的视频数据
    
    len - 视频数据的长度
    
    pts - 视频数据的pts, 单位是ms
    
    dts - 视频数据的dts, 单位是ms
    
    frameType - 视频数据的帧类型，YY系统中的帧类型取值一样.
    
    encodeType - 视频数据的编码类型，这里是开播SDK中定义的encodeType，特别提醒这里和yysdk中传输定义的encodeType有不同.
  - onEncodeEncParam
```
public void onEncodeEncParam(java.lang.String param)
```
    Description copied from interface: IEncoderListener
    
    sdk内部编码参数通知.
    
    Specified by:
    
    onEncodeEncParam in interface IEncoderListener
    
    Parameters:
    
    param - 编码参数,一般用于调试打印在屏幕，或者统计等等.
  - onEncoderSwitch
```
public void onEncoderSwitch()
```
    Description copied from interface: IEncoderListener
    
    切换视频编码器
    
    Specified by:
    
    onEncoderSwitch in interface IEncoderListener
  - onWaterMarkSizeChange
```
public void onWaterMarkSizeChange(int w,
                                  int h)
```
    Description copied from interface: IEncoderListener
    
    切换弱网之后，编码分辨率变更，需要变换水印的坐标和宽高
    
    Specified by:
    
    onWaterMarkSizeChange in interface IEncoderListener
  - requestIFrame
```
public void requestIFrame()
```
    Specified by:
    
    requestIFrame in interface ILiveSession
  - setUserLiveConfig
```
public void setUserLiveConfig(YYUserLiveConfig userLiveConfig)
```
    不频繁调用，且销毁内存不多，所以每次调用copy一个新的config，以防线程竞争. 类似copy-on-write的概念.
    
    Parameters:
    
    userLiveConfig -
  - enableColorChartLive
```
public void enableColorChartLive(boolean enable)
```
    色卡开播，参数设为true时，观看端看到的是色卡，主播段不变。
    
    Parameters:
    
    enable -
  - onDualPictureSwitch
```
public void onDualPictureSwitch()
```
    双摄开播大小画面切换
  - onDualOpen
```
public void onDualOpen(boolean flag)
```
  - enableMirror
```
public void enableMirror(boolean enable)
```
    镜像开关设置
    
    Parameters:
    
    enable -
  - setHardwareEncoderAvailable
```
public void setHardwareEncoderAvailable(boolean available)
```
    Description copied from interface: ILiveSession
    
    设置是否允许硬编开播
    
    Specified by:
    
    setHardwareEncoderAvailable in interface ILiveSession
  - isHardwareEncoderAvailable
```
public boolean isHardwareEncoderAvailable()
```
    Description copied from interface: ILiveSession
    
    获取是否允许硬编开播
    
    Specified by:
    
    isHardwareEncoderAvailable in interface ILiveSession
  - setSurfaceChanged
```
public void setSurfaceChanged(int w,
                              int h)
```
    在3人连麦的场景会直接变更cameraSurfaceView的大小，导致中间出现一个onsurfaceChange和实际执行handlerSurfacechanged之间有时间差，大约500ms，导致出现画面异常，此接口只在3人竞技场的时候调用
  - onPeripheralsVideoDataReceived
```
public void onPeripheralsVideoDataReceived(DecodeVideoSample sample)
```
    收到外设的视频数据
  - onPeripheralsVideoConfigReceived
```
public void onPeripheralsVideoConfigReceived(DecodeVideoConfig config)
```
  - onOutdoorVideoDataReceived
```
public void onOutdoorVideoDataReceived(DecodeVideoSample sample)
```
    收到户外的视频数据
  - onOutdoorVideoConfigReceived
```
public void onOutdoorVideoConfigReceived(DecodeVideoConfig config)
```
  - onPeripheralsVideoEnd
```
public void onPeripheralsVideoEnd()
```
  - onExternalVideoEnd
```
public void onExternalVideoEnd()
```
  - setSessionLiveMode
```
public void setSessionLiveMode(LiveSessionType type)
```
  - setVideoRenderPostion
```
public void setVideoRenderPostion(VideoRenderPosition position)
```
  - startRvSensor
```
public void startRvSensor()
```
    注册旋转矢量传感器
  - stopRvSensor
```
public void stopRvSensor()
```
    反注册旋转矢量传感器
  - setDeltaYYPtsMillions
```
public void setDeltaYYPtsMillions(long deltaPtsDts)
```
  - registerPreviewCallback
```
public void registerPreviewCallback(PreviewFrameCallback callback)
```
  - unregisterPreviewCallback
```
public void unregisterPreviewCallback(PreviewFrameCallback callback)
```
  - setExternalCameraDataCallback
```
public void setExternalCameraDataCallback(ExternalInterface.IExternalCameraData IExternalCameraData)
```
  - setExternalDecodeInterface
```
public void setExternalDecodeInterface(ExternalInterface.IExternalDecode IExternalDecode)
```
  - startEncodeExternalData
```
public void startEncodeExternalData(YYMediaSample sample)
```
  - setGLManagerRunnable
```
public void setGLManagerRunnable(java.lang.Runnable runnable)
```
  - setExtraPerformance
```
public void setExtraPerformance(Constant.ExtraPerformance extraPerformance,
                                java.lang.Boolean on,
                                int value)
```
  - setGPUImageBeautyFilter
```
public void setGPUImageBeautyFilter(IGPUProcess gpuImageProcess)
```
  - setWaterMark
```
public void setWaterMark(android.graphics.Bitmap bitmap,
                         int offsetX,
                         int offsetY)
```
    Specified by:
    
    setWaterMark in interface ILiveSession

Class VideoLiveSession

Field Summary

Fields inherited from interface com.yy.mediaframework.IYYVideoSurfaceInfoListener

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

mPeripheralsDecoderFilter

mExternalDecoderFilter

mCaptureFilter

mPreprocessFilter

mCliperFilter

mPreviewFilter

mEncoderGroupFilter

mFilterContext

mEndPointFilter

Constructor Detail

VideoLiveSession

Method Detail

startPreview

stopAndRelease

startEncoder

stopEncoder

onSurfaceInfoEvent

setScreenShot

setFilterInfo

setFilterType

setWaterMark

setBackground

setDynamicTexture

takeScreenShot

setNetworkBitrateSuggest

setResolutionModifyConfigs

setEncoderListener

setEncoderConfig

setLowDelayMode

adjustEncoderBitrate

onEncodeStat

onEncodeResolution

onEncodeFirstFrame

onHardEncoderError

onEncodeFrameData

onEncodeEncParam

onEncoderSwitch

onWaterMarkSizeChange

requestIFrame

setUserLiveConfig

enableColorChartLive

onDualPictureSwitch

onDualOpen

enableMirror

setHardwareEncoderAvailable

isHardwareEncoderAvailable

setSurfaceChanged

onPeripheralsVideoDataReceived

onPeripheralsVideoConfigReceived

onOutdoorVideoDataReceived

onOutdoorVideoConfigReceived

onPeripheralsVideoEnd

onExternalVideoEnd

setSessionLiveMode

setVideoRenderPostion

startRvSensor

stopRvSensor

setDeltaYYPtsMillions

registerPreviewCallback

unregisterPreviewCallback

setExternalCameraDataCallback

setExternalDecodeInterface

startEncodeExternalData

setGLManagerRunnable

setExtraPerformance

setGPUImageBeautyFilter

setWaterMark