4f34d78c85
The encoding bitrate might be limited depending on the current encoder. Bug: webrtc:11341 Change-Id: I734fce12734b1e703e7948847cdb1365c08a137b Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/169123 Reviewed-by: Sami Kalliomäki <sakal@webrtc.org> Reviewed-by: Artem Titov <titovartem@webrtc.org> Reviewed-by: Åsa Persson <asapersson@webrtc.org> Reviewed-by: Rasmus Brandt <brandtr@webrtc.org> Commit-Queue: Mirta Dvornicic <mirtad@webrtc.org> Cr-Commit-Position: refs/heads/master@{#30619}
80 lines
2.7 KiB
Java
80 lines
2.7 KiB
Java
/*
|
|
* Copyright 2017 The WebRTC project authors. All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by a BSD-style license
|
|
* that can be found in the LICENSE file in the root of the source
|
|
* tree. An additional intellectual property rights grant can be found
|
|
* in the file PATENTS. All contributing project authors may
|
|
* be found in the AUTHORS file in the root of the source tree.
|
|
*/
|
|
|
|
package org.webrtc;
|
|
|
|
import android.support.annotation.Nullable;
|
|
|
|
/** Factory for creating VideoEncoders. */
|
|
public interface VideoEncoderFactory {
|
|
public interface VideoEncoderSelector {
|
|
/** Called with the VideoCodecInfo of the currently used encoder. */
|
|
@CalledByNative("VideoEncoderSelector") void onCurrentEncoder(VideoCodecInfo info);
|
|
|
|
/**
|
|
* Called with the current encoding bitrate. Returns null if the encoder selector prefers to
|
|
* keep the current encoder or a VideoCodecInfo if a new encoder is preferred.
|
|
*
|
|
* <p>TODO(bugs.webrtc.org/11341): Delete onEncodingBitrate and remove the default
|
|
* implementation for onAvailableBitrate once downstream project is updated.
|
|
*/
|
|
@Deprecated
|
|
@Nullable
|
|
default VideoCodecInfo onEncodingBitrate(int kbps) {
|
|
throw new UnsupportedOperationException("Not implemented.");
|
|
}
|
|
|
|
/**
|
|
* Called with the current available bitrate. Returns null if the encoder selector prefers to
|
|
* keep the current encoder or a VideoCodecInfo if a new encoder is preferred.
|
|
*/
|
|
@Nullable
|
|
@CalledByNative("VideoEncoderSelector")
|
|
default VideoCodecInfo onAvailableBitrate(int kbps) {
|
|
return onEncodingBitrate(kbps);
|
|
}
|
|
|
|
/**
|
|
* Called when the currently used encoder signal itself as broken. Returns null if the encoder
|
|
* selector prefers to keep the current encoder or a VideoCodecInfo if a new encoder is
|
|
* preferred.
|
|
*/
|
|
@Nullable @CalledByNative("VideoEncoderSelector") VideoCodecInfo onEncoderBroken();
|
|
}
|
|
|
|
/** Creates an encoder for the given video codec. */
|
|
@Nullable @CalledByNative VideoEncoder createEncoder(VideoCodecInfo info);
|
|
|
|
/**
|
|
* Enumerates the list of supported video codecs. This method will only be called once and the
|
|
* result will be cached.
|
|
*/
|
|
@CalledByNative VideoCodecInfo[] getSupportedCodecs();
|
|
|
|
/**
|
|
* Enumerates the list of supported video codecs that can also be tagged with
|
|
* implementation information. This method will only be called once and the
|
|
* result will be cached.
|
|
*/
|
|
@CalledByNative
|
|
default VideoCodecInfo[] getImplementations() {
|
|
return getSupportedCodecs();
|
|
}
|
|
|
|
/**
|
|
* Returns a VideoEncoderSelector if implemented by the VideoEncoderFactory,
|
|
* null otherwise.
|
|
*/
|
|
@CalledByNative
|
|
default VideoEncoderSelector getEncoderSelector() {
|
|
return null;
|
|
}
|
|
}
|