org.webrtc

Class VideoDecoderFallback

java.lang.Object

org.webrtc.VideoDecoderFallback

All Implemented Interfaces:

VideoDecoder

public class VideoDecoderFallback
extends java.lang.Object

A combined video decoder that falls back on a secondary decoder if the primary decoder fails.

Nested Class Summary

Nested classes/interfaces inherited from interface org.webrtc.VideoDecoder

VideoDecoder.Callback, VideoDecoder.DecodeInfo, VideoDecoder.Settings

Constructor Summary

Constructors

Constructor and Description
VideoDecoderFallback(VideoDecoder fallback, VideoDecoder primary)

Method Summary

Modifier and Type	Method and Description
long	createNativeVideoDecoder() The decoder implementation backing this interface is either 1) a Java decoder (e.g., an Android platform decoder), or alternatively 2) a native decoder (e.g., a software decoder or a C++ decoder adapter).
VideoCodecStatus	decode(EncodedImage frame, VideoDecoder.DecodeInfo info) Request the decoder to decode a frame.
java.lang.String	getImplementationName() Should return a descriptive name for the implementation.
boolean	getPrefersLateDecoding() The decoder should return true if it prefers late decoding.
VideoCodecStatus	initDecode(VideoDecoder.Settings settings, VideoDecoder.Callback decodeCallback) Initializes the decoding process with specified settings.
VideoCodecStatus	release() Called when the decoder is no longer needed.

Methods inherited from class java.lang.Object

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

Constructor Detail

VideoDecoderFallback

public VideoDecoderFallback(VideoDecoder fallback,
                            VideoDecoder primary)

Method Detail

createNativeVideoDecoder

public long createNativeVideoDecoder()

Description copied from interface: VideoDecoder

The decoder implementation backing this interface is either 1) a Java decoder (e.g., an Android platform decoder), or alternatively 2) a native decoder (e.g., a software decoder or a C++ decoder adapter). For case 1), createNativeVideoDecoder() should return zero. In this case, we expect the native library to call the decoder through JNI using the Java interface declared below. For case 2), createNativeVideoDecoder() should return a non-zero value. In this case, we expect the native library to treat the returned value as a raw pointer of type webrtc::VideoDecoder* (ownership is transferred to the caller). The native library should then directly call the webrtc::VideoDecoder interface without going through JNI. All calls to the Java interface methods declared below should thus throw an UnsupportedOperationException.

Specified by:

createNativeVideoDecoder in interface VideoDecoder

initDecode

public VideoCodecStatus initDecode(VideoDecoder.Settings settings,
                                   VideoDecoder.Callback decodeCallback)

Description copied from interface: VideoDecoder

Initializes the decoding process with specified settings. Will be called on the decoding thread before any decode calls.

Specified by:

initDecode in interface VideoDecoder

release

public VideoCodecStatus release()

Description copied from interface: VideoDecoder

Called when the decoder is no longer needed. Any more calls to decode will not be made.

Specified by:

release in interface VideoDecoder

decode

public VideoCodecStatus decode(EncodedImage frame,
                               VideoDecoder.DecodeInfo info)

Description copied from interface: VideoDecoder

Request the decoder to decode a frame.

Specified by:

decode in interface VideoDecoder

getPrefersLateDecoding

public boolean getPrefersLateDecoding()

Description copied from interface: VideoDecoder

The decoder should return true if it prefers late decoding. That is, it can not decode infinite number of frames before the decoded frame is consumed.

Specified by:

getPrefersLateDecoding in interface VideoDecoder

getImplementationName

public java.lang.String getImplementationName()

Description copied from interface: VideoDecoder

Should return a descriptive name for the implementation. Gets called once and cached. May be called from arbitrary thread.

Specified by:

getImplementationName in interface VideoDecoder