Package org.webrtc

Class VideoSource

java.lang.Object

org.webrtc.MediaSource

org.webrtc.VideoSource

public class VideoSource
extends MediaSource

Java wrapper of native AndroidVideoTrackSource.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	VideoSource.AspectRatio	Simple aspect ratio clas for use in constraining output format.

Nested classes/interfaces inherited from class org.webrtc.MediaSource

MediaSource.State

Field Summary

Fields

Modifier and Type	Field	Description
private final CapturerObserver	capturerObserver
private boolean	isCapturerRunning
private final NativeAndroidVideoTrackSource	nativeAndroidVideoTrackSource
private VideoProcessor	videoProcessor
private final Object	videoProcessorLock

Constructor Summary

Constructors

Constructor	Description
VideoSource(long nativeSource)

Method Summary

Modifier and Type	Method	Description
void	adaptOutputFormat(int width, int height, int fps)	Calling this function will cause frames to be scaled down to the requested resolution.
void	adaptOutputFormat(int landscapeWidth, int landscapeHeight, int portraitWidth, int portraitHeight, int fps)	Same as above, but allows setting two different target resolutions depending on incoming frame orientation.
void	adaptOutputFormat(VideoSource.AspectRatio targetLandscapeAspectRatio, Integer maxLandscapePixelCount, VideoSource.AspectRatio targetPortraitAspectRatio, Integer maxPortraitPixelCount, Integer maxFps)	Same as above, with even more control as each constraint is optional.
void	dispose()
CapturerObserver	getCapturerObserver()
(package private) long	getNativeVideoTrackSource()	Returns a pointer to webrtc::VideoTrackSourceInterface.
void	setIsScreencast(boolean isScreencast)
void	setVideoProcessor(VideoProcessor newVideoProcessor)	Hook for injecting a custom video processor before frames are passed onto WebRTC.

Methods inherited from class org.webrtc.MediaSource

getNativeMediaSource, runWithReference, state

Methods inherited from class java.lang.Object

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

Field Details

nativeAndroidVideoTrackSource

private final NativeAndroidVideoTrackSource nativeAndroidVideoTrackSource

videoProcessorLock

private final Object videoProcessorLock

videoProcessor

@Nullable
private VideoProcessor videoProcessor

isCapturerRunning

private boolean isCapturerRunning

capturerObserver

private final CapturerObserver capturerObserver

Constructor Details

VideoSource

public VideoSource(long nativeSource)

Method Details

adaptOutputFormat

public void adaptOutputFormat(int width,
 int height,
 int fps)

Calling this function will cause frames to be scaled down to the requested resolution. Also, frames will be cropped to match the requested aspect ratio, and frames will be dropped to match the requested fps. The requested aspect ratio is orientation agnostic and will be adjusted to maintain the input orientation, so it doesn't matter if e.g. 1280x720 or 720x1280 is requested.

adaptOutputFormat

public void adaptOutputFormat(int landscapeWidth,
 int landscapeHeight,
 int portraitWidth,
 int portraitHeight,
 int fps)

Same as above, but allows setting two different target resolutions depending on incoming frame orientation. This gives more fine-grained control and can e.g. be used to force landscape video to be cropped to portrait video.

adaptOutputFormat

public void adaptOutputFormat(VideoSource.AspectRatio targetLandscapeAspectRatio,
 @Nullable
 Integer maxLandscapePixelCount,
 VideoSource.AspectRatio targetPortraitAspectRatio,
 @Nullable
 Integer maxPortraitPixelCount,
 @Nullable
 Integer maxFps)

Same as above, with even more control as each constraint is optional.

setIsScreencast

public void setIsScreencast(boolean isScreencast)

setVideoProcessor

public void setVideoProcessor(@Nullable
 VideoProcessor newVideoProcessor)

Hook for injecting a custom video processor before frames are passed onto WebRTC. The frames will be cropped and scaled depending on CPU and network conditions before they are passed to the video processor. Frames will be delivered to the video processor on the same thread they are passed to this object. The video processor is allowed to deliver the processed frames back on any thread.

getCapturerObserver

public CapturerObserver getCapturerObserver()

getNativeVideoTrackSource

long getNativeVideoTrackSource()

Returns a pointer to webrtc::VideoTrackSourceInterface.

dispose

public void dispose()

Overrides:

dispose in class MediaSource