YMFExternalTextureSessionYCloud (yyvideolib 200.2.9.14.2 API)

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

All Implemented Interfaces:: IEncoderListener, ILiveSession, IMediaCodecUpload

public class YMFExternalTextureSessionYCloud
extends java.lang.Object
implements IEncoderListener, ILiveSession, IMediaCodecUpload

Field Summary

Fields
Modifier and Type	Field and Description
`ClipFilter`	`mCliperFilter` PeripheralsDecoderFilter --> CameraCaptureFilter-->VideoLiveQualityFilter -->GPUPreprocessFilter--> ClipFilter--> -->PreviewFilter -->VideoEncoderGroupFilter-->TransmitUploadFilter
`VideoEncoderGroupFilter`	`mEncoderGroupFilter`
`VideoEndPointFilter`	`mEndPointFilter`
`VideoLiveFilterContext`	`mFilterContext`

Constructor Summary

Constructors
Constructor and Description
`YMFExternalTextureSessionYCloud(android.content.Context context, int type, java.lang.Object sharedContext)` 默认的开播的VideoLiveSession2

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`adjustEncoderBitrate(int bitRate)`
`void`	`assignEncoderConfig(VideoEncoderConfig config)` 仅仅对齐开播参数，在没开始编码的时候调用，这样可以确保预览和开启编码时候的预览，裁剪的大小一致，不会跳变
`void`	`enableColorChartLive(boolean enable)` 色卡开播，参数设为true时，观看端看到的是色卡，主播段不变。
`void`	`enableMirror(boolean enable)` 镜像开关设置
`boolean`	`getExternalType()`
`void`	`initOriginDataFilter()`
`boolean`	`isHardwareEncoderAvailable()` 获取是否允许硬编开播
`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`	`onPeripheralsVideoConfigReceived(DecodeVideoConfig config)` 视频头信息，包括高宽，sps和pps
`void`	`onPeripheralsVideoDataReceived(DecodeVideoSample sample)` 收到外设的视频数据
`void`	`onPeripheralsVideoEnd()` 结束视频流
`void`	`onWaterMarkSizeChange(int w, int h)` 切换弱网之后，编码分辨率变更，需要变换水印的坐标和宽高
`void`	`pushEncodeExternalData(ExternalYYMediaSample externalYYMediaSample)` 外部数据推送编码数据的接口
`void`	`pushExternalVideoDecodeInfo(ExternalDecodeInfo info)` 收到户外的视频数据
`void`	`requestIFrame()` 强制编码I帧接口.
`void`	`setAbroadNetWorkStrategy(boolean flag)`
`void`	`setBackground(Background background)`
`void`	`setDeltaYYPtsMillions(long deltaPtsDts)` 设置PTS同步矫正, 矫正值根据传输设置，客户端回调到sdk
`void`	`setDynamicTexture(IDynamicTexture dynamicTexture)` 设置动态贴图接口.
`void`	`setEnableUnderflowStrategy(boolean flag)`
`void`	`setEncoderConfig(VideoEncoderConfig config)` 设置编码参数，此接口startEncoder在调用之前, 之后都可以使用.
`void`	`setEncoderListener(IEncoderListener listener)` 设置编码的回调接口，回调事件包含编码后的视频数据，视频质量统计数据等.
`void`	`setExternalDecodeInterface(ExternalInterface.IExternalDecode IExternalDecode)` 给外部数据设置解码接口
`void`	`setExternalVideoInterface(ExternalInterface.IExternalCameraData IExternalCameraData)` 给外部数据设置接口
`void`	`setGLManagerRunnable(java.lang.Runnable runnable)` 将操作post回gl线程
`void`	`setHardwareEncoderAvailable(boolean available)` 设置本机型是否可以开启硬编
`void`	`setLowDelayMode(boolean enable)`
`void`	`setNetworkBitrateSuggest(int bitrate)` 设置网络传输层建议码率接口.
`void`	`setOriginFrameToEncode(byte[] data, int format, int width, int height, int rotation, long timestamp)`
`void`	`setOriginTextureToEncode(int inputTexture, int textureTarget, float[] transformer, int width, int height, long timestamp, int rotation)`
`void`	`setResolutionModifyConfigs(java.util.List<ResolutionModifyConfig> configs, int intervalSecs)` 设置动态编码分辨率的参数集合即可.
`void`	`setVideoRenderPosition(VideoRenderPosition position)` 设置视频位置信息
`void`	`setWaterMark(android.graphics.Bitmap bitmap, int offsetX, int offsetY)` 设置水印接口.
`void`	`setWaterMark(WaterMark waterMark)`
`void`	`startEncoder()` 开启编码接口, 如果预先没有设置编码参数，则按照默认的编码参数进行编码，否则按照之前设置的编码参数进行编码.
`void`	`stopAndRelease()`
`void`	`stopEncoder()` 停止编码接口.
`void`	`takeScreenShot(ScreenShotCallback callback)`

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

