com.wowza.gocoder.sdk.api.broadcast

Class WOWZGLBroadcaster

java.lang.Object

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

com.wowza.gocoder.sdk.api.broadcast.WOWZH264Broadcaster

com.wowza.gocoder.sdk.api.broadcast.WOWZGLBroadcaster

All Implemented Interfaces:

WOWZBroadcastAPI.AdaptiveBroadcaster, WOWZBroadcastAPI.Broadcaster, WOWZBroadcastAPI.VideoBroadcaster, java.lang.Runnable

public class WOWZGLBroadcaster
extends WOWZH264Broadcaster

Use this class to integrate the GoCoder SDK into an existing application's OpenGL ES-based rendering pipeline to broadcast content from sources other than WOWZCameraView.

Constructor Summary

Constructors

Constructor and Description
WOWZGLBroadcaster() Creates and initializes an instance.
WOWZGLBroadcaster(EGLContext eglContext) Creates and initializes an instance specifying a shared EGLContext to use when creating OpenGL ES resources on the video encoder's thread.
WOWZGLBroadcaster(EGLContext eglContext, EGLSurface eglSurface)

Method Summary

Modifier and Type	Method and Description
EGLSurface	generateEglSuface(Surface sourceSurface) Wraps a Surface instance with an EGLSurface.
EGLContext	getEglContext()
EGLSurface	getEglSurface()
WOWZRenderAPI.VideoFrameRenderer	getVideoFrameRenderer()
void	onFrameAvailable() Notifies the broadcaster that a new frame is available for capture.
void	onFrameAvailable(long frameTimestampNs) Notifies the broadcaster that a new frame is available for capture with the specified timestamp.
void	setEglContext(EGLContext eglContext)
void	setEglSurface(EGLSurface eglSurface) Sets an EGLSurface instance to use for direct copy operations that have been created on the EGLContext supplied in the constructor for this instance or in a call to setEglContext(EGLContext).
void	setFrameRotation(int frameRotation) Notifies the broadcaster of a change in the video source's orientation during a broadcast.
void	setFrameSize(int frameWidth, int frameHeight) Notifies the broadcaster of a change in the video source's frame size during a broadcast, such as when a device rotates from portrait to landscape orientation.
void	setVideoFrameRenderer(WOWZRenderAPI.VideoFrameRenderer videoFrameRenderer) Specifies an instance implementing the WOWZRenderAPI.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.WOWZH264Broadcaster

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

WOWZGLBroadcaster

public WOWZGLBroadcaster(EGLContext eglContext,
                         EGLSurface eglSurface)

WOWZGLBroadcaster

public WOWZGLBroadcaster(EGLContext eglContext)

Creates and initializes an 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.

WOWZGLBroadcaster

public WOWZGLBroadcaster()

Creates and initializes an instance.

Method Detail

getVideoFrameRenderer

public WOWZRenderAPI.VideoFrameRenderer getVideoFrameRenderer()

Returns:

The WOWZRenderAPI.VideoFrameRenderer last specified in a call to setVideoFrameRenderer(WOWZRenderAPI.VideoFrameRenderer).

setVideoFrameRenderer

public void setVideoFrameRenderer(WOWZRenderAPI.VideoFrameRenderer videoFrameRenderer)

Specifies an instance implementing the WOWZRenderAPI.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 WOWZRenderAPI.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 - The 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)

Sets an EGLSurface instance to use for direct copy operations that have 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)

Wraps a Surface instance with an EGLSurface. 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)

Notifies the broadcaster that a new frame is available for capture with the specified timestamp. This results in a subsequent call to the WOWZRenderAPI.VideoFrameRenderer instance supplied in the last call to setVideoFrameRenderer(WOWZRenderAPI.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()

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

setFrameSize

public void setFrameSize(int frameWidth,
                         int frameHeight)

Notifies the broadcaster of a change in the video source's frame size during a broadcast, such as when a device rotates from portrait to landscape orientation.

Parameters:

frameWidth - The new frame width.

frameHeight - The new frame height.

setFrameRotation

public void setFrameRotation(int frameRotation)

Notifies 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, from 0 degrees to 360 degrees.