blob: 6135064a378a18b252eae87d34d75e42d0fd169d [file] [log] [blame]
niklase@google.com470e71d2011-07-07 08:21:25 +00001/*
stefan@webrtc.org07b45a52012-02-02 08:37:48 +00002 * Copyright (c) 2012 The WebRTC project authors. All Rights Reserved.
niklase@google.com470e71d2011-07-07 08:21:25 +00003 *
4 * Use of this source code is governed by a BSD-style license
5 * that can be found in the LICENSE file in the root of the source
6 * tree. An additional intellectual property rights grant can be found
7 * in the file PATENTS. All contributing project authors may
8 * be found in the AUTHORS file in the root of the source tree.
9 */
10
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020011#include "video/video_stream_encoder.h"
mflodman@webrtc.org84d17832011-12-01 17:02:23 +000012
stefan@webrtc.orgc3cc3752013-06-04 09:36:56 +000013#include <algorithm>
perkj57c21f92016-06-17 07:27:16 -070014#include <limits>
sprangc5d62e22017-04-02 23:53:04 -070015#include <numeric>
Per512ecb32016-09-23 15:52:06 +020016#include <utility>
niklase@google.com470e71d2011-07-07 08:21:25 +000017
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020018#include "api/video/i420_buffer.h"
19#include "common_video/include/video_bitrate_allocator.h"
20#include "common_video/include/video_frame.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020021#include "modules/video_coding/include/video_codec_initializer.h"
22#include "modules/video_coding/include/video_coding.h"
23#include "modules/video_coding/include/video_coding_defines.h"
24#include "rtc_base/arraysize.h"
25#include "rtc_base/checks.h"
Åsa Perssona945aee2018-04-24 16:53:25 +020026#include "rtc_base/experiments/quality_scaling_experiment.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020027#include "rtc_base/location.h"
28#include "rtc_base/logging.h"
Karl Wiberg80ba3332018-02-05 10:33:35 +010029#include "rtc_base/system/fallthrough.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020030#include "rtc_base/timeutils.h"
31#include "rtc_base/trace_event.h"
32#include "video/overuse_frame_detector.h"
33#include "video/send_statistics_proxy.h"
nisseea3a7982017-05-15 02:42:11 -070034
niklase@google.com470e71d2011-07-07 08:21:25 +000035namespace webrtc {
36
perkj26091b12016-09-01 01:17:40 -070037namespace {
sprangb1ca0732017-02-01 08:38:12 -080038
asapersson6ffb67d2016-09-12 00:10:45 -070039// Time interval for logging frame counts.
40const int64_t kFrameLogIntervalMs = 60000;
sprangc5d62e22017-04-02 23:53:04 -070041const int kMinFramerateFps = 2;
sprangfda496a2017-06-15 04:21:07 -070042const int kMaxFramerateFps = 120;
perkj26091b12016-09-01 01:17:40 -070043
Sebastian Janssona3177052018-04-10 13:05:49 +020044// Time to keep a single cached pending frame in paused state.
45const int64_t kPendingFrameTimeoutMs = 1000;
46
kthelgason2bc68642017-02-07 07:02:22 -080047// The maximum number of frames to drop at beginning of stream
48// to try and achieve desired bitrate.
49const int kMaxInitialFramedrop = 4;
50
asaperssonf7e294d2017-06-13 23:25:22 -070051// Initial limits for kBalanced degradation preference.
52int MinFps(int pixels) {
53 if (pixels <= 320 * 240) {
54 return 7;
55 } else if (pixels <= 480 * 270) {
56 return 10;
57 } else if (pixels <= 640 * 480) {
58 return 15;
59 } else {
60 return std::numeric_limits<int>::max();
61 }
62}
63
64int MaxFps(int pixels) {
65 if (pixels <= 320 * 240) {
66 return 10;
67 } else if (pixels <= 480 * 270) {
68 return 15;
69 } else {
70 return std::numeric_limits<int>::max();
71 }
72}
73
asapersson09f05612017-05-15 23:40:18 -070074bool IsResolutionScalingEnabled(
75 VideoSendStream::DegradationPreference degradation_preference) {
76 return degradation_preference ==
77 VideoSendStream::DegradationPreference::kMaintainFramerate ||
78 degradation_preference ==
79 VideoSendStream::DegradationPreference::kBalanced;
80}
81
82bool IsFramerateScalingEnabled(
83 VideoSendStream::DegradationPreference degradation_preference) {
84 return degradation_preference ==
85 VideoSendStream::DegradationPreference::kMaintainResolution ||
86 degradation_preference ==
87 VideoSendStream::DegradationPreference::kBalanced;
88}
89
Niels Möllerd1f7eb62018-03-28 16:40:58 +020090// TODO(pbos): Lower these thresholds (to closer to 100%) when we handle
91// pipelining encoders better (multiple input frames before something comes
92// out). This should effectively turn off CPU adaptations for systems that
93// remotely cope with the load right now.
94CpuOveruseOptions GetCpuOveruseOptions(
Niels Möller4db138e2018-04-19 09:04:13 +020095 const VideoSendStream::Config::EncoderSettings& settings,
96 bool full_overuse_time) {
Niels Möllerd1f7eb62018-03-28 16:40:58 +020097 CpuOveruseOptions options;
98
Niels Möller4db138e2018-04-19 09:04:13 +020099 if (full_overuse_time) {
Niels Möllerd1f7eb62018-03-28 16:40:58 +0200100 options.low_encode_usage_threshold_percent = 150;
101 options.high_encode_usage_threshold_percent = 200;
102 }
103 if (settings.experiment_cpu_load_estimator) {
104 options.filter_time_ms = 5 * rtc::kNumMillisecsPerSec;
105 }
106
107 return options;
108}
109
perkj26091b12016-09-01 01:17:40 -0700110} // namespace
111
perkja49cbd32016-09-16 07:53:41 -0700112// VideoSourceProxy is responsible ensuring thread safety between calls to
mflodmancc3d4422017-08-03 08:27:51 -0700113// VideoStreamEncoder::SetSource that will happen on libjingle's worker thread
114// when a video capturer is connected to the encoder and the encoder task queue
perkja49cbd32016-09-16 07:53:41 -0700115// (encoder_queue_) where the encoder reports its VideoSinkWants.
mflodmancc3d4422017-08-03 08:27:51 -0700116class VideoStreamEncoder::VideoSourceProxy {
perkja49cbd32016-09-16 07:53:41 -0700117 public:
mflodmancc3d4422017-08-03 08:27:51 -0700118 explicit VideoSourceProxy(VideoStreamEncoder* video_stream_encoder)
119 : video_stream_encoder_(video_stream_encoder),
hbos8d609f62017-04-10 07:39:05 -0700120 degradation_preference_(
121 VideoSendStream::DegradationPreference::kDegradationDisabled),
perkj803d97f2016-11-01 11:45:46 -0700122 source_(nullptr) {}
perkja49cbd32016-09-16 07:53:41 -0700123
hbos8d609f62017-04-10 07:39:05 -0700124 void SetSource(
125 rtc::VideoSourceInterface<VideoFrame>* source,
126 const VideoSendStream::DegradationPreference& degradation_preference) {
perkj803d97f2016-11-01 11:45:46 -0700127 // Called on libjingle's worker thread.
perkja49cbd32016-09-16 07:53:41 -0700128 RTC_DCHECK_CALLED_SEQUENTIALLY(&main_checker_);
129 rtc::VideoSourceInterface<VideoFrame>* old_source = nullptr;
perkj803d97f2016-11-01 11:45:46 -0700130 rtc::VideoSinkWants wants;
perkja49cbd32016-09-16 07:53:41 -0700131 {
132 rtc::CritScope lock(&crit_);
sprangc5d62e22017-04-02 23:53:04 -0700133 degradation_preference_ = degradation_preference;
perkja49cbd32016-09-16 07:53:41 -0700134 old_source = source_;
135 source_ = source;
sprangfda496a2017-06-15 04:21:07 -0700136 wants = GetActiveSinkWantsInternal();
perkja49cbd32016-09-16 07:53:41 -0700137 }
138
139 if (old_source != source && old_source != nullptr) {
mflodmancc3d4422017-08-03 08:27:51 -0700140 old_source->RemoveSink(video_stream_encoder_);
perkja49cbd32016-09-16 07:53:41 -0700141 }
142
143 if (!source) {
144 return;
145 }
146
mflodmancc3d4422017-08-03 08:27:51 -0700147 source->AddOrUpdateSink(video_stream_encoder_, wants);
perkja49cbd32016-09-16 07:53:41 -0700148 }
149
perkj803d97f2016-11-01 11:45:46 -0700150 void SetWantsRotationApplied(bool rotation_applied) {
151 rtc::CritScope lock(&crit_);
152 sink_wants_.rotation_applied = rotation_applied;
sprangc5d62e22017-04-02 23:53:04 -0700153 if (source_)
mflodmancc3d4422017-08-03 08:27:51 -0700154 source_->AddOrUpdateSink(video_stream_encoder_, sink_wants_);
sprangc5d62e22017-04-02 23:53:04 -0700155 }
156
sprangfda496a2017-06-15 04:21:07 -0700157 rtc::VideoSinkWants GetActiveSinkWants() {
158 rtc::CritScope lock(&crit_);
159 return GetActiveSinkWantsInternal();
perkj803d97f2016-11-01 11:45:46 -0700160 }
161
asaperssonf7e294d2017-06-13 23:25:22 -0700162 void ResetPixelFpsCount() {
163 rtc::CritScope lock(&crit_);
164 sink_wants_.max_pixel_count = std::numeric_limits<int>::max();
165 sink_wants_.target_pixel_count.reset();
166 sink_wants_.max_framerate_fps = std::numeric_limits<int>::max();
167 if (source_)
mflodmancc3d4422017-08-03 08:27:51 -0700168 source_->AddOrUpdateSink(video_stream_encoder_, sink_wants_);
asaperssonf7e294d2017-06-13 23:25:22 -0700169 }
170
Åsa Perssonc3ed6302017-11-16 14:04:52 +0100171 bool RequestResolutionLowerThan(int pixel_count,
172 int min_pixels_per_frame,
173 bool* min_pixels_reached) {
perkj803d97f2016-11-01 11:45:46 -0700174 // Called on the encoder task queue.
175 rtc::CritScope lock(&crit_);
asapersson13874762017-06-07 00:01:02 -0700176 if (!source_ || !IsResolutionScalingEnabled(degradation_preference_)) {
asapersson02465b82017-04-10 01:12:52 -0700177 // This can happen since |degradation_preference_| is set on libjingle's
178 // worker thread but the adaptation is done on the encoder task queue.
asaperssond0de2952017-04-21 01:47:31 -0700179 return false;
perkj803d97f2016-11-01 11:45:46 -0700180 }
asapersson13874762017-06-07 00:01:02 -0700181 // The input video frame size will have a resolution less than or equal to
182 // |max_pixel_count| depending on how the source can scale the frame size.
kthelgason5e13d412016-12-01 03:59:51 -0800183 const int pixels_wanted = (pixel_count * 3) / 5;
Åsa Perssonc3ed6302017-11-16 14:04:52 +0100184 if (pixels_wanted >= sink_wants_.max_pixel_count) {
185 return false;
186 }
187 if (pixels_wanted < min_pixels_per_frame) {
188 *min_pixels_reached = true;
asaperssond0de2952017-04-21 01:47:31 -0700189 return false;
asapersson13874762017-06-07 00:01:02 -0700190 }
Mirko Bonadei675513b2017-11-09 11:09:25 +0100191 RTC_LOG(LS_INFO) << "Scaling down resolution, max pixels: "
192 << pixels_wanted;
sprangc5d62e22017-04-02 23:53:04 -0700193 sink_wants_.max_pixel_count = pixels_wanted;
Oskar Sundbom8e07c132018-01-08 16:45:42 +0100194 sink_wants_.target_pixel_count = rtc::nullopt;
mflodmancc3d4422017-08-03 08:27:51 -0700195 source_->AddOrUpdateSink(video_stream_encoder_,
196 GetActiveSinkWantsInternal());
asaperssond0de2952017-04-21 01:47:31 -0700197 return true;
sprangc5d62e22017-04-02 23:53:04 -0700198 }
199
sprangfda496a2017-06-15 04:21:07 -0700200 int RequestFramerateLowerThan(int fps) {
sprangc5d62e22017-04-02 23:53:04 -0700201 // Called on the encoder task queue.
asapersson13874762017-06-07 00:01:02 -0700202 // The input video frame rate will be scaled down to 2/3, rounding down.
sprangfda496a2017-06-15 04:21:07 -0700203 int framerate_wanted = (fps * 2) / 3;
204 return RestrictFramerate(framerate_wanted) ? framerate_wanted : -1;
perkj803d97f2016-11-01 11:45:46 -0700205 }
206
asapersson13874762017-06-07 00:01:02 -0700207 bool RequestHigherResolutionThan(int pixel_count) {
208 // Called on the encoder task queue.
perkj803d97f2016-11-01 11:45:46 -0700209 rtc::CritScope lock(&crit_);
asapersson13874762017-06-07 00:01:02 -0700210 if (!source_ || !IsResolutionScalingEnabled(degradation_preference_)) {
asapersson02465b82017-04-10 01:12:52 -0700211 // This can happen since |degradation_preference_| is set on libjingle's
212 // worker thread but the adaptation is done on the encoder task queue.
asapersson13874762017-06-07 00:01:02 -0700213 return false;
perkj803d97f2016-11-01 11:45:46 -0700214 }
asapersson13874762017-06-07 00:01:02 -0700215 int max_pixels_wanted = pixel_count;
216 if (max_pixels_wanted != std::numeric_limits<int>::max())
217 max_pixels_wanted = pixel_count * 4;
sprangc5d62e22017-04-02 23:53:04 -0700218
asapersson13874762017-06-07 00:01:02 -0700219 if (max_pixels_wanted <= sink_wants_.max_pixel_count)
220 return false;
221
222 sink_wants_.max_pixel_count = max_pixels_wanted;
223 if (max_pixels_wanted == std::numeric_limits<int>::max()) {
sprangc5d62e22017-04-02 23:53:04 -0700224 // Remove any constraints.
225 sink_wants_.target_pixel_count.reset();
sprangc5d62e22017-04-02 23:53:04 -0700226 } else {
227 // On step down we request at most 3/5 the pixel count of the previous
228 // resolution, so in order to take "one step up" we request a resolution
229 // as close as possible to 5/3 of the current resolution. The actual pixel
230 // count selected depends on the capabilities of the source. In order to
231 // not take a too large step up, we cap the requested pixel count to be at
232 // most four time the current number of pixels.
Oskar Sundbom8e07c132018-01-08 16:45:42 +0100233 sink_wants_.target_pixel_count = (pixel_count * 5) / 3;
sprangc5d62e22017-04-02 23:53:04 -0700234 }
Mirko Bonadei675513b2017-11-09 11:09:25 +0100235 RTC_LOG(LS_INFO) << "Scaling up resolution, max pixels: "
236 << max_pixels_wanted;
mflodmancc3d4422017-08-03 08:27:51 -0700237 source_->AddOrUpdateSink(video_stream_encoder_,
238 GetActiveSinkWantsInternal());
asapersson13874762017-06-07 00:01:02 -0700239 return true;
sprangc5d62e22017-04-02 23:53:04 -0700240 }
241
sprangfda496a2017-06-15 04:21:07 -0700242 // Request upgrade in framerate. Returns the new requested frame, or -1 if
243 // no change requested. Note that maxint may be returned if limits due to
244 // adaptation requests are removed completely. In that case, consider
245 // |max_framerate_| to be the current limit (assuming the capturer complies).
246 int RequestHigherFramerateThan(int fps) {
asapersson13874762017-06-07 00:01:02 -0700247 // Called on the encoder task queue.
248 // The input frame rate will be scaled up to the last step, with rounding.
249 int framerate_wanted = fps;
250 if (fps != std::numeric_limits<int>::max())
251 framerate_wanted = (fps * 3) / 2;
252
sprangfda496a2017-06-15 04:21:07 -0700253 return IncreaseFramerate(framerate_wanted) ? framerate_wanted : -1;
asapersson13874762017-06-07 00:01:02 -0700254 }
255
256 bool RestrictFramerate(int fps) {
sprangc5d62e22017-04-02 23:53:04 -0700257 // Called on the encoder task queue.
258 rtc::CritScope lock(&crit_);
asapersson13874762017-06-07 00:01:02 -0700259 if (!source_ || !IsFramerateScalingEnabled(degradation_preference_))
260 return false;
261
262 const int fps_wanted = std::max(kMinFramerateFps, fps);
263 if (fps_wanted >= sink_wants_.max_framerate_fps)
264 return false;
265
Mirko Bonadei675513b2017-11-09 11:09:25 +0100266 RTC_LOG(LS_INFO) << "Scaling down framerate: " << fps_wanted;
asapersson13874762017-06-07 00:01:02 -0700267 sink_wants_.max_framerate_fps = fps_wanted;
mflodmancc3d4422017-08-03 08:27:51 -0700268 source_->AddOrUpdateSink(video_stream_encoder_,
269 GetActiveSinkWantsInternal());
asapersson13874762017-06-07 00:01:02 -0700270 return true;
271 }
272
273 bool IncreaseFramerate(int fps) {
274 // Called on the encoder task queue.
275 rtc::CritScope lock(&crit_);
276 if (!source_ || !IsFramerateScalingEnabled(degradation_preference_))
277 return false;
278
279 const int fps_wanted = std::max(kMinFramerateFps, fps);
280 if (fps_wanted <= sink_wants_.max_framerate_fps)
281 return false;
282
Mirko Bonadei675513b2017-11-09 11:09:25 +0100283 RTC_LOG(LS_INFO) << "Scaling up framerate: " << fps_wanted;
asapersson13874762017-06-07 00:01:02 -0700284 sink_wants_.max_framerate_fps = fps_wanted;
mflodmancc3d4422017-08-03 08:27:51 -0700285 source_->AddOrUpdateSink(video_stream_encoder_,
286 GetActiveSinkWantsInternal());
asapersson13874762017-06-07 00:01:02 -0700287 return true;
perkj803d97f2016-11-01 11:45:46 -0700288 }
289
perkja49cbd32016-09-16 07:53:41 -0700290 private:
sprangfda496a2017-06-15 04:21:07 -0700291 rtc::VideoSinkWants GetActiveSinkWantsInternal()
danilchapa37de392017-09-09 04:17:22 -0700292 RTC_EXCLUSIVE_LOCKS_REQUIRED(&crit_) {
sprangfda496a2017-06-15 04:21:07 -0700293 rtc::VideoSinkWants wants = sink_wants_;
294 // Clear any constraints from the current sink wants that don't apply to
295 // the used degradation_preference.
296 switch (degradation_preference_) {
297 case VideoSendStream::DegradationPreference::kBalanced:
298 break;
299 case VideoSendStream::DegradationPreference::kMaintainFramerate:
300 wants.max_framerate_fps = std::numeric_limits<int>::max();
301 break;
302 case VideoSendStream::DegradationPreference::kMaintainResolution:
303 wants.max_pixel_count = std::numeric_limits<int>::max();
304 wants.target_pixel_count.reset();
305 break;
306 case VideoSendStream::DegradationPreference::kDegradationDisabled:
307 wants.max_pixel_count = std::numeric_limits<int>::max();
308 wants.target_pixel_count.reset();
309 wants.max_framerate_fps = std::numeric_limits<int>::max();
310 }
311 return wants;
312 }
313
perkja49cbd32016-09-16 07:53:41 -0700314 rtc::CriticalSection crit_;
315 rtc::SequencedTaskChecker main_checker_;
mflodmancc3d4422017-08-03 08:27:51 -0700316 VideoStreamEncoder* const video_stream_encoder_;
danilchapa37de392017-09-09 04:17:22 -0700317 rtc::VideoSinkWants sink_wants_ RTC_GUARDED_BY(&crit_);
hbos8d609f62017-04-10 07:39:05 -0700318 VideoSendStream::DegradationPreference degradation_preference_
danilchapa37de392017-09-09 04:17:22 -0700319 RTC_GUARDED_BY(&crit_);
320 rtc::VideoSourceInterface<VideoFrame>* source_ RTC_GUARDED_BY(&crit_);
perkja49cbd32016-09-16 07:53:41 -0700321
322 RTC_DISALLOW_COPY_AND_ASSIGN(VideoSourceProxy);
323};
324
Åsa Persson0122e842017-10-16 12:19:23 +0200325VideoStreamEncoder::VideoStreamEncoder(
326 uint32_t number_of_cores,
327 SendStatisticsProxy* stats_proxy,
328 const VideoSendStream::Config::EncoderSettings& settings,
329 rtc::VideoSinkInterface<VideoFrame>* pre_encode_callback,
Åsa Persson0122e842017-10-16 12:19:23 +0200330 std::unique_ptr<OveruseFrameDetector> overuse_detector)
perkj26091b12016-09-01 01:17:40 -0700331 : shutdown_event_(true /* manual_reset */, false),
332 number_of_cores_(number_of_cores),
kthelgason2bc68642017-02-07 07:02:22 -0800333 initial_rampup_(0),
Åsa Perssona945aee2018-04-24 16:53:25 +0200334 quality_scaling_experiment_enabled_(QualityScalingExperiment::Enabled()),
perkja49cbd32016-09-16 07:53:41 -0700335 source_proxy_(new VideoSourceProxy(this)),
Pera48ddb72016-09-29 11:48:50 +0200336 sink_(nullptr),
perkj26091b12016-09-01 01:17:40 -0700337 settings_(settings),
Niels Möllera0565992017-10-24 11:37:08 +0200338 video_sender_(Clock::GetRealTimeClock(), this),
Niels Möller73f29cb2018-01-31 16:09:31 +0100339 overuse_detector_(std::move(overuse_detector)),
Peter Boström7083e112015-09-22 16:28:51 +0200340 stats_proxy_(stats_proxy),
perkj26091b12016-09-01 01:17:40 -0700341 pre_encode_callback_(pre_encode_callback),
sprangfda496a2017-06-15 04:21:07 -0700342 max_framerate_(-1),
perkjfa10b552016-10-02 23:45:26 -0700343 pending_encoder_reconfiguration_(false),
Niels Möller4db138e2018-04-19 09:04:13 +0200344 pending_encoder_creation_(false),
perkj26091b12016-09-01 01:17:40 -0700345 encoder_start_bitrate_bps_(0),
Pera48ddb72016-09-29 11:48:50 +0200346 max_data_payload_length_(0),
asapersson5f7226f2016-11-25 04:37:00 -0800347 nack_enabled_(false),
pbos@webrtc.org143451d2015-03-18 14:40:03 +0000348 last_observed_bitrate_bps_(0),
stefan@webrtc.org792f1a12015-03-04 12:24:26 +0000349 encoder_paused_and_dropped_frame_(false),
perkj26091b12016-09-01 01:17:40 -0700350 clock_(Clock::GetRealTimeClock()),
hbos8d609f62017-04-10 07:39:05 -0700351 degradation_preference_(
352 VideoSendStream::DegradationPreference::kDegradationDisabled),
Yuwei Huangd9f99c12017-10-24 15:40:52 -0700353 posted_frames_waiting_for_encode_(0),
perkj26091b12016-09-01 01:17:40 -0700354 last_captured_timestamp_(0),
355 delta_ntp_internal_ms_(clock_->CurrentNtpInMilliseconds() -
356 clock_->TimeInMilliseconds()),
asapersson6ffb67d2016-09-12 00:10:45 -0700357 last_frame_log_ms_(clock_->TimeInMilliseconds()),
358 captured_frame_count_(0),
359 dropped_frame_count_(0),
sprang1a646ee2016-12-01 06:34:11 -0800360 bitrate_observer_(nullptr),
perkj26091b12016-09-01 01:17:40 -0700361 encoder_queue_("EncoderQueue") {
sprang552c7c72017-02-13 04:41:45 -0800362 RTC_DCHECK(stats_proxy);
Niels Möller73f29cb2018-01-31 16:09:31 +0100363 RTC_DCHECK(overuse_detector_);
mflodman@webrtc.org02270cd2015-02-06 13:10:19 +0000364}
365
mflodmancc3d4422017-08-03 08:27:51 -0700366VideoStreamEncoder::~VideoStreamEncoder() {
perkja49cbd32016-09-16 07:53:41 -0700367 RTC_DCHECK_RUN_ON(&thread_checker_);
perkj26091b12016-09-01 01:17:40 -0700368 RTC_DCHECK(shutdown_event_.Wait(0))
369 << "Must call ::Stop() before destruction.";
370}
371
mflodmancc3d4422017-08-03 08:27:51 -0700372void VideoStreamEncoder::Stop() {
perkja49cbd32016-09-16 07:53:41 -0700373 RTC_DCHECK_RUN_ON(&thread_checker_);
hbos8d609f62017-04-10 07:39:05 -0700374 source_proxy_->SetSource(nullptr, VideoSendStream::DegradationPreference());
perkja49cbd32016-09-16 07:53:41 -0700375 encoder_queue_.PostTask([this] {
376 RTC_DCHECK_RUN_ON(&encoder_queue_);
sprangfda496a2017-06-15 04:21:07 -0700377 overuse_detector_->StopCheckForOveruse();
Erik Språng08127a92016-11-16 16:41:30 +0100378 rate_allocator_.reset();
sprang1a646ee2016-12-01 06:34:11 -0800379 bitrate_observer_ = nullptr;
Niels Möllerbf3dbb42018-03-16 13:38:46 +0100380 video_sender_.RegisterExternalEncoder(nullptr, false);
kthelgason876222f2016-11-29 01:44:11 -0800381 quality_scaler_ = nullptr;
perkja49cbd32016-09-16 07:53:41 -0700382 shutdown_event_.Set();
383 });
384
385 shutdown_event_.Wait(rtc::Event::kForever);
perkj26091b12016-09-01 01:17:40 -0700386}
387
mflodmancc3d4422017-08-03 08:27:51 -0700388void VideoStreamEncoder::SetBitrateObserver(
sprang1a646ee2016-12-01 06:34:11 -0800389 VideoBitrateAllocationObserver* bitrate_observer) {
390 RTC_DCHECK_RUN_ON(&thread_checker_);
391 encoder_queue_.PostTask([this, bitrate_observer] {
392 RTC_DCHECK_RUN_ON(&encoder_queue_);
393 RTC_DCHECK(!bitrate_observer_);
394 bitrate_observer_ = bitrate_observer;
395 });
396}
397
mflodmancc3d4422017-08-03 08:27:51 -0700398void VideoStreamEncoder::SetSource(
perkj803d97f2016-11-01 11:45:46 -0700399 rtc::VideoSourceInterface<VideoFrame>* source,
asapersson09f05612017-05-15 23:40:18 -0700400 const VideoSendStream::DegradationPreference& degradation_preference) {
perkja49cbd32016-09-16 07:53:41 -0700401 RTC_DCHECK_RUN_ON(&thread_checker_);
perkj803d97f2016-11-01 11:45:46 -0700402 source_proxy_->SetSource(source, degradation_preference);
403 encoder_queue_.PostTask([this, degradation_preference] {
404 RTC_DCHECK_RUN_ON(&encoder_queue_);
sprangc5d62e22017-04-02 23:53:04 -0700405 if (degradation_preference_ != degradation_preference) {
406 // Reset adaptation state, so that we're not tricked into thinking there's
407 // an already pending request of the same type.
408 last_adaptation_request_.reset();
asaperssonf7e294d2017-06-13 23:25:22 -0700409 if (degradation_preference ==
410 VideoSendStream::DegradationPreference::kBalanced ||
411 degradation_preference_ ==
412 VideoSendStream::DegradationPreference::kBalanced) {
413 // TODO(asapersson): Consider removing |adapt_counters_| map and use one
414 // AdaptCounter for all modes.
415 source_proxy_->ResetPixelFpsCount();
416 adapt_counters_.clear();
417 }
sprangc5d62e22017-04-02 23:53:04 -0700418 }
sprangb1ca0732017-02-01 08:38:12 -0800419 degradation_preference_ = degradation_preference;
asapersson91914e22017-06-01 00:34:08 -0700420 bool allow_scaling = IsResolutionScalingEnabled(degradation_preference_);
sprangc5d62e22017-04-02 23:53:04 -0700421 initial_rampup_ = allow_scaling ? 0 : kMaxInitialFramedrop;
Niels Möller4db138e2018-04-19 09:04:13 +0200422
Niels Möller2d061182018-04-24 09:13:08 +0200423 if (encoder_)
424 ConfigureQualityScaler();
Niels Möller4db138e2018-04-19 09:04:13 +0200425
Niels Möller7dc26b72017-12-06 10:27:48 +0100426 if (!IsFramerateScalingEnabled(degradation_preference) &&
427 max_framerate_ != -1) {
428 // If frame rate scaling is no longer allowed, remove any potential
429 // allowance for longer frame intervals.
430 overuse_detector_->OnTargetFramerateUpdated(max_framerate_);
431 }
perkj803d97f2016-11-01 11:45:46 -0700432 });
perkja49cbd32016-09-16 07:53:41 -0700433}
434
mflodmancc3d4422017-08-03 08:27:51 -0700435void VideoStreamEncoder::SetSink(EncoderSink* sink, bool rotation_applied) {
perkj803d97f2016-11-01 11:45:46 -0700436 source_proxy_->SetWantsRotationApplied(rotation_applied);
perkj26091b12016-09-01 01:17:40 -0700437 encoder_queue_.PostTask([this, sink] {
438 RTC_DCHECK_RUN_ON(&encoder_queue_);
439 sink_ = sink;
440 });
mflodman@webrtc.org84d17832011-12-01 17:02:23 +0000441}
442
mflodmancc3d4422017-08-03 08:27:51 -0700443void VideoStreamEncoder::SetStartBitrate(int start_bitrate_bps) {
perkj26091b12016-09-01 01:17:40 -0700444 encoder_queue_.PostTask([this, start_bitrate_bps] {
445 RTC_DCHECK_RUN_ON(&encoder_queue_);
446 encoder_start_bitrate_bps_ = start_bitrate_bps;
447 });
mflodman@webrtc.org84d17832011-12-01 17:02:23 +0000448}
Peter Boström00b9d212016-05-19 16:59:03 +0200449
mflodmancc3d4422017-08-03 08:27:51 -0700450void VideoStreamEncoder::ConfigureEncoder(VideoEncoderConfig config,
451 size_t max_data_payload_length,
452 bool nack_enabled) {
Sebastian Jansson3dc01252018-03-19 19:27:44 +0100453 // TODO(srte): This struct should be replaced by a lambda with move capture
454 // when C++14 lambda is allowed.
455 struct ConfigureEncoderTask {
456 void operator()() {
457 encoder->ConfigureEncoderOnTaskQueue(
458 std::move(config), max_data_payload_length, nack_enabled);
459 }
460 VideoStreamEncoder* encoder;
461 VideoEncoderConfig config;
462 size_t max_data_payload_length;
463 bool nack_enabled;
464 };
465 encoder_queue_.PostTask(ConfigureEncoderTask{
466 this, std::move(config), max_data_payload_length, nack_enabled});
perkj26091b12016-09-01 01:17:40 -0700467}
468
mflodmancc3d4422017-08-03 08:27:51 -0700469void VideoStreamEncoder::ConfigureEncoderOnTaskQueue(
470 VideoEncoderConfig config,
471 size_t max_data_payload_length,
472 bool nack_enabled) {
perkj26091b12016-09-01 01:17:40 -0700473 RTC_DCHECK_RUN_ON(&encoder_queue_);
perkj26091b12016-09-01 01:17:40 -0700474 RTC_DCHECK(sink_);
Mirko Bonadei675513b2017-11-09 11:09:25 +0100475 RTC_LOG(LS_INFO) << "ConfigureEncoder requested.";
Pera48ddb72016-09-29 11:48:50 +0200476
477 max_data_payload_length_ = max_data_payload_length;
asapersson5f7226f2016-11-25 04:37:00 -0800478 nack_enabled_ = nack_enabled;
Niels Möller4db138e2018-04-19 09:04:13 +0200479 pending_encoder_creation_ =
480 (!encoder_ || encoder_config_.video_format != config.video_format);
Pera48ddb72016-09-29 11:48:50 +0200481 encoder_config_ = std::move(config);
perkjfa10b552016-10-02 23:45:26 -0700482 pending_encoder_reconfiguration_ = true;
Pera48ddb72016-09-29 11:48:50 +0200483
perkjfa10b552016-10-02 23:45:26 -0700484 // Reconfigure the encoder now if the encoder has an internal source or
Per21d45d22016-10-30 21:37:57 +0100485 // if the frame resolution is known. Otherwise, the reconfiguration is
486 // deferred until the next frame to minimize the number of reconfigurations.
487 // The codec configuration depends on incoming video frame size.
488 if (last_frame_info_) {
489 ReconfigureEncoder();
Niels Möller4db138e2018-04-19 09:04:13 +0200490 } else if (settings_.encoder_factory->QueryVideoEncoder(
491 encoder_config_.video_format).has_internal_source) {
Niels Moller0d650b42018-04-18 07:17:07 +0000492 last_frame_info_ = VideoFrameInfo(176, 144, false);
493 ReconfigureEncoder();
perkjfa10b552016-10-02 23:45:26 -0700494 }
495}
perkj26091b12016-09-01 01:17:40 -0700496
Seth Hampsoncc7125f2018-02-02 08:46:16 -0800497// TODO(bugs.webrtc.org/8807): Currently this always does a hard
498// reconfiguration, but this isn't always necessary. Add in logic to only update
499// the VideoBitrateAllocator and call OnEncoderConfigurationChanged with a
500// "soft" reconfiguration.
mflodmancc3d4422017-08-03 08:27:51 -0700501void VideoStreamEncoder::ReconfigureEncoder() {
perkjfa10b552016-10-02 23:45:26 -0700502 RTC_DCHECK(pending_encoder_reconfiguration_);
503 std::vector<VideoStream> streams =
504 encoder_config_.video_stream_factory->CreateEncoderStreams(
505 last_frame_info_->width, last_frame_info_->height, encoder_config_);
perkj26091b12016-09-01 01:17:40 -0700506
ilnik6b826ef2017-06-16 06:53:48 -0700507 // TODO(ilnik): If configured resolution is significantly less than provided,
508 // e.g. because there are not enough SSRCs for all simulcast streams,
509 // signal new resolutions via SinkWants to video source.
510
511 // Stream dimensions may be not equal to given because of a simulcast
512 // restrictions.
513 int highest_stream_width = static_cast<int>(streams.back().width);
514 int highest_stream_height = static_cast<int>(streams.back().height);
515 // Dimension may be reduced to be, e.g. divisible by 4.
516 RTC_CHECK_GE(last_frame_info_->width, highest_stream_width);
517 RTC_CHECK_GE(last_frame_info_->height, highest_stream_height);
518 crop_width_ = last_frame_info_->width - highest_stream_width;
519 crop_height_ = last_frame_info_->height - highest_stream_height;
520
Erik Språng08127a92016-11-16 16:41:30 +0100521 VideoCodec codec;
Niels Möller259a4972018-04-05 15:36:51 +0200522 if (!VideoCodecInitializer::SetupCodec(
523 encoder_config_, streams, nack_enabled_, &codec, &rate_allocator_)) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100524 RTC_LOG(LS_ERROR) << "Failed to create encoder configuration.";
Erik Språng08127a92016-11-16 16:41:30 +0100525 }
perkjfa10b552016-10-02 23:45:26 -0700526
527 codec.startBitrate =
528 std::max(encoder_start_bitrate_bps_ / 1000, codec.minBitrate);
529 codec.startBitrate = std::min(codec.startBitrate, codec.maxBitrate);
530 codec.expect_encode_from_texture = last_frame_info_->is_texture;
sprangfda496a2017-06-15 04:21:07 -0700531 max_framerate_ = codec.maxFramerate;
532 RTC_DCHECK_LE(max_framerate_, kMaxFramerateFps);
Stefan Holmere5904162015-03-26 11:11:06 +0100533
Niels Möller4db138e2018-04-19 09:04:13 +0200534 // Keep the same encoder, as long as the video_format is unchanged.
535 if (pending_encoder_creation_) {
536 pending_encoder_creation_ = false;
537 if (encoder_) {
538 video_sender_.RegisterExternalEncoder(nullptr, false);
539 }
540
541 encoder_ = settings_.encoder_factory->CreateVideoEncoder(
542 encoder_config_.video_format);
543 // TODO(nisse): What to do if creating the encoder fails? Crash,
544 // or just discard incoming frames?
545 RTC_CHECK(encoder_);
546
Niels Möller4db138e2018-04-19 09:04:13 +0200547 const webrtc::VideoEncoderFactory::CodecInfo info =
548 settings_.encoder_factory->QueryVideoEncoder(
549 encoder_config_.video_format);
550
551 overuse_detector_->StopCheckForOveruse();
552 overuse_detector_->StartCheckForOveruse(
553 GetCpuOveruseOptions(settings_, info.is_hardware_accelerated), this);
554
555 video_sender_.RegisterExternalEncoder(encoder_.get(),
556 info.has_internal_source);
557 }
558 // RegisterSendCodec implies an unconditional call to
559 // encoder_->InitEncode().
Peter Boströmcd5c25c2016-04-21 16:48:08 +0200560 bool success = video_sender_.RegisterSendCodec(
perkjfa10b552016-10-02 23:45:26 -0700561 &codec, number_of_cores_,
562 static_cast<uint32_t>(max_data_payload_length_)) == VCM_OK;
Peter Boström905f8e72016-03-02 16:59:56 +0100563 if (!success) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100564 RTC_LOG(LS_ERROR) << "Failed to configure encoder.";
sprangfe627f32017-03-29 08:24:59 -0700565 rate_allocator_.reset();
mflodman@webrtc.org84d17832011-12-01 17:02:23 +0000566 }
Peter Boström905f8e72016-03-02 16:59:56 +0100567
Niels Möller96d7f762018-01-30 11:27:16 +0100568 video_sender_.UpdateChannelParameters(rate_allocator_.get(),
ilnik35b7de42017-03-15 04:24:21 -0700569 bitrate_observer_);
570
sprangfda496a2017-06-15 04:21:07 -0700571 // Get the current actual framerate, as measured by the stats proxy. This is
572 // used to get the correct bitrate layer allocation.
573 int current_framerate = stats_proxy_->GetSendFrameRate();
574 if (current_framerate == 0)
575 current_framerate = codec.maxFramerate;
sprang552c7c72017-02-13 04:41:45 -0800576 stats_proxy_->OnEncoderReconfigured(
Åsa Perssonaa329e72017-12-15 15:54:44 +0100577 encoder_config_, streams,
sprangfda496a2017-06-15 04:21:07 -0700578 rate_allocator_.get()
579 ? rate_allocator_->GetPreferredBitrateBps(current_framerate)
580 : codec.maxBitrate);
Per512ecb32016-09-23 15:52:06 +0200581
perkjfa10b552016-10-02 23:45:26 -0700582 pending_encoder_reconfiguration_ = false;
Erik Språng08127a92016-11-16 16:41:30 +0100583
Pera48ddb72016-09-29 11:48:50 +0200584 sink_->OnEncoderConfigurationChanged(
perkjfa10b552016-10-02 23:45:26 -0700585 std::move(streams), encoder_config_.min_transmit_bitrate_bps);
kthelgason876222f2016-11-29 01:44:11 -0800586
Niels Möller7dc26b72017-12-06 10:27:48 +0100587 // Get the current target framerate, ie the maximum framerate as specified by
588 // the current codec configuration, or any limit imposed by cpu adaption in
589 // maintain-resolution or balanced mode. This is used to make sure overuse
590 // detection doesn't needlessly trigger in low and/or variable framerate
591 // scenarios.
592 int target_framerate = std::min(
593 max_framerate_, source_proxy_->GetActiveSinkWants().max_framerate_fps);
594 overuse_detector_->OnTargetFramerateUpdated(target_framerate);
Niels Möller2d061182018-04-24 09:13:08 +0200595
596 ConfigureQualityScaler();
kthelgason2bc68642017-02-07 07:02:22 -0800597}
598
mflodmancc3d4422017-08-03 08:27:51 -0700599void VideoStreamEncoder::ConfigureQualityScaler() {
kthelgason2bc68642017-02-07 07:02:22 -0800600 RTC_DCHECK_RUN_ON(&encoder_queue_);
Niels Möller4db138e2018-04-19 09:04:13 +0200601 const auto scaling_settings = encoder_->GetScalingSettings();
asapersson36e9eb42017-03-31 05:29:12 -0700602 const bool quality_scaling_allowed =
asapersson91914e22017-06-01 00:34:08 -0700603 IsResolutionScalingEnabled(degradation_preference_) &&
Niels Möller225c7872018-02-22 15:03:53 +0100604 scaling_settings.thresholds;
kthelgason3af6cc02017-03-22 00:25:28 -0700605
asapersson36e9eb42017-03-31 05:29:12 -0700606 if (quality_scaling_allowed) {
asapersson09f05612017-05-15 23:40:18 -0700607 if (quality_scaler_.get() == nullptr) {
608 // Quality scaler has not already been configured.
609 // Drop frames and scale down until desired quality is achieved.
Niels Möller225c7872018-02-22 15:03:53 +0100610
Åsa Perssona945aee2018-04-24 16:53:25 +0200611 // Use experimental thresholds if available.
612 rtc::Optional<VideoEncoder::QpThresholds> experimental_thresholds;
613 if (quality_scaling_experiment_enabled_) {
614 experimental_thresholds = QualityScalingExperiment::GetQpThresholds(
615 encoder_config_.codec_type);
616 }
Niels Möller225c7872018-02-22 15:03:53 +0100617 // Since the interface is non-public, MakeUnique can't do this upcast.
618 AdaptationObserverInterface* observer = this;
619 quality_scaler_ = rtc::MakeUnique<QualityScaler>(
Åsa Perssona945aee2018-04-24 16:53:25 +0200620 observer, experimental_thresholds ? *experimental_thresholds
621 : *(scaling_settings.thresholds));
kthelgason876222f2016-11-29 01:44:11 -0800622 }
623 } else {
624 quality_scaler_.reset(nullptr);
kthelgasonad9010c2017-02-14 00:46:51 -0800625 initial_rampup_ = kMaxInitialFramedrop;
kthelgason876222f2016-11-29 01:44:11 -0800626 }
asapersson09f05612017-05-15 23:40:18 -0700627
628 stats_proxy_->SetAdaptationStats(GetActiveCounts(kCpu),
629 GetActiveCounts(kQuality));
mflodman@webrtc.org84d17832011-12-01 17:02:23 +0000630}
631
mflodmancc3d4422017-08-03 08:27:51 -0700632void VideoStreamEncoder::OnFrame(const VideoFrame& video_frame) {
perkj26091b12016-09-01 01:17:40 -0700633 RTC_DCHECK_RUNS_SERIALIZED(&incoming_frame_race_checker_);
perkj26091b12016-09-01 01:17:40 -0700634 VideoFrame incoming_frame = video_frame;
635
636 // Local time in webrtc time base.
ilnik04f4d122017-06-19 07:18:55 -0700637 int64_t current_time_us = clock_->TimeInMicroseconds();
638 int64_t current_time_ms = current_time_us / rtc::kNumMicrosecsPerMillisec;
639 // In some cases, e.g., when the frame from decoder is fed to encoder,
640 // the timestamp may be set to the future. As the encoding pipeline assumes
641 // capture time to be less than present time, we should reset the capture
642 // timestamps here. Otherwise there may be issues with RTP send stream.
643 if (incoming_frame.timestamp_us() > current_time_us)
644 incoming_frame.set_timestamp_us(current_time_us);
perkj26091b12016-09-01 01:17:40 -0700645
646 // Capture time may come from clock with an offset and drift from clock_.
647 int64_t capture_ntp_time_ms;
nisse891419f2017-01-12 10:02:22 -0800648 if (video_frame.ntp_time_ms() > 0) {
perkj26091b12016-09-01 01:17:40 -0700649 capture_ntp_time_ms = video_frame.ntp_time_ms();
650 } else if (video_frame.render_time_ms() != 0) {
651 capture_ntp_time_ms = video_frame.render_time_ms() + delta_ntp_internal_ms_;
652 } else {
nisse1c0dea82017-01-30 02:43:18 -0800653 capture_ntp_time_ms = current_time_ms + delta_ntp_internal_ms_;
perkj26091b12016-09-01 01:17:40 -0700654 }
655 incoming_frame.set_ntp_time_ms(capture_ntp_time_ms);
656
657 // Convert NTP time, in ms, to RTP timestamp.
658 const int kMsToRtpTimestamp = 90;
659 incoming_frame.set_timestamp(
660 kMsToRtpTimestamp * static_cast<uint32_t>(incoming_frame.ntp_time_ms()));
661
662 if (incoming_frame.ntp_time_ms() <= last_captured_timestamp_) {
663 // We don't allow the same capture time for two frames, drop this one.
Mirko Bonadei675513b2017-11-09 11:09:25 +0100664 RTC_LOG(LS_WARNING) << "Same/old NTP timestamp ("
665 << incoming_frame.ntp_time_ms()
666 << " <= " << last_captured_timestamp_
667 << ") for incoming frame. Dropping.";
perkj26091b12016-09-01 01:17:40 -0700668 return;
669 }
670
asapersson6ffb67d2016-09-12 00:10:45 -0700671 bool log_stats = false;
nisse1c0dea82017-01-30 02:43:18 -0800672 if (current_time_ms - last_frame_log_ms_ > kFrameLogIntervalMs) {
673 last_frame_log_ms_ = current_time_ms;
asapersson6ffb67d2016-09-12 00:10:45 -0700674 log_stats = true;
675 }
676
perkj26091b12016-09-01 01:17:40 -0700677 last_captured_timestamp_ = incoming_frame.ntp_time_ms();
Sebastian Jansson3ab5c402018-04-05 12:30:50 +0200678
679 int64_t post_time_us = rtc::TimeMicros();
680 ++posted_frames_waiting_for_encode_;
681
682 encoder_queue_.PostTask(
683 [this, incoming_frame, post_time_us, log_stats]() {
684 RTC_DCHECK_RUN_ON(&encoder_queue_);
685 stats_proxy_->OnIncomingFrame(incoming_frame.width(),
686 incoming_frame.height());
687 ++captured_frame_count_;
688 const int posted_frames_waiting_for_encode =
689 posted_frames_waiting_for_encode_.fetch_sub(1);
690 RTC_DCHECK_GT(posted_frames_waiting_for_encode, 0);
691 if (posted_frames_waiting_for_encode == 1) {
Sebastian Janssona3177052018-04-10 13:05:49 +0200692 MaybeEncodeVideoFrame(incoming_frame, post_time_us);
Sebastian Jansson3ab5c402018-04-05 12:30:50 +0200693 } else {
694 // There is a newer frame in flight. Do not encode this frame.
695 RTC_LOG(LS_VERBOSE)
696 << "Incoming frame dropped due to that the encoder is blocked.";
697 ++dropped_frame_count_;
698 stats_proxy_->OnFrameDroppedInEncoderQueue();
699 }
700 if (log_stats) {
701 RTC_LOG(LS_INFO) << "Number of frames: captured "
702 << captured_frame_count_
703 << ", dropped (due to encoder blocked) "
704 << dropped_frame_count_ << ", interval_ms "
705 << kFrameLogIntervalMs;
706 captured_frame_count_ = 0;
707 dropped_frame_count_ = 0;
708 }
709 });
perkj26091b12016-09-01 01:17:40 -0700710}
711
Ilya Nikolaevskiyd79314f2017-10-23 10:45:37 +0200712void VideoStreamEncoder::OnDiscardedFrame() {
713 stats_proxy_->OnFrameDroppedBySource();
714}
715
mflodmancc3d4422017-08-03 08:27:51 -0700716bool VideoStreamEncoder::EncoderPaused() const {
perkj26091b12016-09-01 01:17:40 -0700717 RTC_DCHECK_RUN_ON(&encoder_queue_);
pwestin@webrtc.org91563e42013-04-25 22:20:08 +0000718 // Pause video if paused by caller or as long as the network is down or the
719 // pacer queue has grown too large in buffered mode.
perkj57c21f92016-06-17 07:27:16 -0700720 // If the pacer queue has grown too large or the network is down,
perkjfea93092016-05-14 00:58:48 -0700721 // last_observed_bitrate_bps_ will be 0.
perkj26091b12016-09-01 01:17:40 -0700722 return last_observed_bitrate_bps_ == 0;
stefan@webrtc.orgbfacda62013-03-27 16:36:01 +0000723}
724
mflodmancc3d4422017-08-03 08:27:51 -0700725void VideoStreamEncoder::TraceFrameDropStart() {
perkj26091b12016-09-01 01:17:40 -0700726 RTC_DCHECK_RUN_ON(&encoder_queue_);
sprang@webrtc.orgdcebf2d2014-11-04 16:27:16 +0000727 // Start trace event only on the first frame after encoder is paused.
728 if (!encoder_paused_and_dropped_frame_) {
729 TRACE_EVENT_ASYNC_BEGIN0("webrtc", "EncoderPaused", this);
730 }
731 encoder_paused_and_dropped_frame_ = true;
sprang@webrtc.orgdcebf2d2014-11-04 16:27:16 +0000732}
733
mflodmancc3d4422017-08-03 08:27:51 -0700734void VideoStreamEncoder::TraceFrameDropEnd() {
perkj26091b12016-09-01 01:17:40 -0700735 RTC_DCHECK_RUN_ON(&encoder_queue_);
sprang@webrtc.orgdcebf2d2014-11-04 16:27:16 +0000736 // End trace event on first frame after encoder resumes, if frame was dropped.
737 if (encoder_paused_and_dropped_frame_) {
738 TRACE_EVENT_ASYNC_END0("webrtc", "EncoderPaused", this);
739 }
740 encoder_paused_and_dropped_frame_ = false;
741}
742
Sebastian Janssona3177052018-04-10 13:05:49 +0200743void VideoStreamEncoder::MaybeEncodeVideoFrame(const VideoFrame& video_frame,
744 int64_t time_when_posted_us) {
perkj26091b12016-09-01 01:17:40 -0700745 RTC_DCHECK_RUN_ON(&encoder_queue_);
kthelgason876222f2016-11-29 01:44:11 -0800746
perkj26091b12016-09-01 01:17:40 -0700747 if (pre_encode_callback_)
748 pre_encode_callback_->OnFrame(video_frame);
749
Per21d45d22016-10-30 21:37:57 +0100750 if (!last_frame_info_ || video_frame.width() != last_frame_info_->width ||
perkjfa10b552016-10-02 23:45:26 -0700751 video_frame.height() != last_frame_info_->height ||
perkjfa10b552016-10-02 23:45:26 -0700752 video_frame.is_texture() != last_frame_info_->is_texture) {
753 pending_encoder_reconfiguration_ = true;
Oskar Sundbom8e07c132018-01-08 16:45:42 +0100754 last_frame_info_ = VideoFrameInfo(video_frame.width(), video_frame.height(),
755 video_frame.is_texture());
Mirko Bonadei675513b2017-11-09 11:09:25 +0100756 RTC_LOG(LS_INFO) << "Video frame parameters changed: dimensions="
757 << last_frame_info_->width << "x"
758 << last_frame_info_->height
759 << ", texture=" << last_frame_info_->is_texture << ".";
perkjfa10b552016-10-02 23:45:26 -0700760 }
761
Niels Möller4db138e2018-04-19 09:04:13 +0200762 // We have to create then encoder before the frame drop logic,
763 // because the latter depends on encoder_->GetScalingSettings.
764 // According to the testcase
765 // InitialFrameDropOffWhenEncoderDisabledScaling, the return value
766 // from GetScalingSettings should enable or disable the frame drop.
767
768 int64_t now_ms = clock_->TimeInMilliseconds();
769 if (pending_encoder_reconfiguration_) {
770 ReconfigureEncoder();
771 last_parameters_update_ms_.emplace(now_ms);
772 } else if (!last_parameters_update_ms_ ||
773 now_ms - *last_parameters_update_ms_ >=
774 vcm::VCMProcessTimer::kDefaultProcessIntervalMs) {
775 video_sender_.UpdateChannelParameters(rate_allocator_.get(),
776 bitrate_observer_);
777 last_parameters_update_ms_.emplace(now_ms);
778 }
779
Sebastian Janssona3177052018-04-10 13:05:49 +0200780 if (DropDueToSize(video_frame.size())) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100781 RTC_LOG(LS_INFO) << "Dropping frame. Too large for target bitrate.";
Åsa Persson875841d2018-01-08 08:49:53 +0100782 int count = GetConstAdaptCounter().ResolutionCount(kQuality);
kthelgason2bc68642017-02-07 07:02:22 -0800783 AdaptDown(kQuality);
Åsa Persson875841d2018-01-08 08:49:53 +0100784 if (GetConstAdaptCounter().ResolutionCount(kQuality) > count) {
785 stats_proxy_->OnInitialQualityResolutionAdaptDown();
786 }
kthelgason2bc68642017-02-07 07:02:22 -0800787 ++initial_rampup_;
Sebastian Jansson0d70e372018-04-17 13:57:13 +0200788 // Storing references to a native buffer risks blocking frame capture.
789 if (video_frame.video_frame_buffer()->type() !=
790 VideoFrameBuffer::Type::kNative) {
791 pending_frame_ = video_frame;
792 pending_frame_post_time_us_ = time_when_posted_us;
793 } else {
794 // Ensure that any previously stored frame is dropped.
795 pending_frame_.reset();
796 }
kthelgason2bc68642017-02-07 07:02:22 -0800797 return;
798 }
799 initial_rampup_ = kMaxInitialFramedrop;
800
perkjfa10b552016-10-02 23:45:26 -0700801
perkj26091b12016-09-01 01:17:40 -0700802 if (EncoderPaused()) {
Sebastian Jansson0d70e372018-04-17 13:57:13 +0200803 // Storing references to a native buffer risks blocking frame capture.
804 if (video_frame.video_frame_buffer()->type() !=
805 VideoFrameBuffer::Type::kNative) {
806 if (pending_frame_)
807 TraceFrameDropStart();
808 pending_frame_ = video_frame;
809 pending_frame_post_time_us_ = time_when_posted_us;
810 } else {
811 // Ensure that any previously stored frame is dropped.
812 pending_frame_.reset();
Sebastian Janssona3177052018-04-10 13:05:49 +0200813 TraceFrameDropStart();
Sebastian Jansson0d70e372018-04-17 13:57:13 +0200814 }
perkj26091b12016-09-01 01:17:40 -0700815 return;
mflodman@webrtc.org84d17832011-12-01 17:02:23 +0000816 }
Sebastian Janssona3177052018-04-10 13:05:49 +0200817
818 pending_frame_.reset();
819 EncodeVideoFrame(video_frame, time_when_posted_us);
820}
821
822void VideoStreamEncoder::EncodeVideoFrame(const VideoFrame& video_frame,
823 int64_t time_when_posted_us) {
824 RTC_DCHECK_RUN_ON(&encoder_queue_);
perkj26091b12016-09-01 01:17:40 -0700825 TraceFrameDropEnd();
niklase@google.com470e71d2011-07-07 08:21:25 +0000826
ilnik6b826ef2017-06-16 06:53:48 -0700827 VideoFrame out_frame(video_frame);
828 // Crop frame if needed.
829 if (crop_width_ > 0 || crop_height_ > 0) {
830 int cropped_width = video_frame.width() - crop_width_;
831 int cropped_height = video_frame.height() - crop_height_;
832 rtc::scoped_refptr<I420Buffer> cropped_buffer =
833 I420Buffer::Create(cropped_width, cropped_height);
834 // TODO(ilnik): Remove scaling if cropping is too big, as it should never
835 // happen after SinkWants signaled correctly from ReconfigureEncoder.
836 if (crop_width_ < 4 && crop_height_ < 4) {
837 cropped_buffer->CropAndScaleFrom(
838 *video_frame.video_frame_buffer()->ToI420(), crop_width_ / 2,
839 crop_height_ / 2, cropped_width, cropped_height);
840 } else {
841 cropped_buffer->ScaleFrom(
842 *video_frame.video_frame_buffer()->ToI420().get());
843 }
844 out_frame =
845 VideoFrame(cropped_buffer, video_frame.timestamp(),
846 video_frame.render_time_ms(), video_frame.rotation());
847 out_frame.set_ntp_time_ms(video_frame.ntp_time_ms());
848 }
849
Magnus Jedvert26679d62015-04-07 14:07:41 +0200850 TRACE_EVENT_ASYNC_STEP0("webrtc", "Video", video_frame.render_time_ms(),
hclam@chromium.org1a7b9b92013-07-08 21:31:18 +0000851 "Encode");
pbos@webrtc.orgfe1ef932013-10-21 10:34:43 +0000852
Niels Möller7dc26b72017-12-06 10:27:48 +0100853 overuse_detector_->FrameCaptured(out_frame, time_when_posted_us);
perkjd52063f2016-09-07 06:32:18 -0700854
ilnik6b826ef2017-06-16 06:53:48 -0700855 video_sender_.AddVideoFrame(out_frame, nullptr);
niklase@google.com470e71d2011-07-07 08:21:25 +0000856}
niklase@google.com470e71d2011-07-07 08:21:25 +0000857
mflodmancc3d4422017-08-03 08:27:51 -0700858void VideoStreamEncoder::SendKeyFrame() {
perkj26091b12016-09-01 01:17:40 -0700859 if (!encoder_queue_.IsCurrent()) {
860 encoder_queue_.PostTask([this] { SendKeyFrame(); });
861 return;
862 }
863 RTC_DCHECK_RUN_ON(&encoder_queue_);
Niels Möller1c9aa1e2018-02-16 10:27:23 +0100864 TRACE_EVENT0("webrtc", "OnKeyFrameRequest");
Peter Boströmcd5c25c2016-04-21 16:48:08 +0200865 video_sender_.IntraFrameRequest(0);
stefan@webrtc.org07b45a52012-02-02 08:37:48 +0000866}
867
mflodmancc3d4422017-08-03 08:27:51 -0700868EncodedImageCallback::Result VideoStreamEncoder::OnEncodedImage(
Sergey Ulanov525df3f2016-08-02 17:46:41 -0700869 const EncodedImage& encoded_image,
870 const CodecSpecificInfo* codec_specific_info,
871 const RTPFragmentationHeader* fragmentation) {
perkj26091b12016-09-01 01:17:40 -0700872 // Encoded is called on whatever thread the real encoder implementation run
873 // on. In the case of hardware encoders, there might be several encoders
874 // running in parallel on different threads.
sprang552c7c72017-02-13 04:41:45 -0800875 stats_proxy_->OnSendEncodedImage(encoded_image, codec_specific_info);
sprang3911c262016-04-15 01:24:14 -0700876
Sergey Ulanov525df3f2016-08-02 17:46:41 -0700877 EncodedImageCallback::Result result =
878 sink_->OnEncodedImage(encoded_image, codec_specific_info, fragmentation);
perkjbc75d972016-05-02 06:31:25 -0700879
Niels Möller7dc26b72017-12-06 10:27:48 +0100880 int64_t time_sent_us = rtc::TimeMicros();
881 uint32_t timestamp = encoded_image._timeStamp;
kthelgason876222f2016-11-29 01:44:11 -0800882 const int qp = encoded_image.qp_;
Niels Möller83dbeac2017-12-14 16:39:44 +0100883 int64_t capture_time_us =
884 encoded_image.capture_time_ms_ * rtc::kNumMicrosecsPerMillisec;
885
886 rtc::Optional<int> encode_duration_us;
887 if (encoded_image.timing_.flags != TimingFrameFlags::kInvalid) {
888 encode_duration_us.emplace(
889 // TODO(nisse): Maybe use capture_time_ms_ rather than encode_start_ms_?
890 rtc::kNumMicrosecsPerMillisec *
891 (encoded_image.timing_.encode_finish_ms -
892 encoded_image.timing_.encode_start_ms));
893 }
894
895 encoder_queue_.PostTask(
896 [this, timestamp, time_sent_us, qp, capture_time_us, encode_duration_us] {
897 RTC_DCHECK_RUN_ON(&encoder_queue_);
898 overuse_detector_->FrameSent(timestamp, time_sent_us, capture_time_us,
899 encode_duration_us);
900 if (quality_scaler_ && qp >= 0)
Åsa Persson04d5f1d2018-04-20 15:19:11 +0200901 quality_scaler_->ReportQp(qp);
Niels Möller83dbeac2017-12-14 16:39:44 +0100902 });
perkj803d97f2016-11-01 11:45:46 -0700903
Sergey Ulanov525df3f2016-08-02 17:46:41 -0700904 return result;
Peter Boströmb7d9a972015-12-18 16:01:11 +0100905}
906
Ilya Nikolaevskiyd79314f2017-10-23 10:45:37 +0200907void VideoStreamEncoder::OnDroppedFrame(DropReason reason) {
908 switch (reason) {
909 case DropReason::kDroppedByMediaOptimizations:
910 stats_proxy_->OnFrameDroppedByMediaOptimizations();
911 encoder_queue_.PostTask([this] {
912 RTC_DCHECK_RUN_ON(&encoder_queue_);
913 if (quality_scaler_)
Åsa Perssona945aee2018-04-24 16:53:25 +0200914 quality_scaler_->ReportDroppedFrameByMediaOpt();
Ilya Nikolaevskiyd79314f2017-10-23 10:45:37 +0200915 });
916 break;
917 case DropReason::kDroppedByEncoder:
918 stats_proxy_->OnFrameDroppedByEncoder();
Åsa Perssona945aee2018-04-24 16:53:25 +0200919 encoder_queue_.PostTask([this] {
920 RTC_DCHECK_RUN_ON(&encoder_queue_);
921 if (quality_scaler_)
922 quality_scaler_->ReportDroppedFrameByEncoder();
923 });
Ilya Nikolaevskiyd79314f2017-10-23 10:45:37 +0200924 break;
925 }
kthelgason876222f2016-11-29 01:44:11 -0800926}
927
mflodmancc3d4422017-08-03 08:27:51 -0700928void VideoStreamEncoder::OnBitrateUpdated(uint32_t bitrate_bps,
929 uint8_t fraction_lost,
930 int64_t round_trip_time_ms) {
perkj26091b12016-09-01 01:17:40 -0700931 if (!encoder_queue_.IsCurrent()) {
932 encoder_queue_.PostTask(
933 [this, bitrate_bps, fraction_lost, round_trip_time_ms] {
934 OnBitrateUpdated(bitrate_bps, fraction_lost, round_trip_time_ms);
935 });
936 return;
937 }
938 RTC_DCHECK_RUN_ON(&encoder_queue_);
939 RTC_DCHECK(sink_) << "sink_ must be set before the encoder is active.";
940
Mirko Bonadei675513b2017-11-09 11:09:25 +0100941 RTC_LOG(LS_VERBOSE) << "OnBitrateUpdated, bitrate " << bitrate_bps
942 << " packet loss " << static_cast<int>(fraction_lost)
943 << " rtt " << round_trip_time_ms;
perkj26091b12016-09-01 01:17:40 -0700944
Peter Boströmcd5c25c2016-04-21 16:48:08 +0200945 video_sender_.SetChannelParameters(bitrate_bps, fraction_lost,
sprang1a646ee2016-12-01 06:34:11 -0800946 round_trip_time_ms, rate_allocator_.get(),
947 bitrate_observer_);
perkj26091b12016-09-01 01:17:40 -0700948
949 encoder_start_bitrate_bps_ =
950 bitrate_bps != 0 ? bitrate_bps : encoder_start_bitrate_bps_;
mflodman101f2502016-06-09 17:21:19 +0200951 bool video_is_suspended = bitrate_bps == 0;
Erik Språng08127a92016-11-16 16:41:30 +0100952 bool video_suspension_changed = video_is_suspended != EncoderPaused();
perkj26091b12016-09-01 01:17:40 -0700953 last_observed_bitrate_bps_ = bitrate_bps;
Peter Boströmd153a372015-11-10 15:27:12 +0000954
sprang552c7c72017-02-13 04:41:45 -0800955 if (video_suspension_changed) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100956 RTC_LOG(LS_INFO) << "Video suspend state changed to: "
957 << (video_is_suspended ? "suspended" : "not suspended");
Peter Boström7083e112015-09-22 16:28:51 +0200958 stats_proxy_->OnSuspendChange(video_is_suspended);
mflodman101f2502016-06-09 17:21:19 +0200959 }
Sebastian Janssona3177052018-04-10 13:05:49 +0200960 if (video_suspension_changed && !video_is_suspended && pending_frame_ &&
961 !DropDueToSize(pending_frame_->size())) {
962 int64_t pending_time_us = rtc::TimeMicros() - pending_frame_post_time_us_;
963 if (pending_time_us < kPendingFrameTimeoutMs * 1000)
964 EncodeVideoFrame(*pending_frame_, pending_frame_post_time_us_);
965 pending_frame_.reset();
966 }
967}
968
969bool VideoStreamEncoder::DropDueToSize(uint32_t pixel_count) const {
970 if (initial_rampup_ < kMaxInitialFramedrop &&
971 encoder_start_bitrate_bps_ > 0) {
972 if (encoder_start_bitrate_bps_ < 300000 /* qvga */) {
973 return pixel_count > 320 * 240;
974 } else if (encoder_start_bitrate_bps_ < 500000 /* vga */) {
975 return pixel_count > 640 * 480;
976 }
977 }
978 return false;
niklase@google.com470e71d2011-07-07 08:21:25 +0000979}
980
mflodmancc3d4422017-08-03 08:27:51 -0700981void VideoStreamEncoder::AdaptDown(AdaptReason reason) {
perkjd52063f2016-09-07 06:32:18 -0700982 RTC_DCHECK_RUN_ON(&encoder_queue_);
sprangc5d62e22017-04-02 23:53:04 -0700983 AdaptationRequest adaptation_request = {
984 last_frame_info_->pixel_count(),
985 stats_proxy_->GetStats().input_frame_rate,
986 AdaptationRequest::Mode::kAdaptDown};
asapersson09f05612017-05-15 23:40:18 -0700987
sprangc5d62e22017-04-02 23:53:04 -0700988 bool downgrade_requested =
989 last_adaptation_request_ &&
990 last_adaptation_request_->mode_ == AdaptationRequest::Mode::kAdaptDown;
991
sprangc5d62e22017-04-02 23:53:04 -0700992 switch (degradation_preference_) {
hbos8d609f62017-04-10 07:39:05 -0700993 case VideoSendStream::DegradationPreference::kBalanced:
asaperssonf7e294d2017-06-13 23:25:22 -0700994 break;
hbos8d609f62017-04-10 07:39:05 -0700995 case VideoSendStream::DegradationPreference::kMaintainFramerate:
sprangc5d62e22017-04-02 23:53:04 -0700996 if (downgrade_requested &&
997 adaptation_request.input_pixel_count_ >=
998 last_adaptation_request_->input_pixel_count_) {
999 // Don't request lower resolution if the current resolution is not
1000 // lower than the last time we asked for the resolution to be lowered.
1001 return;
1002 }
1003 break;
hbos8d609f62017-04-10 07:39:05 -07001004 case VideoSendStream::DegradationPreference::kMaintainResolution:
sprangc5d62e22017-04-02 23:53:04 -07001005 if (adaptation_request.framerate_fps_ <= 0 ||
1006 (downgrade_requested &&
1007 adaptation_request.framerate_fps_ < kMinFramerateFps)) {
1008 // If no input fps estimate available, can't determine how to scale down
1009 // framerate. Otherwise, don't request lower framerate if we don't have
1010 // a valid frame rate. Since framerate, unlike resolution, is a measure
1011 // we have to estimate, and can fluctuate naturally over time, don't
1012 // make the same kind of limitations as for resolution, but trust the
1013 // overuse detector to not trigger too often.
1014 return;
1015 }
1016 break;
hbos8d609f62017-04-10 07:39:05 -07001017 case VideoSendStream::DegradationPreference::kDegradationDisabled:
sprangc5d62e22017-04-02 23:53:04 -07001018 return;
sprang84a37592017-02-10 07:04:27 -08001019 }
sprangc5d62e22017-04-02 23:53:04 -07001020
sprangc5d62e22017-04-02 23:53:04 -07001021 switch (degradation_preference_) {
asaperssonf7e294d2017-06-13 23:25:22 -07001022 case VideoSendStream::DegradationPreference::kBalanced: {
1023 // Try scale down framerate, if lower.
1024 int fps = MinFps(last_frame_info_->pixel_count());
1025 if (source_proxy_->RestrictFramerate(fps)) {
1026 GetAdaptCounter().IncrementFramerate(reason);
1027 break;
1028 }
1029 // Scale down resolution.
Karl Wiberg80ba3332018-02-05 10:33:35 +01001030 RTC_FALLTHROUGH();
asaperssonf7e294d2017-06-13 23:25:22 -07001031 }
Åsa Perssonc3ed6302017-11-16 14:04:52 +01001032 case VideoSendStream::DegradationPreference::kMaintainFramerate: {
asapersson13874762017-06-07 00:01:02 -07001033 // Scale down resolution.
Åsa Perssonc3ed6302017-11-16 14:04:52 +01001034 bool min_pixels_reached = false;
asaperssond0de2952017-04-21 01:47:31 -07001035 if (!source_proxy_->RequestResolutionLowerThan(
asapersson142fcc92017-08-17 08:58:54 -07001036 adaptation_request.input_pixel_count_,
Niels Möller4db138e2018-04-19 09:04:13 +02001037 encoder_->GetScalingSettings().min_pixels_per_frame,
Åsa Perssonc3ed6302017-11-16 14:04:52 +01001038 &min_pixels_reached)) {
1039 if (min_pixels_reached)
1040 stats_proxy_->OnMinPixelLimitReached();
asaperssond0de2952017-04-21 01:47:31 -07001041 return;
1042 }
asaperssonf7e294d2017-06-13 23:25:22 -07001043 GetAdaptCounter().IncrementResolution(reason);
sprangc5d62e22017-04-02 23:53:04 -07001044 break;
Åsa Perssonc3ed6302017-11-16 14:04:52 +01001045 }
sprangfda496a2017-06-15 04:21:07 -07001046 case VideoSendStream::DegradationPreference::kMaintainResolution: {
asapersson13874762017-06-07 00:01:02 -07001047 // Scale down framerate.
sprangfda496a2017-06-15 04:21:07 -07001048 const int requested_framerate = source_proxy_->RequestFramerateLowerThan(
1049 adaptation_request.framerate_fps_);
1050 if (requested_framerate == -1)
asapersson13874762017-06-07 00:01:02 -07001051 return;
sprangfda496a2017-06-15 04:21:07 -07001052 RTC_DCHECK_NE(max_framerate_, -1);
Niels Möller7dc26b72017-12-06 10:27:48 +01001053 overuse_detector_->OnTargetFramerateUpdated(
1054 std::min(max_framerate_, requested_framerate));
asaperssonf7e294d2017-06-13 23:25:22 -07001055 GetAdaptCounter().IncrementFramerate(reason);
sprangc5d62e22017-04-02 23:53:04 -07001056 break;
sprangfda496a2017-06-15 04:21:07 -07001057 }
hbos8d609f62017-04-10 07:39:05 -07001058 case VideoSendStream::DegradationPreference::kDegradationDisabled:
sprangc5d62e22017-04-02 23:53:04 -07001059 RTC_NOTREACHED();
1060 }
1061
asaperssond0de2952017-04-21 01:47:31 -07001062 last_adaptation_request_.emplace(adaptation_request);
1063
asapersson09f05612017-05-15 23:40:18 -07001064 UpdateAdaptationStats(reason);
asaperssond0de2952017-04-21 01:47:31 -07001065
Mirko Bonadei675513b2017-11-09 11:09:25 +01001066 RTC_LOG(LS_INFO) << GetConstAdaptCounter().ToString();
perkj26091b12016-09-01 01:17:40 -07001067}
1068
mflodmancc3d4422017-08-03 08:27:51 -07001069void VideoStreamEncoder::AdaptUp(AdaptReason reason) {
perkjd52063f2016-09-07 06:32:18 -07001070 RTC_DCHECK_RUN_ON(&encoder_queue_);
asapersson09f05612017-05-15 23:40:18 -07001071
1072 const AdaptCounter& adapt_counter = GetConstAdaptCounter();
1073 int num_downgrades = adapt_counter.TotalCount(reason);
1074 if (num_downgrades == 0)
perkj803d97f2016-11-01 11:45:46 -07001075 return;
asapersson09f05612017-05-15 23:40:18 -07001076 RTC_DCHECK_GT(num_downgrades, 0);
1077
sprangc5d62e22017-04-02 23:53:04 -07001078 AdaptationRequest adaptation_request = {
1079 last_frame_info_->pixel_count(),
1080 stats_proxy_->GetStats().input_frame_rate,
1081 AdaptationRequest::Mode::kAdaptUp};
1082
1083 bool adapt_up_requested =
1084 last_adaptation_request_ &&
1085 last_adaptation_request_->mode_ == AdaptationRequest::Mode::kAdaptUp;
asapersson09f05612017-05-15 23:40:18 -07001086
asaperssonf7e294d2017-06-13 23:25:22 -07001087 if (degradation_preference_ ==
1088 VideoSendStream::DegradationPreference::kMaintainFramerate) {
1089 if (adapt_up_requested &&
1090 adaptation_request.input_pixel_count_ <=
1091 last_adaptation_request_->input_pixel_count_) {
1092 // Don't request higher resolution if the current resolution is not
1093 // higher than the last time we asked for the resolution to be higher.
sprangc5d62e22017-04-02 23:53:04 -07001094 return;
asaperssonf7e294d2017-06-13 23:25:22 -07001095 }
sprangb1ca0732017-02-01 08:38:12 -08001096 }
sprangc5d62e22017-04-02 23:53:04 -07001097
sprangc5d62e22017-04-02 23:53:04 -07001098 switch (degradation_preference_) {
asaperssonf7e294d2017-06-13 23:25:22 -07001099 case VideoSendStream::DegradationPreference::kBalanced: {
1100 // Try scale up framerate, if higher.
1101 int fps = MaxFps(last_frame_info_->pixel_count());
1102 if (source_proxy_->IncreaseFramerate(fps)) {
1103 GetAdaptCounter().DecrementFramerate(reason, fps);
1104 // Reset framerate in case of fewer fps steps down than up.
1105 if (adapt_counter.FramerateCount() == 0 &&
1106 fps != std::numeric_limits<int>::max()) {
Mirko Bonadei675513b2017-11-09 11:09:25 +01001107 RTC_LOG(LS_INFO) << "Removing framerate down-scaling setting.";
asaperssonf7e294d2017-06-13 23:25:22 -07001108 source_proxy_->IncreaseFramerate(std::numeric_limits<int>::max());
1109 }
1110 break;
1111 }
1112 // Scale up resolution.
Karl Wiberg80ba3332018-02-05 10:33:35 +01001113 RTC_FALLTHROUGH();
asaperssonf7e294d2017-06-13 23:25:22 -07001114 }
asapersson13874762017-06-07 00:01:02 -07001115 case VideoSendStream::DegradationPreference::kMaintainFramerate: {
1116 // Scale up resolution.
1117 int pixel_count = adaptation_request.input_pixel_count_;
1118 if (adapt_counter.ResolutionCount() == 1) {
Mirko Bonadei675513b2017-11-09 11:09:25 +01001119 RTC_LOG(LS_INFO) << "Removing resolution down-scaling setting.";
asapersson13874762017-06-07 00:01:02 -07001120 pixel_count = std::numeric_limits<int>::max();
sprangc5d62e22017-04-02 23:53:04 -07001121 }
asapersson13874762017-06-07 00:01:02 -07001122 if (!source_proxy_->RequestHigherResolutionThan(pixel_count))
1123 return;
asaperssonf7e294d2017-06-13 23:25:22 -07001124 GetAdaptCounter().DecrementResolution(reason);
sprangc5d62e22017-04-02 23:53:04 -07001125 break;
asapersson13874762017-06-07 00:01:02 -07001126 }
1127 case VideoSendStream::DegradationPreference::kMaintainResolution: {
1128 // Scale up framerate.
1129 int fps = adaptation_request.framerate_fps_;
1130 if (adapt_counter.FramerateCount() == 1) {
Mirko Bonadei675513b2017-11-09 11:09:25 +01001131 RTC_LOG(LS_INFO) << "Removing framerate down-scaling setting.";
asapersson13874762017-06-07 00:01:02 -07001132 fps = std::numeric_limits<int>::max();
sprangc5d62e22017-04-02 23:53:04 -07001133 }
sprangfda496a2017-06-15 04:21:07 -07001134
1135 const int requested_framerate =
1136 source_proxy_->RequestHigherFramerateThan(fps);
1137 if (requested_framerate == -1) {
Niels Möller7dc26b72017-12-06 10:27:48 +01001138 overuse_detector_->OnTargetFramerateUpdated(max_framerate_);
asapersson13874762017-06-07 00:01:02 -07001139 return;
sprangfda496a2017-06-15 04:21:07 -07001140 }
Niels Möller7dc26b72017-12-06 10:27:48 +01001141 overuse_detector_->OnTargetFramerateUpdated(
1142 std::min(max_framerate_, requested_framerate));
asaperssonf7e294d2017-06-13 23:25:22 -07001143 GetAdaptCounter().DecrementFramerate(reason);
sprangc5d62e22017-04-02 23:53:04 -07001144 break;
asapersson13874762017-06-07 00:01:02 -07001145 }
hbos8d609f62017-04-10 07:39:05 -07001146 case VideoSendStream::DegradationPreference::kDegradationDisabled:
asaperssonf7e294d2017-06-13 23:25:22 -07001147 return;
sprangc5d62e22017-04-02 23:53:04 -07001148 }
1149
asaperssond0de2952017-04-21 01:47:31 -07001150 last_adaptation_request_.emplace(adaptation_request);
1151
asapersson09f05612017-05-15 23:40:18 -07001152 UpdateAdaptationStats(reason);
1153
Mirko Bonadei675513b2017-11-09 11:09:25 +01001154 RTC_LOG(LS_INFO) << adapt_counter.ToString();
asapersson09f05612017-05-15 23:40:18 -07001155}
1156
mflodmancc3d4422017-08-03 08:27:51 -07001157void VideoStreamEncoder::UpdateAdaptationStats(AdaptReason reason) {
asaperssond0de2952017-04-21 01:47:31 -07001158 switch (reason) {
asaperssond0de2952017-04-21 01:47:31 -07001159 case kCpu:
asapersson09f05612017-05-15 23:40:18 -07001160 stats_proxy_->OnCpuAdaptationChanged(GetActiveCounts(kCpu),
1161 GetActiveCounts(kQuality));
1162 break;
1163 case kQuality:
1164 stats_proxy_->OnQualityAdaptationChanged(GetActiveCounts(kCpu),
1165 GetActiveCounts(kQuality));
asaperssond0de2952017-04-21 01:47:31 -07001166 break;
1167 }
perkj26091b12016-09-01 01:17:40 -07001168}
1169
mflodmancc3d4422017-08-03 08:27:51 -07001170VideoStreamEncoder::AdaptCounts VideoStreamEncoder::GetActiveCounts(
1171 AdaptReason reason) {
1172 VideoStreamEncoder::AdaptCounts counts =
1173 GetConstAdaptCounter().Counts(reason);
asapersson09f05612017-05-15 23:40:18 -07001174 switch (reason) {
1175 case kCpu:
1176 if (!IsFramerateScalingEnabled(degradation_preference_))
1177 counts.fps = -1;
1178 if (!IsResolutionScalingEnabled(degradation_preference_))
1179 counts.resolution = -1;
1180 break;
1181 case kQuality:
1182 if (!IsFramerateScalingEnabled(degradation_preference_) ||
1183 !quality_scaler_) {
1184 counts.fps = -1;
1185 }
1186 if (!IsResolutionScalingEnabled(degradation_preference_) ||
1187 !quality_scaler_) {
1188 counts.resolution = -1;
1189 }
1190 break;
sprangc5d62e22017-04-02 23:53:04 -07001191 }
asapersson09f05612017-05-15 23:40:18 -07001192 return counts;
sprangc5d62e22017-04-02 23:53:04 -07001193}
1194
mflodmancc3d4422017-08-03 08:27:51 -07001195VideoStreamEncoder::AdaptCounter& VideoStreamEncoder::GetAdaptCounter() {
asapersson09f05612017-05-15 23:40:18 -07001196 return adapt_counters_[degradation_preference_];
1197}
1198
mflodmancc3d4422017-08-03 08:27:51 -07001199const VideoStreamEncoder::AdaptCounter&
1200VideoStreamEncoder::GetConstAdaptCounter() {
asapersson09f05612017-05-15 23:40:18 -07001201 return adapt_counters_[degradation_preference_];
1202}
1203
1204// Class holding adaptation information.
mflodmancc3d4422017-08-03 08:27:51 -07001205VideoStreamEncoder::AdaptCounter::AdaptCounter() {
asapersson09f05612017-05-15 23:40:18 -07001206 fps_counters_.resize(kScaleReasonSize);
1207 resolution_counters_.resize(kScaleReasonSize);
asaperssonf7e294d2017-06-13 23:25:22 -07001208 static_assert(kScaleReasonSize == 2, "Update MoveCount.");
asapersson09f05612017-05-15 23:40:18 -07001209}
1210
mflodmancc3d4422017-08-03 08:27:51 -07001211VideoStreamEncoder::AdaptCounter::~AdaptCounter() {}
asapersson09f05612017-05-15 23:40:18 -07001212
mflodmancc3d4422017-08-03 08:27:51 -07001213std::string VideoStreamEncoder::AdaptCounter::ToString() const {
asapersson09f05612017-05-15 23:40:18 -07001214 std::stringstream ss;
1215 ss << "Downgrade counts: fps: {" << ToString(fps_counters_);
1216 ss << "}, resolution: {" << ToString(resolution_counters_) << "}";
1217 return ss.str();
1218}
1219
mflodmancc3d4422017-08-03 08:27:51 -07001220VideoStreamEncoder::AdaptCounts VideoStreamEncoder::AdaptCounter::Counts(
1221 int reason) const {
asapersson09f05612017-05-15 23:40:18 -07001222 AdaptCounts counts;
1223 counts.fps = fps_counters_[reason];
1224 counts.resolution = resolution_counters_[reason];
1225 return counts;
1226}
1227
mflodmancc3d4422017-08-03 08:27:51 -07001228void VideoStreamEncoder::AdaptCounter::IncrementFramerate(int reason) {
asaperssonf7e294d2017-06-13 23:25:22 -07001229 ++(fps_counters_[reason]);
asapersson09f05612017-05-15 23:40:18 -07001230}
1231
mflodmancc3d4422017-08-03 08:27:51 -07001232void VideoStreamEncoder::AdaptCounter::IncrementResolution(int reason) {
asaperssonf7e294d2017-06-13 23:25:22 -07001233 ++(resolution_counters_[reason]);
1234}
1235
mflodmancc3d4422017-08-03 08:27:51 -07001236void VideoStreamEncoder::AdaptCounter::DecrementFramerate(int reason) {
asaperssonf7e294d2017-06-13 23:25:22 -07001237 if (fps_counters_[reason] == 0) {
1238 // Balanced mode: Adapt up is in a different order, switch reason.
1239 // E.g. framerate adapt down: quality (2), framerate adapt up: cpu (3).
1240 // 1. Down resolution (cpu): res={quality:0,cpu:1}, fps={quality:0,cpu:0}
1241 // 2. Down fps (quality): res={quality:0,cpu:1}, fps={quality:1,cpu:0}
1242 // 3. Up fps (cpu): res={quality:1,cpu:0}, fps={quality:0,cpu:0}
1243 // 4. Up resolution (quality): res={quality:0,cpu:0}, fps={quality:0,cpu:0}
1244 RTC_DCHECK_GT(TotalCount(reason), 0) << "No downgrade for reason.";
1245 RTC_DCHECK_GT(FramerateCount(), 0) << "Framerate not downgraded.";
1246 MoveCount(&resolution_counters_, reason);
1247 MoveCount(&fps_counters_, (reason + 1) % kScaleReasonSize);
1248 }
1249 --(fps_counters_[reason]);
1250 RTC_DCHECK_GE(fps_counters_[reason], 0);
1251}
1252
mflodmancc3d4422017-08-03 08:27:51 -07001253void VideoStreamEncoder::AdaptCounter::DecrementResolution(int reason) {
asaperssonf7e294d2017-06-13 23:25:22 -07001254 if (resolution_counters_[reason] == 0) {
1255 // Balanced mode: Adapt up is in a different order, switch reason.
1256 RTC_DCHECK_GT(TotalCount(reason), 0) << "No downgrade for reason.";
1257 RTC_DCHECK_GT(ResolutionCount(), 0) << "Resolution not downgraded.";
1258 MoveCount(&fps_counters_, reason);
1259 MoveCount(&resolution_counters_, (reason + 1) % kScaleReasonSize);
1260 }
1261 --(resolution_counters_[reason]);
1262 RTC_DCHECK_GE(resolution_counters_[reason], 0);
1263}
1264
mflodmancc3d4422017-08-03 08:27:51 -07001265void VideoStreamEncoder::AdaptCounter::DecrementFramerate(int reason,
1266 int cur_fps) {
asaperssonf7e294d2017-06-13 23:25:22 -07001267 DecrementFramerate(reason);
1268 // Reset if at max fps (i.e. in case of fewer steps up than down).
1269 if (cur_fps == std::numeric_limits<int>::max())
1270 std::fill(fps_counters_.begin(), fps_counters_.end(), 0);
asapersson09f05612017-05-15 23:40:18 -07001271}
1272
mflodmancc3d4422017-08-03 08:27:51 -07001273int VideoStreamEncoder::AdaptCounter::FramerateCount() const {
asapersson09f05612017-05-15 23:40:18 -07001274 return Count(fps_counters_);
1275}
1276
mflodmancc3d4422017-08-03 08:27:51 -07001277int VideoStreamEncoder::AdaptCounter::ResolutionCount() const {
asapersson09f05612017-05-15 23:40:18 -07001278 return Count(resolution_counters_);
1279}
1280
mflodmancc3d4422017-08-03 08:27:51 -07001281int VideoStreamEncoder::AdaptCounter::FramerateCount(int reason) const {
asapersson09f05612017-05-15 23:40:18 -07001282 return fps_counters_[reason];
1283}
1284
mflodmancc3d4422017-08-03 08:27:51 -07001285int VideoStreamEncoder::AdaptCounter::ResolutionCount(int reason) const {
asapersson09f05612017-05-15 23:40:18 -07001286 return resolution_counters_[reason];
1287}
1288
mflodmancc3d4422017-08-03 08:27:51 -07001289int VideoStreamEncoder::AdaptCounter::TotalCount(int reason) const {
asapersson09f05612017-05-15 23:40:18 -07001290 return FramerateCount(reason) + ResolutionCount(reason);
1291}
1292
mflodmancc3d4422017-08-03 08:27:51 -07001293int VideoStreamEncoder::AdaptCounter::Count(
1294 const std::vector<int>& counters) const {
asapersson09f05612017-05-15 23:40:18 -07001295 return std::accumulate(counters.begin(), counters.end(), 0);
1296}
1297
mflodmancc3d4422017-08-03 08:27:51 -07001298void VideoStreamEncoder::AdaptCounter::MoveCount(std::vector<int>* counters,
1299 int from_reason) {
asaperssonf7e294d2017-06-13 23:25:22 -07001300 int to_reason = (from_reason + 1) % kScaleReasonSize;
1301 ++((*counters)[to_reason]);
1302 --((*counters)[from_reason]);
1303}
1304
mflodmancc3d4422017-08-03 08:27:51 -07001305std::string VideoStreamEncoder::AdaptCounter::ToString(
asapersson09f05612017-05-15 23:40:18 -07001306 const std::vector<int>& counters) const {
1307 std::stringstream ss;
1308 for (size_t reason = 0; reason < kScaleReasonSize; ++reason) {
1309 ss << (reason ? " cpu" : "quality") << ":" << counters[reason];
sprangc5d62e22017-04-02 23:53:04 -07001310 }
asapersson09f05612017-05-15 23:40:18 -07001311 return ss.str();
sprangc5d62e22017-04-02 23:53:04 -07001312}
1313
mflodman@webrtc.org84d17832011-12-01 17:02:23 +00001314} // namespace webrtc