876222f77d
This brings QualityScaler much more in line with OveruseFrameDetector. The two classes are conceptually similar, and should be used in the same way. The biggest changes in this CL are: - Quality scaling is now only done in ViEEncoder and not in each encoder implementation separately. - QualityScaler now checks the average QP asynchronously, instead of having to be polled on each frame. - QualityScaler is no longer responsible for actually scaling the frames, but has a callback to ViEEncoder that it uses to express it's desire for lower resolution. BUG=webrtc:6495 Review-Url: https://codereview.webrtc.org/2398963003 Cr-Commit-Position: refs/heads/master@{#15286}
84 lines
3.0 KiB
C++
84 lines
3.0 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 WEBRTC_MODULES_VIDEO_CODING_UTILITY_QUALITY_SCALER_H_
|
|
#define WEBRTC_MODULES_VIDEO_CODING_UTILITY_QUALITY_SCALER_H_
|
|
|
|
#include <utility>
|
|
|
|
#include "webrtc/common_types.h"
|
|
#include "webrtc/video_encoder.h"
|
|
#include "webrtc/base/optional.h"
|
|
#include "webrtc/base/sequenced_task_checker.h"
|
|
#include "webrtc/modules/video_coding/utility/moving_average.h"
|
|
|
|
namespace webrtc {
|
|
|
|
// An interface for a class that receives scale up/down requests.
|
|
class ScalingObserverInterface {
|
|
public:
|
|
enum ScaleReason : size_t { kQuality = 0, kCpu = 1 };
|
|
static const size_t kScaleReasonSize = 2;
|
|
// Called to signal that we can handle larger frames.
|
|
virtual void ScaleUp(ScaleReason reason) = 0;
|
|
// Called to signal that encoder to scale down.
|
|
virtual void ScaleDown(ScaleReason reason) = 0;
|
|
|
|
protected:
|
|
virtual ~ScalingObserverInterface() {}
|
|
};
|
|
|
|
// QualityScaler runs asynchronously and monitors QP values of encoded frames.
|
|
// It holds a reference to a ScalingObserverInterface implementation to signal
|
|
// an intent to scale up or down.
|
|
class QualityScaler {
|
|
public:
|
|
// Construct a QualityScaler with a given |observer|.
|
|
// This starts the quality scaler periodically checking what the average QP
|
|
// has been recently.
|
|
QualityScaler(ScalingObserverInterface* observer, VideoCodecType codec_type);
|
|
// If specific thresholds are desired these can be supplied as |thresholds|.
|
|
QualityScaler(ScalingObserverInterface* observer,
|
|
VideoEncoder::QpThresholds thresholds);
|
|
virtual ~QualityScaler();
|
|
// Should be called each time the encoder drops a frame
|
|
void ReportDroppedFrame();
|
|
// Inform the QualityScaler of the last seen QP.
|
|
void ReportQP(int qp);
|
|
|
|
// The following members declared protected for testing purposes
|
|
protected:
|
|
QualityScaler(ScalingObserverInterface* observer,
|
|
VideoEncoder::QpThresholds thresholds,
|
|
int64_t sampling_period);
|
|
|
|
private:
|
|
class CheckQPTask;
|
|
void CheckQP();
|
|
void ClearSamples();
|
|
void ReportQPLow();
|
|
void ReportQPHigh();
|
|
int64_t GetSamplingPeriodMs() const;
|
|
|
|
CheckQPTask* check_qp_task_ GUARDED_BY(&task_checker_);
|
|
ScalingObserverInterface* const observer_ GUARDED_BY(&task_checker_);
|
|
rtc::SequencedTaskChecker task_checker_;
|
|
|
|
const int64_t sampling_period_ms_;
|
|
bool fast_rampup_ GUARDED_BY(&task_checker_);
|
|
MovingAverage average_qp_ GUARDED_BY(&task_checker_);
|
|
MovingAverage framedrop_percent_ GUARDED_BY(&task_checker_);
|
|
|
|
VideoEncoder::QpThresholds thresholds_ GUARDED_BY(&task_checker_);
|
|
};
|
|
} // namespace webrtc
|
|
|
|
#endif // WEBRTC_MODULES_VIDEO_CODING_UTILITY_QUALITY_SCALER_H_
|