mirror of
https://github.com/mollyim/webrtc.git
synced 2025-05-13 13:50:40 +01:00

This is a no-op change because rtc::Optional is an alias to absl::optional This CL generated by running script from modules with parameters 'pacing video_coding congestion_controller remote_bitrate_estimator': find $@ -type f \( -name \*.h -o -name \*.cc \) \ -exec sed -i 's|rtc::Optional|absl::optional|g' {} \+ \ -exec sed -i 's|rtc::nullopt|absl::nullopt|g' {} \+ \ -exec sed -i 's|#include "api/optional.h"|#include "absl/types/optional.h"|' {} \+ find $@ -type f -name BUILD.gn \ -exec sed -r -i 's|"(../)*api:optional"|"//third_party/abseil-cpp/absl/types:optional"|' {} \+; git cl format Bug: webrtc:9078 Change-Id: I8ea501d7f1ee36e8d8cd3ed37e6b763c7fe29118 Reviewed-on: https://webrtc-review.googlesource.com/83900 Reviewed-by: Philip Eliasson <philipel@webrtc.org> Commit-Queue: Danil Chapovalov <danilchap@webrtc.org> Cr-Commit-Position: refs/heads/master@{#23640}
95 lines
3.7 KiB
C++
95 lines
3.7 KiB
C++
/*
|
|
* Copyright (c) 2014 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 MODULES_VIDEO_CODING_UTILITY_QUALITY_SCALER_H_
|
|
#define MODULES_VIDEO_CODING_UTILITY_QUALITY_SCALER_H_
|
|
|
|
#include <memory>
|
|
#include <utility>
|
|
|
|
#include "absl/types/optional.h"
|
|
#include "api/video_codecs/video_encoder.h"
|
|
#include "common_types.h" // NOLINT(build/include)
|
|
#include "modules/video_coding/utility/moving_average.h"
|
|
#include "rtc_base/experiments/quality_scaling_experiment.h"
|
|
#include "rtc_base/sequenced_task_checker.h"
|
|
|
|
namespace webrtc {
|
|
|
|
// An interface for signaling requests to limit or increase the resolution or
|
|
// framerate of the captured video stream.
|
|
class AdaptationObserverInterface {
|
|
public:
|
|
// Indicates if the adaptation is due to overuse of the CPU resources, or if
|
|
// the quality of the encoded frames have dropped too low.
|
|
enum AdaptReason : size_t { kQuality = 0, kCpu = 1 };
|
|
static const size_t kScaleReasonSize = 2;
|
|
// Called to signal that we can handle larger or more frequent frames.
|
|
virtual void AdaptUp(AdaptReason reason) = 0;
|
|
// Called to signal that the source should reduce the resolution or framerate.
|
|
virtual void AdaptDown(AdaptReason reason) = 0;
|
|
|
|
protected:
|
|
virtual ~AdaptationObserverInterface() {}
|
|
};
|
|
|
|
// QualityScaler runs asynchronously and monitors QP values of encoded frames.
|
|
// It holds a reference to an AdaptationObserverInterface implementation to
|
|
// signal an intent to scale up or down.
|
|
class QualityScaler {
|
|
public:
|
|
// Construct a QualityScaler with given |thresholds| and |observer|.
|
|
// This starts the quality scaler periodically checking what the average QP
|
|
// has been recently.
|
|
QualityScaler(AdaptationObserverInterface* observer,
|
|
VideoEncoder::QpThresholds thresholds);
|
|
virtual ~QualityScaler();
|
|
// Should be called each time a frame is dropped at encoding.
|
|
void ReportDroppedFrameByMediaOpt();
|
|
void ReportDroppedFrameByEncoder();
|
|
// Inform the QualityScaler of the last seen QP.
|
|
void ReportQp(int qp);
|
|
|
|
// The following members declared protected for testing purposes.
|
|
protected:
|
|
QualityScaler(AdaptationObserverInterface* observer,
|
|
VideoEncoder::QpThresholds thresholds,
|
|
int64_t sampling_period_ms);
|
|
|
|
private:
|
|
class CheckQpTask;
|
|
class QpSmoother;
|
|
void CheckQp();
|
|
void ClearSamples();
|
|
void ReportQpLow();
|
|
void ReportQpHigh();
|
|
int64_t GetSamplingPeriodMs() const;
|
|
|
|
CheckQpTask* check_qp_task_ RTC_GUARDED_BY(&task_checker_);
|
|
AdaptationObserverInterface* const observer_ RTC_GUARDED_BY(&task_checker_);
|
|
rtc::SequencedTaskChecker task_checker_;
|
|
|
|
const VideoEncoder::QpThresholds thresholds_;
|
|
const int64_t sampling_period_ms_;
|
|
bool fast_rampup_ RTC_GUARDED_BY(&task_checker_);
|
|
MovingAverage average_qp_ RTC_GUARDED_BY(&task_checker_);
|
|
MovingAverage framedrop_percent_media_opt_ RTC_GUARDED_BY(&task_checker_);
|
|
MovingAverage framedrop_percent_all_ RTC_GUARDED_BY(&task_checker_);
|
|
|
|
// Used by QualityScalingExperiment.
|
|
const bool experiment_enabled_;
|
|
QualityScalingExperiment::Config config_ RTC_GUARDED_BY(&task_checker_);
|
|
std::unique_ptr<QpSmoother> qp_smoother_high_ RTC_GUARDED_BY(&task_checker_);
|
|
std::unique_ptr<QpSmoother> qp_smoother_low_ RTC_GUARDED_BY(&task_checker_);
|
|
bool observed_enough_frames_ RTC_GUARDED_BY(&task_checker_);
|
|
};
|
|
} // namespace webrtc
|
|
|
|
#endif // MODULES_VIDEO_CODING_UTILITY_QUALITY_SCALER_H_
|