com.wowza.gocoder.sdk.api.broadcast

Class WZGLBroadcaster

java.lang.Object

com.wowza.gocoder.sdk.support.encoder.H264Encoder

com.wowza.gocoder.sdk.api.broadcast.WZH264Broadcaster

com.wowza.gocoder.sdk.api.broadcast.WZGLBroadcaster

All Implemented Interfaces:

WZBroadcastAPI.AdaptiveBroadcaster, WZBroadcastAPI.Broadcaster, WZBroadcastAPI.VideoBroadcaster, Runnable

public class WZGLBroadcaster
extends WZH264Broadcaster

This class can be used to integrate the GoCoder SDK into an existing application's OpenGL ES-based rendering pipeline to broadcast content from sources other than WZCameraView

Constructor Summary

Constructors

Constructor and Description
WZGLBroadcaster() Construct a new instance
WZGLBroadcaster(EGLContext eglContext) Construct a new instance specifying a shared EGLContext to use when creating OpenGL ES resources on the video encoder's thread
WZGLBroadcaster(EGLContext eglContext, EGLSurface eglSurface)

Method Summary

Modifier and Type	Method and Description
EGLSurface	generateEglSuface(Surface sourceSurface) Utility function to wrap a Surface instance with an EGLSurface.
EGLContext	getEglContext()
EGLSurface	getEglSurface()
WZRenderAPI.VideoFrameRenderer	getVideoFrameRenderer()
void	onFrameAvailable() Call to notify the broadcaster that a new frame is available for capture.
void	onFrameAvailable(long frameTimestampNs) Call to notify the broadcaster that a new frame is available for capture with the specified timestamp.
void	setEglContext(EGLContext eglContext)
void	setEglSurface(EGLSurface eglSurface) Set a EGLSurface instance to use for direct copy operations that has been created on the EGLContext supplied in the constructor for this instance or in a call to setEglContext(EGLContext)
void	setFrameRotation(int frameRotation) Call to notify the broadcaster of a change in the video source's orientation during a broadcast.
void	setFrameSize(int frameWidth, int frameHeight) Call to notify the broadcaster of a change in the video source's frame size during a broadcast such as when a device's orientation changes (e.g from portrait to landscape)
void	setVideoFrameRenderer(WZRenderAPI.VideoFrameRenderer videoFrameRenderer) Specify an instance implementing the WZRenderAPI.VideoFrameRenderer interface to call when a frame is available that will render the frame content to this broadcaster's encoder's input surface.

Methods inherited from class com.wowza.gocoder.sdk.api.broadcast.WZH264Broadcaster

getBroadcastConfig, getBroadcasterStatus, getStatus, getVideoSourceConfig, isVideoEnabled, isVideoPaused, prepareForBroadcast, setVideoEnabled, setVideoPaused, startBroadcasting, stopBroadcasting

Methods inherited from class com.wowza.gocoder.sdk.support.encoder.H264Encoder

changeAdaptiveBitrate, changeAdaptiveFramerate, encodeInputSurfaceContents, flushEncoder, getAdaptiveBitrate, getAdaptiveFramerate, getEglEnv, getEncoderConfig, getEncoderInputSurface, getMediaCodecName, getMediaFormatDescription, hasFrameRateIntervalElapsed, onEncodeInputSurfaceContents, onFrameSubmittedToEncoder, onFrameSubmittedToEncoder, run, runOnEncoderThread, setSharedContext

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

WZGLBroadcaster

public WZGLBroadcaster(EGLContext eglContext,
                       EGLSurface eglSurface)

WZGLBroadcaster

public WZGLBroadcaster(EGLContext eglContext)

Construct a new instance specifying a shared EGLContext to use when creating OpenGL ES resources on the video encoder's thread

Parameters:

eglContext - a shared EGLContext to use when creating OpenGL ES resources on the video encoder's thread

WZGLBroadcaster

public WZGLBroadcaster()

Construct a new instance

Method Detail

getVideoFrameRenderer

public WZRenderAPI.VideoFrameRenderer getVideoFrameRenderer()

Returns:

the WZRenderAPI.VideoFrameRenderer last specified in a call to setVideoFrameRenderer(WZRenderAPI.VideoFrameRenderer)

setVideoFrameRenderer

public void setVideoFrameRenderer(WZRenderAPI.VideoFrameRenderer videoFrameRenderer)

Specify an instance implementing the WZRenderAPI.VideoFrameRenderer interface to call when a frame is available that will render the frame content to this broadcaster's encoder's input surface.

Parameters:

videoFrameRenderer - an instance implementing the WZRenderAPI.VideoFrameRenderer interface

getEglContext

public EGLContext getEglContext()

Returns:

the EGLContext supplied in the constructor for this instance or in a call to setEglContext(EGLContext)

setEglContext

public void setEglContext(EGLContext eglContext)

Parameters:

eglContext - Specify a shared EGLContext to use when creating OpenGL ES resources on the video encoder's thread

getEglSurface

public EGLSurface getEglSurface()

Returns:

the EGLSurface specified in the last call to setEglSurface(EGLSurface)

setEglSurface

public void setEglSurface(EGLSurface eglSurface)

Set a EGLSurface instance to use for direct copy operations that has been created on the EGLContext supplied in the constructor for this instance or in a call to setEglContext(EGLContext)

Parameters:

eglSurface - a source EGLSurface instance

generateEglSuface

public EGLSurface generateEglSuface(Surface sourceSurface)

Utility function to wrap a Surface instance with an EGLSurface. Note that an EGLContext must have been supplied in the constructor for this instance or in a call to setEglContext(EGLContext)

Parameters:

sourceSurface - the Surface instance to wrap

Returns:

a newly created EGLSurface attached to the EGLContext specified to the broadcaster

onFrameAvailable

public void onFrameAvailable(long frameTimestampNs)

Call to notify the broadcaster that a new frame is available for capture with the specified timestamp. This result in a subsequent call to the WZRenderAPI.VideoFrameRenderer instance supplied in the last call to setVideoFrameRenderer(WZRenderAPI.VideoFrameRenderer) to render the frame's content onto the video encoder's input surface

Parameters:

frameTimestampNs - the timestamp to use when encoding this frame, in nanoseconds

onFrameAvailable

public void onFrameAvailable()

Call to notify the broadcaster that a new frame is available for capture. This result in a subsequent call to the WZRenderAPI.VideoFrameRenderer instance supplied in the last call to setVideoFrameRenderer(WZRenderAPI.VideoFrameRenderer) to render the frame's content onto the video encoder's input surface

setFrameSize

public void setFrameSize(int frameWidth,
                         int frameHeight)

Call to notify the broadcaster of a change in the video source's frame size during a broadcast such as when a device's orientation changes (e.g from portrait to landscape)

Parameters:

frameWidth - the new video frame width

frameHeight - the new video frame height

setFrameRotation

public void setFrameRotation(int frameRotation)

Call to notify the broadcaster of a change in the video source's orientation during a broadcast. The updated rotation value will be reflected in the frameRotation argument sent to the frame renderer

Parameters:

frameRotation - the new video source rotation (0-360)