/* * Copyright 2019 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 RTC_BASE_EXPERIMENTS_BALANCED_DEGRADATION_SETTINGS_H_ #define RTC_BASE_EXPERIMENTS_BALANCED_DEGRADATION_SETTINGS_H_ #include #include "absl/types/optional.h" #include "api/video_codecs/video_encoder.h" namespace webrtc { class BalancedDegradationSettings { public: static constexpr int kNoFpsDiff = -100; BalancedDegradationSettings(); ~BalancedDegradationSettings(); struct CodecTypeSpecific { CodecTypeSpecific() {} CodecTypeSpecific(int qp_low, int qp_high, int fps) : qp_low(qp_low), qp_high(qp_high), fps(fps) {} bool operator==(const CodecTypeSpecific& o) const { return qp_low == o.qp_low && qp_high == o.qp_high && fps == o.fps; } absl::optional GetQpLow() const; absl::optional GetQpHigh() const; absl::optional GetFps() const; int qp_low = 0; int qp_high = 0; int fps = 0; }; struct Config { Config(); Config(int pixels, int fps, int kbps, int kbps_res, int fps_diff, CodecTypeSpecific vp8, CodecTypeSpecific vp9, CodecTypeSpecific h264, CodecTypeSpecific generic); bool operator==(const Config& o) const { return pixels == o.pixels && fps == o.fps && kbps == o.kbps && kbps_res == o.kbps_res && fps_diff == o.fps_diff && vp8 == o.vp8 && vp9 == o.vp9 && h264 == o.h264 && generic == o.generic; } int pixels = 0; // Video frame size. // If the frame size is less than or equal to |pixels|: int fps = 0; // Min framerate to be used. int kbps = 0; // Min bitrate needed to adapt up (resolution/fps). int kbps_res = 0; // Min bitrate needed to adapt up in resolution. int fps_diff = kNoFpsDiff; // Min fps reduction needed (input fps - |fps|) // w/o triggering a new subsequent downgrade // check. CodecTypeSpecific vp8; CodecTypeSpecific vp9; CodecTypeSpecific h264; CodecTypeSpecific generic; }; // Returns configurations from field trial on success (default on failure). std::vector GetConfigs() const; // Gets the min/max framerate from |configs_| based on |pixels|. int MinFps(VideoCodecType type, int pixels) const; int MaxFps(VideoCodecType type, int pixels) const; // Gets the bitrate for the first resolution above |pixels|. absl::optional NextHigherBitrateKbps(int pixels) const; absl::optional ResolutionNextHigherBitrateKbps(int pixels) const; // Checks if quality can be increased based on |pixels| and |bitrate_bps|. bool CanAdaptUp(int pixels, uint32_t bitrate_bps) const; bool CanAdaptUpResolution(int pixels, uint32_t bitrate_bps) const; // Gets the min framerate diff from |configs_| based on |pixels|. absl::optional MinFpsDiff(int pixels) const; // Gets QpThresholds for the codec |type| based on |pixels|. absl::optional GetQpThresholds( VideoCodecType type, int pixels) const; private: absl::optional GetMinFpsConfig(int pixels) const; absl::optional GetMaxFpsConfig(int pixels) const; Config GetConfig(int pixels) const; std::vector configs_; }; } // namespace webrtc #endif // RTC_BASE_EXPERIMENTS_BALANCED_DEGRADATION_SETTINGS_H_