- Field Detail
  - mCliperFilter
```
public ClipFilter mCliperFilter
```
    PeripheralsDecoderFilter --> CameraCaptureFilter-->VideoLiveQualityFilter -->GPUPreprocessFilter--> ClipFilter--> -->PreviewFilter -->VideoEncoderGroupFilter-->TransmitUploadFilter
  - mEncoderGroupFilter
```
public VideoEncoderGroupFilter mEncoderGroupFilter
```
  - mFilterContext
```
public VideoLiveFilterContext mFilterContext
```
  - mEndPointFilter
```
public VideoEndPointFilter mEndPointFilter
```
- Constructor Detail
  - YMFExternalTextureSessionYCloud
```
public YMFExternalTextureSessionYCloud(android.content.Context context,
                                       int type,
                                       java.lang.Object sharedContext)
```
    默认的开播的VideoLiveSession2
- Method Detail
  - stopAndRelease
```
public void stopAndRelease()
```
    Specified by:
    
    stopAndRelease in interface ILiveSession
  - setDeltaYYPtsMillions
```
public void setDeltaYYPtsMillions(long deltaPtsDts)
```
    设置PTS同步矫正, 矫正值根据传输设置，客户端回调到sdk
    
    Parameters:
    
    deltaPtsDts - 单位ms
  - getExternalType
```
public boolean getExternalType()
```
  - setWaterMark
```
public void setWaterMark(WaterMark waterMark)
```
    Specified by:
    
    setWaterMark in interface IMediaCodecUpload
  - startEncoder
```
public void startEncoder()
```
    开启编码接口, 如果预先没有设置编码参数，则按照默认的编码参数进行编码，否则按照之前设置的编码参数进行编码.
    
    Specified by:
    
    startEncoder in interface ILiveSession
    
    Specified by:
    
    startEncoder in interface IMediaCodecUpload
  - stopEncoder
```
public void stopEncoder()
```
    停止编码接口. 调用此接口后，开播SDK不再编码，开播预览不受影响.
    
    Specified by:
    
    stopEncoder in interface ILiveSession
    
    Specified by:
    
    stopEncoder in interface IMediaCodecUpload
  - setWaterMark
```
public void setWaterMark(android.graphics.Bitmap bitmap,
                         int offsetX,
                         int offsetY)
```
    设置水印接口.
    
    Specified by:
    
    setWaterMark in interface ILiveSession
    
    Parameters:
    
    bitmap - 水印参数，详细见 WaterMark
  - setBackground
```
public void setBackground(Background background)
```
    Specified by:
    
    setBackground in interface IMediaCodecUpload
  - setDynamicTexture
```
public void setDynamicTexture(IDynamicTexture dynamicTexture)
```
    设置动态贴图接口.
    
    Specified by:
    
    setDynamicTexture in interface ILiveSession
    
    Specified by:
    
    setDynamicTexture in interface IMediaCodecUpload
    
    Parameters:
    
    dynamicTexture - 动态贴图参数，详细见 IDynamicTexture
  - setNetworkBitrateSuggest
```
public void setNetworkBitrateSuggest(int bitrate)
```
    设置网络传输层建议码率接口.
    
    Specified by:
    
    setNetworkBitrateSuggest in interface ILiveSession
    
    Specified by:
    
    setNetworkBitrateSuggest in interface IMediaCodecUpload
    
    Parameters:
    
    bitrate - 建议码率，单位为bps.
  - setResolutionModifyConfigs
