mirror of
https://github.com/mollyim/webrtc.git
synced 2025-05-14 14:20:45 +01:00
2b781bf908
This member of the CodecInfo struct was set in several places, but not used for anything. To aid deletion, this cl defines a default implementation of VideoEncoderFactory::QueryVideoEncoder. The next step is to delete almost all downstream implementations of that method, since the only classes that have to implement it are the few factories that produce "internal source" encoders, e.g., for Chromium remoting. Bug: None Change-Id: I1f0dbf0d302933004ebdc779460cb2cb3a894e02 Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/179520 Reviewed-by: Kári Helgason <kthelgason@webrtc.org> Reviewed-by: Sami Kalliomäki <sakal@webrtc.org> Reviewed-by: Sebastian Jansson <srte@webrtc.org> Commit-Queue: Niels Moller <nisse@webrtc.org> Cr-Commit-Position: refs/heads/master@{#31844}
96 lines
3.6 KiB
C++
96 lines
3.6 KiB
C++
/*
|
|
* Copyright (c) 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.
|
|
*/
|
|
|
|
#ifndef API_VIDEO_CODECS_VIDEO_ENCODER_FACTORY_H_
|
|
#define API_VIDEO_CODECS_VIDEO_ENCODER_FACTORY_H_
|
|
|
|
#include <memory>
|
|
#include <vector>
|
|
|
|
#include "absl/types/optional.h"
|
|
#include "api/units/data_rate.h"
|
|
#include "api/video_codecs/sdp_video_format.h"
|
|
|
|
namespace webrtc {
|
|
|
|
class VideoEncoder;
|
|
|
|
// A factory that creates VideoEncoders.
|
|
// NOTE: This class is still under development and may change without notice.
|
|
class VideoEncoderFactory {
|
|
public:
|
|
// TODO(magjed): Try to get rid of this struct.
|
|
struct CodecInfo {
|
|
// TODO(nisse): Unused in webrtc, delete as soon as downstream use is fixed.
|
|
bool is_hardware_accelerated = false;
|
|
// |has_internal_source| is true if encoders created by this factory of the
|
|
// given codec will use internal camera sources, meaning that they don't
|
|
// require/expect frames to be delivered via webrtc::VideoEncoder::Encode.
|
|
// This flag is used as the internal_source parameter to
|
|
// webrtc::ViEExternalCodec::RegisterExternalSendCodec.
|
|
bool has_internal_source = false;
|
|
};
|
|
|
|
// An injectable class that is continuously updated with encoding conditions
|
|
// and selects the best encoder given those conditions.
|
|
class EncoderSelectorInterface {
|
|
public:
|
|
virtual ~EncoderSelectorInterface() {}
|
|
|
|
// Informs the encoder selector about which encoder that is currently being
|
|
// used.
|
|
virtual void OnCurrentEncoder(const SdpVideoFormat& format) = 0;
|
|
|
|
// Called every time the available bitrate is updated. Should return a
|
|
// non-empty if an encoder switch should be performed.
|
|
virtual absl::optional<SdpVideoFormat> OnAvailableBitrate(
|
|
const DataRate& rate) = 0;
|
|
|
|
// Called if the currently used encoder reports itself as broken. Should
|
|
// return a non-empty if an encoder switch should be performed.
|
|
virtual absl::optional<SdpVideoFormat> OnEncoderBroken() = 0;
|
|
};
|
|
|
|
// Returns a list of supported video formats in order of preference, to use
|
|
// for signaling etc.
|
|
virtual std::vector<SdpVideoFormat> GetSupportedFormats() const = 0;
|
|
|
|
// Returns a list of supported video formats in order of preference, that can
|
|
// also be tagged with additional information to allow the VideoEncoderFactory
|
|
// to separate between different implementations when CreateVideoEncoder is
|
|
// called.
|
|
virtual std::vector<SdpVideoFormat> GetImplementations() const {
|
|
return GetSupportedFormats();
|
|
}
|
|
|
|
// Returns information about how this format will be encoded. The specified
|
|
// format must be one of the supported formats by this factory.
|
|
|
|
// TODO(magjed): Try to get rid of this method. Since is_hardware_accelerated
|
|
// is unused, only factories producing internal source encoders (in itself a
|
|
// deprecated feature) needs to override this method.
|
|
virtual CodecInfo QueryVideoEncoder(const SdpVideoFormat& format) const {
|
|
return CodecInfo();
|
|
}
|
|
|
|
// Creates a VideoEncoder for the specified format.
|
|
virtual std::unique_ptr<VideoEncoder> CreateVideoEncoder(
|
|
const SdpVideoFormat& format) = 0;
|
|
|
|
virtual std::unique_ptr<EncoderSelectorInterface> GetEncoderSelector() const {
|
|
return nullptr;
|
|
}
|
|
|
|
virtual ~VideoEncoderFactory() {}
|
|
};
|
|
|
|
} // namespace webrtc
|
|
|
|
#endif // API_VIDEO_CODECS_VIDEO_ENCODER_FACTORY_H_
|