```
public void setResolutionModifyConfigs(java.util.List<ResolutionModifyConfig> configs,
                                       int intervalSecs)
```
    设置动态编码分辨率的参数集合即可. 当网络信号不太好，或者机器性能差等情况下，原来预设定的编码分辨率不能达到好的编码效果，SDK会内部动态调整编码分辨率. 一般情况是从高分辨率调低到低的编码分辨率.
    SDK内部调整编码分辨率，是首先设定几个档位区间，分别对应这各种编码分辨率大小，然后逐步降档来实现的. 应用可以通过服务器下发配置控制调整的分辨率的最大，最小值等参数，以达到部分配置动态控制的目的.
    
    Specified by:
    
    setResolutionModifyConfigs in interface ILiveSession
    
    Parameters:
    
    configs - 动态分辨率控制参数，具体见 ResolutionModifyConfig
    
    intervalSecs - 动态调整的检测时长，也即每检测时长，做一次动态调整的判断.
  - setEncoderListener
```
public void setEncoderListener(IEncoderListener listener)
```
    设置编码的回调接口，回调事件包含编码后的视频数据，视频质量统计数据等.
    
    Specified by:
    
    setEncoderListener in interface ILiveSession
    
    Specified by:
    
    setEncoderListener in interface IMediaCodecUpload
    
    Parameters:
    
    listener - 回调接口，详细见 IEncoderListener
  - assignEncoderConfig
```
public void assignEncoderConfig(VideoEncoderConfig config)
```
    仅仅对齐开播参数，在没开始编码的时候调用，这样可以确保预览和开启编码时候的预览，裁剪的大小一致，不会跳变
    
    Parameters:
    
    config - 编码参数，详细见 VideoEncoderConfig
  - setEncoderConfig
```
public void setEncoderConfig(VideoEncoderConfig config)
```
    设置编码参数，此接口startEncoder在调用之前, 之后都可以使用. 在调用之前，则开始编码时按照设置的参数编码，之后调用（也即已经在编码了）, sdk会自动检测编码参数中的更改，从而重置编码器.
    
    Specified by:
    
    setEncoderConfig in interface ILiveSession
    
    Specified by:
    
    setEncoderConfig in interface IMediaCodecUpload
    
    Parameters:
    
    config - 编码参数，详细见 VideoEncoderConfig
  - 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
  - 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 - 编码参数,一般用于调试打印在屏幕，或者统计等等.
  - onHardEncoderError
```
public void onHardEncoderError()
```
    Description copied from interface: IEncoderListener
    
    硬编出错，通知上层禁用硬编
    
    Specified by:
    
    onHardEncoderError in interface IEncoderListener
  - 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()
```
    强制编码I帧接口.
    
    Specified by:
    
    requestIFrame in interface ILiveSession
  - enableColorChartLive
```
public void enableColorChartLive(boolean enable)
```
    色卡开播，参数设为true时，观看端看到的是色卡，主播段不变。
    
    Parameters:
    
    enable -
  - enableMirror
```
public void enableMirror(boolean enable)
```
    镜像开关设置
    
    Parameters:
    
    enable -
  - setHardwareEncoderAvailable
```
public void setHardwareEncoderAvailable(boolean available)
```
    设置本机型是否可以开启硬编
    
    Specified by:
    
    setHardwareEncoderAvailable in interface ILiveSession
    
    Parameters:
    
    available - true 表示可以硬编，false表示不能硬编
  - isHardwareEncoderAvailable
```
public boolean isHardwareEncoderAvailable()
```
    Description copied from interface: ILiveSession
    
    获取是否允许硬编开播
    
    Specified by:
    
    isHardwareEncoderAvailable in interface ILiveSession
  - setGLManagerRunnable
```
public void setGLManagerRunnable(java.lang.Runnable runnable)
```
    将操作post回gl线程
    
    Specified by:
    
    setGLManagerRunnable in interface IMediaCodecUpload
    
    Parameters:
    
    runnable -
  - initOriginDataFilter
```
public void initOriginDataFilter()
```
  - setOriginFrameToEncode
```
public void setOriginFrameToEncode(byte[] data,
                                   int format,
                                   int width,
                                   int height,
                                   int rotation,
                                   long timestamp)
```
  - setOriginTextureToEncode
```
public void setOriginTextureToEncode(int inputTexture,
                                     int textureTarget,
                                     float[] transformer,
                                     int width,
                                     int height,
                                     long timestamp,
                                     int rotation)
```
  - setAbroadNetWorkStrategy
```
public void setAbroadNetWorkStrategy(boolean flag)
```
  - onPeripheralsVideoDataReceived
```
public void onPeripheralsVideoDataReceived(DecodeVideoSample sample)
```
    Description copied from interface: IMediaCodecUpload
    
    收到外设的视频数据
    
    Specified by:
    
    onPeripheralsVideoDataReceived in interface IMediaCodecUpload
    
    Parameters:
    
    sample - 视频数据结构
  - onPeripheralsVideoConfigReceived
```
public void onPeripheralsVideoConfigReceived(DecodeVideoConfig config)
```
    Description copied from interface: IMediaCodecUpload
    
    视频头信息，包括高宽，sps和pps
    
    Specified by:
    
    onPeripheralsVideoConfigReceived in interface IMediaCodecUpload
  - onPeripheralsVideoEnd
```
public void onPeripheralsVideoEnd()
```
    Description copied from interface: IMediaCodecUpload
    
    结束视频流
    
    Specified by:
    
    onPeripheralsVideoEnd in interface IMediaCodecUpload
  - setVideoRenderPosition
```
public void setVideoRenderPosition(VideoRenderPosition position)
```
    Description copied from interface: IMediaCodecUpload
    
    设置视频位置信息
    
    Specified by:
    
    setVideoRenderPosition in interface IMediaCodecUpload
  - onExternalVideoEnd
```
public void onExternalVideoEnd()
```
    Description copied from interface: IMediaCodecUpload
    
    结束户外视频流
    
    Specified by:
    
    onExternalVideoEnd in interface IMediaCodecUpload
  - pushExternalVideoDecodeInfo
```
public void pushExternalVideoDecodeInfo(ExternalDecodeInfo info)
```
    Description copied from interface: IMediaCodecUpload
    
    收到户外的视频数据
    
    Specified by:
    
    pushExternalVideoDecodeInfo in interface IMediaCodecUpload
    
    Parameters:
    
    info - 视频数据结构
  - setExternalVideoInterface
```
public void setExternalVideoInterface(ExternalInterface.IExternalCameraData IExternalCameraData)
```
    Description copied from interface: IMediaCodecUpload
    
    给外部数据设置接口
    
    Specified by:
    
    setExternalVideoInterface in interface IMediaCodecUpload
  - setExternalDecodeInterface
```
public void setExternalDecodeInterface(ExternalInterface.IExternalDecode IExternalDecode)
```
    Description copied from interface: IMediaCodecUpload
    
    给外部数据设置解码接口
    
    Specified by:
    
    setExternalDecodeInterface in interface IMediaCodecUpload
  - takeScreenShot
```
public void takeScreenShot(ScreenShotCallback callback)
```
    Specified by:
    
    takeScreenShot in interface ILiveSession
    
    Specified by:
    
    takeScreenShot in interface IMediaCodecUpload
  - pushEncodeExternalData
```
public void pushEncodeExternalData(ExternalYYMediaSample externalYYMediaSample)
```
    Description copied from interface: IMediaCodecUpload
    
    外部数据推送编码数据的接口
    
    Specified by:
    
    pushEncodeExternalData in interface IMediaCodecUpload
  - setEnableUnderflowStrategy
```
public void setEnableUnderflowStrategy(boolean flag)
```

Class YMFExternalTextureSessionYCloud

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

mCliperFilter

mEncoderGroupFilter

mFilterContext

mEndPointFilter

Constructor Detail

YMFExternalTextureSessionYCloud

Method Detail

stopAndRelease

setDeltaYYPtsMillions

getExternalType

setWaterMark

startEncoder

stopEncoder

setWaterMark

setBackground

setDynamicTexture

setNetworkBitrateSuggest

setResolutionModifyConfigs

setEncoderListener

assignEncoderConfig

setEncoderConfig

setLowDelayMode

adjustEncoderBitrate

onEncodeStat

onEncodeResolution

onEncodeFirstFrame

onEncodeFrameData

onEncodeEncParam

onHardEncoderError

onEncoderSwitch

onWaterMarkSizeChange

requestIFrame

enableColorChartLive

enableMirror

setHardwareEncoderAvailable

isHardwareEncoderAvailable

setGLManagerRunnable

initOriginDataFilter

setOriginFrameToEncode

setOriginTextureToEncode

setAbroadNetWorkStrategy

onPeripheralsVideoDataReceived

onPeripheralsVideoConfigReceived

onPeripheralsVideoEnd

setVideoRenderPosition

onExternalVideoEnd

pushExternalVideoDecodeInfo

setExternalVideoInterface

setExternalDecodeInterface

takeScreenShot

pushEncodeExternalData

setEnableUnderflowStrategy