Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(115)

Side by Side Diff: webrtc/video/vie_encoder.cc

Issue 2995433002: Rename ViEEncoder to VideoStreamEncoder. (Closed)
Patch Set: Created 3 years, 4 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
« no previous file with comments | « webrtc/video/vie_encoder.h ('k') | webrtc/video/vie_encoder_unittest.cc » ('j') | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
(Empty)
1 /*
2 * Copyright (c) 2012 The WebRTC project authors. All Rights Reserved.
3 *
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
11 #include "webrtc/video/vie_encoder.h"
12
13 #include <algorithm>
14 #include <limits>
15 #include <numeric>
16 #include <utility>
17
18 #include "webrtc/api/video/i420_buffer.h"
19 #include "webrtc/common_video/include/video_bitrate_allocator.h"
20 #include "webrtc/common_video/include/video_frame.h"
21 #include "webrtc/modules/pacing/paced_sender.h"
22 #include "webrtc/modules/video_coding/codecs/vp8/temporal_layers.h"
23 #include "webrtc/modules/video_coding/include/video_codec_initializer.h"
24 #include "webrtc/modules/video_coding/include/video_coding.h"
25 #include "webrtc/modules/video_coding/include/video_coding_defines.h"
26 #include "webrtc/rtc_base/arraysize.h"
27 #include "webrtc/rtc_base/checks.h"
28 #include "webrtc/rtc_base/location.h"
29 #include "webrtc/rtc_base/logging.h"
30 #include "webrtc/rtc_base/timeutils.h"
31 #include "webrtc/rtc_base/trace_event.h"
32 #include "webrtc/video/overuse_frame_detector.h"
33 #include "webrtc/video/send_statistics_proxy.h"
34
35 namespace webrtc {
36
37 namespace {
38
39 // Time interval for logging frame counts.
40 const int64_t kFrameLogIntervalMs = 60000;
41
42 // We will never ask for a resolution lower than this.
43 // TODO(kthelgason): Lower this limit when better testing
44 // on MediaCodec and fallback implementations are in place.
45 // See https://bugs.chromium.org/p/webrtc/issues/detail?id=7206
46 const int kMinPixelsPerFrame = 320 * 180;
47 const int kMinFramerateFps = 2;
48 const int kMaxFramerateFps = 120;
49
50 // The maximum number of frames to drop at beginning of stream
51 // to try and achieve desired bitrate.
52 const int kMaxInitialFramedrop = 4;
53
54 uint32_t MaximumFrameSizeForBitrate(uint32_t kbps) {
55 if (kbps > 0) {
56 if (kbps < 300 /* qvga */) {
57 return 320 * 240;
58 } else if (kbps < 500 /* vga */) {
59 return 640 * 480;
60 }
61 }
62 return std::numeric_limits<uint32_t>::max();
63 }
64
65 // Initial limits for kBalanced degradation preference.
66 int MinFps(int pixels) {
67 if (pixels <= 320 * 240) {
68 return 7;
69 } else if (pixels <= 480 * 270) {
70 return 10;
71 } else if (pixels <= 640 * 480) {
72 return 15;
73 } else {
74 return std::numeric_limits<int>::max();
75 }
76 }
77
78 int MaxFps(int pixels) {
79 if (pixels <= 320 * 240) {
80 return 10;
81 } else if (pixels <= 480 * 270) {
82 return 15;
83 } else {
84 return std::numeric_limits<int>::max();
85 }
86 }
87
88 bool IsResolutionScalingEnabled(
89 VideoSendStream::DegradationPreference degradation_preference) {
90 return degradation_preference ==
91 VideoSendStream::DegradationPreference::kMaintainFramerate ||
92 degradation_preference ==
93 VideoSendStream::DegradationPreference::kBalanced;
94 }
95
96 bool IsFramerateScalingEnabled(
97 VideoSendStream::DegradationPreference degradation_preference) {
98 return degradation_preference ==
99 VideoSendStream::DegradationPreference::kMaintainResolution ||
100 degradation_preference ==
101 VideoSendStream::DegradationPreference::kBalanced;
102 }
103
104 } // namespace
105
106 class ViEEncoder::ConfigureEncoderTask : public rtc::QueuedTask {
107 public:
108 ConfigureEncoderTask(ViEEncoder* vie_encoder,
109 VideoEncoderConfig config,
110 size_t max_data_payload_length,
111 bool nack_enabled)
112 : vie_encoder_(vie_encoder),
113 config_(std::move(config)),
114 max_data_payload_length_(max_data_payload_length),
115 nack_enabled_(nack_enabled) {}
116
117 private:
118 bool Run() override {
119 vie_encoder_->ConfigureEncoderOnTaskQueue(
120 std::move(config_), max_data_payload_length_, nack_enabled_);
121 return true;
122 }
123
124 ViEEncoder* const vie_encoder_;
125 VideoEncoderConfig config_;
126 size_t max_data_payload_length_;
127 bool nack_enabled_;
128 };
129
130 class ViEEncoder::EncodeTask : public rtc::QueuedTask {
131 public:
132 EncodeTask(const VideoFrame& frame,
133 ViEEncoder* vie_encoder,
134 int64_t time_when_posted_us,
135 bool log_stats)
136 : frame_(frame),
137 vie_encoder_(vie_encoder),
138 time_when_posted_us_(time_when_posted_us),
139 log_stats_(log_stats) {
140 ++vie_encoder_->posted_frames_waiting_for_encode_;
141 }
142
143 private:
144 bool Run() override {
145 RTC_DCHECK_RUN_ON(&vie_encoder_->encoder_queue_);
146 RTC_DCHECK_GT(vie_encoder_->posted_frames_waiting_for_encode_.Value(), 0);
147 vie_encoder_->stats_proxy_->OnIncomingFrame(frame_.width(),
148 frame_.height());
149 ++vie_encoder_->captured_frame_count_;
150 if (--vie_encoder_->posted_frames_waiting_for_encode_ == 0) {
151 vie_encoder_->EncodeVideoFrame(frame_, time_when_posted_us_);
152 } else {
153 // There is a newer frame in flight. Do not encode this frame.
154 LOG(LS_VERBOSE)
155 << "Incoming frame dropped due to that the encoder is blocked.";
156 ++vie_encoder_->dropped_frame_count_;
157 }
158 if (log_stats_) {
159 LOG(LS_INFO) << "Number of frames: captured "
160 << vie_encoder_->captured_frame_count_
161 << ", dropped (due to encoder blocked) "
162 << vie_encoder_->dropped_frame_count_ << ", interval_ms "
163 << kFrameLogIntervalMs;
164 vie_encoder_->captured_frame_count_ = 0;
165 vie_encoder_->dropped_frame_count_ = 0;
166 }
167 return true;
168 }
169 VideoFrame frame_;
170 ViEEncoder* const vie_encoder_;
171 const int64_t time_when_posted_us_;
172 const bool log_stats_;
173 };
174
175 // VideoSourceProxy is responsible ensuring thread safety between calls to
176 // ViEEncoder::SetSource that will happen on libjingle's worker thread when a
177 // video capturer is connected to the encoder and the encoder task queue
178 // (encoder_queue_) where the encoder reports its VideoSinkWants.
179 class ViEEncoder::VideoSourceProxy {
180 public:
181 explicit VideoSourceProxy(ViEEncoder* vie_encoder)
182 : vie_encoder_(vie_encoder),
183 degradation_preference_(
184 VideoSendStream::DegradationPreference::kDegradationDisabled),
185 source_(nullptr) {}
186
187 void SetSource(
188 rtc::VideoSourceInterface<VideoFrame>* source,
189 const VideoSendStream::DegradationPreference& degradation_preference) {
190 // Called on libjingle's worker thread.
191 RTC_DCHECK_CALLED_SEQUENTIALLY(&main_checker_);
192 rtc::VideoSourceInterface<VideoFrame>* old_source = nullptr;
193 rtc::VideoSinkWants wants;
194 {
195 rtc::CritScope lock(&crit_);
196 degradation_preference_ = degradation_preference;
197 old_source = source_;
198 source_ = source;
199 wants = GetActiveSinkWantsInternal();
200 }
201
202 if (old_source != source && old_source != nullptr) {
203 old_source->RemoveSink(vie_encoder_);
204 }
205
206 if (!source) {
207 return;
208 }
209
210 source->AddOrUpdateSink(vie_encoder_, wants);
211 }
212
213 void SetWantsRotationApplied(bool rotation_applied) {
214 rtc::CritScope lock(&crit_);
215 sink_wants_.rotation_applied = rotation_applied;
216 if (source_)
217 source_->AddOrUpdateSink(vie_encoder_, sink_wants_);
218 }
219
220 rtc::VideoSinkWants GetActiveSinkWants() {
221 rtc::CritScope lock(&crit_);
222 return GetActiveSinkWantsInternal();
223 }
224
225 void ResetPixelFpsCount() {
226 rtc::CritScope lock(&crit_);
227 sink_wants_.max_pixel_count = std::numeric_limits<int>::max();
228 sink_wants_.target_pixel_count.reset();
229 sink_wants_.max_framerate_fps = std::numeric_limits<int>::max();
230 if (source_)
231 source_->AddOrUpdateSink(vie_encoder_, sink_wants_);
232 }
233
234 bool RequestResolutionLowerThan(int pixel_count) {
235 // Called on the encoder task queue.
236 rtc::CritScope lock(&crit_);
237 if (!source_ || !IsResolutionScalingEnabled(degradation_preference_)) {
238 // This can happen since |degradation_preference_| is set on libjingle's
239 // worker thread but the adaptation is done on the encoder task queue.
240 return false;
241 }
242 // The input video frame size will have a resolution less than or equal to
243 // |max_pixel_count| depending on how the source can scale the frame size.
244 const int pixels_wanted = (pixel_count * 3) / 5;
245 if (pixels_wanted < kMinPixelsPerFrame ||
246 pixels_wanted >= sink_wants_.max_pixel_count) {
247 return false;
248 }
249 LOG(LS_INFO) << "Scaling down resolution, max pixels: " << pixels_wanted;
250 sink_wants_.max_pixel_count = pixels_wanted;
251 sink_wants_.target_pixel_count = rtc::Optional<int>();
252 source_->AddOrUpdateSink(vie_encoder_, GetActiveSinkWantsInternal());
253 return true;
254 }
255
256 int RequestFramerateLowerThan(int fps) {
257 // Called on the encoder task queue.
258 // The input video frame rate will be scaled down to 2/3, rounding down.
259 int framerate_wanted = (fps * 2) / 3;
260 return RestrictFramerate(framerate_wanted) ? framerate_wanted : -1;
261 }
262
263 bool RequestHigherResolutionThan(int pixel_count) {
264 // Called on the encoder task queue.
265 rtc::CritScope lock(&crit_);
266 if (!source_ || !IsResolutionScalingEnabled(degradation_preference_)) {
267 // This can happen since |degradation_preference_| is set on libjingle's
268 // worker thread but the adaptation is done on the encoder task queue.
269 return false;
270 }
271 int max_pixels_wanted = pixel_count;
272 if (max_pixels_wanted != std::numeric_limits<int>::max())
273 max_pixels_wanted = pixel_count * 4;
274
275 if (max_pixels_wanted <= sink_wants_.max_pixel_count)
276 return false;
277
278 sink_wants_.max_pixel_count = max_pixels_wanted;
279 if (max_pixels_wanted == std::numeric_limits<int>::max()) {
280 // Remove any constraints.
281 sink_wants_.target_pixel_count.reset();
282 } else {
283 // On step down we request at most 3/5 the pixel count of the previous
284 // resolution, so in order to take "one step up" we request a resolution
285 // as close as possible to 5/3 of the current resolution. The actual pixel
286 // count selected depends on the capabilities of the source. In order to
287 // not take a too large step up, we cap the requested pixel count to be at
288 // most four time the current number of pixels.
289 sink_wants_.target_pixel_count =
290 rtc::Optional<int>((pixel_count * 5) / 3);
291 }
292 LOG(LS_INFO) << "Scaling up resolution, max pixels: " << max_pixels_wanted;
293 source_->AddOrUpdateSink(vie_encoder_, GetActiveSinkWantsInternal());
294 return true;
295 }
296
297 // Request upgrade in framerate. Returns the new requested frame, or -1 if
298 // no change requested. Note that maxint may be returned if limits due to
299 // adaptation requests are removed completely. In that case, consider
300 // |max_framerate_| to be the current limit (assuming the capturer complies).
301 int RequestHigherFramerateThan(int fps) {
302 // Called on the encoder task queue.
303 // The input frame rate will be scaled up to the last step, with rounding.
304 int framerate_wanted = fps;
305 if (fps != std::numeric_limits<int>::max())
306 framerate_wanted = (fps * 3) / 2;
307
308 return IncreaseFramerate(framerate_wanted) ? framerate_wanted : -1;
309 }
310
311 bool RestrictFramerate(int fps) {
312 // Called on the encoder task queue.
313 rtc::CritScope lock(&crit_);
314 if (!source_ || !IsFramerateScalingEnabled(degradation_preference_))
315 return false;
316
317 const int fps_wanted = std::max(kMinFramerateFps, fps);
318 if (fps_wanted >= sink_wants_.max_framerate_fps)
319 return false;
320
321 LOG(LS_INFO) << "Scaling down framerate: " << fps_wanted;
322 sink_wants_.max_framerate_fps = fps_wanted;
323 source_->AddOrUpdateSink(vie_encoder_, GetActiveSinkWantsInternal());
324 return true;
325 }
326
327 bool IncreaseFramerate(int fps) {
328 // Called on the encoder task queue.
329 rtc::CritScope lock(&crit_);
330 if (!source_ || !IsFramerateScalingEnabled(degradation_preference_))
331 return false;
332
333 const int fps_wanted = std::max(kMinFramerateFps, fps);
334 if (fps_wanted <= sink_wants_.max_framerate_fps)
335 return false;
336
337 LOG(LS_INFO) << "Scaling up framerate: " << fps_wanted;
338 sink_wants_.max_framerate_fps = fps_wanted;
339 source_->AddOrUpdateSink(vie_encoder_, GetActiveSinkWantsInternal());
340 return true;
341 }
342
343 private:
344 rtc::VideoSinkWants GetActiveSinkWantsInternal()
345 EXCLUSIVE_LOCKS_REQUIRED(&crit_) {
346 rtc::VideoSinkWants wants = sink_wants_;
347 // Clear any constraints from the current sink wants that don't apply to
348 // the used degradation_preference.
349 switch (degradation_preference_) {
350 case VideoSendStream::DegradationPreference::kBalanced:
351 break;
352 case VideoSendStream::DegradationPreference::kMaintainFramerate:
353 wants.max_framerate_fps = std::numeric_limits<int>::max();
354 break;
355 case VideoSendStream::DegradationPreference::kMaintainResolution:
356 wants.max_pixel_count = std::numeric_limits<int>::max();
357 wants.target_pixel_count.reset();
358 break;
359 case VideoSendStream::DegradationPreference::kDegradationDisabled:
360 wants.max_pixel_count = std::numeric_limits<int>::max();
361 wants.target_pixel_count.reset();
362 wants.max_framerate_fps = std::numeric_limits<int>::max();
363 }
364 return wants;
365 }
366
367 rtc::CriticalSection crit_;
368 rtc::SequencedTaskChecker main_checker_;
369 ViEEncoder* const vie_encoder_;
370 rtc::VideoSinkWants sink_wants_ GUARDED_BY(&crit_);
371 VideoSendStream::DegradationPreference degradation_preference_
372 GUARDED_BY(&crit_);
373 rtc::VideoSourceInterface<VideoFrame>* source_ GUARDED_BY(&crit_);
374
375 RTC_DISALLOW_COPY_AND_ASSIGN(VideoSourceProxy);
376 };
377
378 ViEEncoder::ViEEncoder(uint32_t number_of_cores,
379 SendStatisticsProxy* stats_proxy,
380 const VideoSendStream::Config::EncoderSettings& settings,
381 rtc::VideoSinkInterface<VideoFrame>* pre_encode_callback,
382 EncodedFrameObserver* encoder_timing,
383 std::unique_ptr<OveruseFrameDetector> overuse_detector)
384 : shutdown_event_(true /* manual_reset */, false),
385 number_of_cores_(number_of_cores),
386 initial_rampup_(0),
387 source_proxy_(new VideoSourceProxy(this)),
388 sink_(nullptr),
389 settings_(settings),
390 codec_type_(PayloadNameToCodecType(settings.payload_name)
391 .value_or(VideoCodecType::kVideoCodecUnknown)),
392 video_sender_(Clock::GetRealTimeClock(), this, this),
393 overuse_detector_(
394 overuse_detector.get()
395 ? overuse_detector.release()
396 : new OveruseFrameDetector(
397 GetCpuOveruseOptions(settings.full_overuse_time),
398 this,
399 encoder_timing,
400 stats_proxy)),
401 stats_proxy_(stats_proxy),
402 pre_encode_callback_(pre_encode_callback),
403 module_process_thread_(nullptr),
404 max_framerate_(-1),
405 pending_encoder_reconfiguration_(false),
406 encoder_start_bitrate_bps_(0),
407 max_data_payload_length_(0),
408 nack_enabled_(false),
409 last_observed_bitrate_bps_(0),
410 encoder_paused_and_dropped_frame_(false),
411 clock_(Clock::GetRealTimeClock()),
412 degradation_preference_(
413 VideoSendStream::DegradationPreference::kDegradationDisabled),
414 last_captured_timestamp_(0),
415 delta_ntp_internal_ms_(clock_->CurrentNtpInMilliseconds() -
416 clock_->TimeInMilliseconds()),
417 last_frame_log_ms_(clock_->TimeInMilliseconds()),
418 captured_frame_count_(0),
419 dropped_frame_count_(0),
420 bitrate_observer_(nullptr),
421 encoder_queue_("EncoderQueue") {
422 RTC_DCHECK(stats_proxy);
423 encoder_queue_.PostTask([this] {
424 RTC_DCHECK_RUN_ON(&encoder_queue_);
425 overuse_detector_->StartCheckForOveruse();
426 video_sender_.RegisterExternalEncoder(
427 settings_.encoder, settings_.payload_type, settings_.internal_source);
428 });
429 }
430
431 ViEEncoder::~ViEEncoder() {
432 RTC_DCHECK_RUN_ON(&thread_checker_);
433 RTC_DCHECK(shutdown_event_.Wait(0))
434 << "Must call ::Stop() before destruction.";
435 }
436
437 // TODO(pbos): Lower these thresholds (to closer to 100%) when we handle
438 // pipelining encoders better (multiple input frames before something comes
439 // out). This should effectively turn off CPU adaptations for systems that
440 // remotely cope with the load right now.
441 CpuOveruseOptions ViEEncoder::GetCpuOveruseOptions(bool full_overuse_time) {
442 CpuOveruseOptions options;
443 if (full_overuse_time) {
444 options.low_encode_usage_threshold_percent = 150;
445 options.high_encode_usage_threshold_percent = 200;
446 }
447 return options;
448 }
449
450 void ViEEncoder::Stop() {
451 RTC_DCHECK_RUN_ON(&thread_checker_);
452 source_proxy_->SetSource(nullptr, VideoSendStream::DegradationPreference());
453 encoder_queue_.PostTask([this] {
454 RTC_DCHECK_RUN_ON(&encoder_queue_);
455 overuse_detector_->StopCheckForOveruse();
456 rate_allocator_.reset();
457 bitrate_observer_ = nullptr;
458 video_sender_.RegisterExternalEncoder(nullptr, settings_.payload_type,
459 false);
460 quality_scaler_ = nullptr;
461 shutdown_event_.Set();
462 });
463
464 shutdown_event_.Wait(rtc::Event::kForever);
465 }
466
467 void ViEEncoder::RegisterProcessThread(ProcessThread* module_process_thread) {
468 RTC_DCHECK_RUN_ON(&thread_checker_);
469 RTC_DCHECK(!module_process_thread_);
470 module_process_thread_ = module_process_thread;
471 module_process_thread_->RegisterModule(&video_sender_, RTC_FROM_HERE);
472 module_process_thread_checker_.DetachFromThread();
473 }
474
475 void ViEEncoder::DeRegisterProcessThread() {
476 RTC_DCHECK_RUN_ON(&thread_checker_);
477 module_process_thread_->DeRegisterModule(&video_sender_);
478 }
479
480 void ViEEncoder::SetBitrateObserver(
481 VideoBitrateAllocationObserver* bitrate_observer) {
482 RTC_DCHECK_RUN_ON(&thread_checker_);
483 encoder_queue_.PostTask([this, bitrate_observer] {
484 RTC_DCHECK_RUN_ON(&encoder_queue_);
485 RTC_DCHECK(!bitrate_observer_);
486 bitrate_observer_ = bitrate_observer;
487 });
488 }
489
490 void ViEEncoder::SetSource(
491 rtc::VideoSourceInterface<VideoFrame>* source,
492 const VideoSendStream::DegradationPreference& degradation_preference) {
493 RTC_DCHECK_RUN_ON(&thread_checker_);
494 source_proxy_->SetSource(source, degradation_preference);
495 encoder_queue_.PostTask([this, degradation_preference] {
496 RTC_DCHECK_RUN_ON(&encoder_queue_);
497 if (degradation_preference_ != degradation_preference) {
498 // Reset adaptation state, so that we're not tricked into thinking there's
499 // an already pending request of the same type.
500 last_adaptation_request_.reset();
501 if (degradation_preference ==
502 VideoSendStream::DegradationPreference::kBalanced ||
503 degradation_preference_ ==
504 VideoSendStream::DegradationPreference::kBalanced) {
505 // TODO(asapersson): Consider removing |adapt_counters_| map and use one
506 // AdaptCounter for all modes.
507 source_proxy_->ResetPixelFpsCount();
508 adapt_counters_.clear();
509 }
510 }
511 degradation_preference_ = degradation_preference;
512 bool allow_scaling = IsResolutionScalingEnabled(degradation_preference_);
513 initial_rampup_ = allow_scaling ? 0 : kMaxInitialFramedrop;
514 ConfigureQualityScaler();
515 if (!IsFramerateScalingEnabled(degradation_preference) &&
516 max_framerate_ != -1) {
517 // If frame rate scaling is no longer allowed, remove any potential
518 // allowance for longer frame intervals.
519 overuse_detector_->OnTargetFramerateUpdated(max_framerate_);
520 }
521 });
522 }
523
524 void ViEEncoder::SetSink(EncoderSink* sink, bool rotation_applied) {
525 source_proxy_->SetWantsRotationApplied(rotation_applied);
526 encoder_queue_.PostTask([this, sink] {
527 RTC_DCHECK_RUN_ON(&encoder_queue_);
528 sink_ = sink;
529 });
530 }
531
532 void ViEEncoder::SetStartBitrate(int start_bitrate_bps) {
533 encoder_queue_.PostTask([this, start_bitrate_bps] {
534 RTC_DCHECK_RUN_ON(&encoder_queue_);
535 encoder_start_bitrate_bps_ = start_bitrate_bps;
536 });
537 }
538
539 void ViEEncoder::ConfigureEncoder(VideoEncoderConfig config,
540 size_t max_data_payload_length,
541 bool nack_enabled) {
542 encoder_queue_.PostTask(
543 std::unique_ptr<rtc::QueuedTask>(new ConfigureEncoderTask(
544 this, std::move(config), max_data_payload_length, nack_enabled)));
545 }
546
547 void ViEEncoder::ConfigureEncoderOnTaskQueue(VideoEncoderConfig config,
548 size_t max_data_payload_length,
549 bool nack_enabled) {
550 RTC_DCHECK_RUN_ON(&encoder_queue_);
551 RTC_DCHECK(sink_);
552 LOG(LS_INFO) << "ConfigureEncoder requested.";
553
554 max_data_payload_length_ = max_data_payload_length;
555 nack_enabled_ = nack_enabled;
556 encoder_config_ = std::move(config);
557 pending_encoder_reconfiguration_ = true;
558
559 // Reconfigure the encoder now if the encoder has an internal source or
560 // if the frame resolution is known. Otherwise, the reconfiguration is
561 // deferred until the next frame to minimize the number of reconfigurations.
562 // The codec configuration depends on incoming video frame size.
563 if (last_frame_info_) {
564 ReconfigureEncoder();
565 } else if (settings_.internal_source) {
566 last_frame_info_ =
567 rtc::Optional<VideoFrameInfo>(VideoFrameInfo(176, 144, false));
568 ReconfigureEncoder();
569 }
570 }
571
572 void ViEEncoder::ReconfigureEncoder() {
573 RTC_DCHECK_RUN_ON(&encoder_queue_);
574 RTC_DCHECK(pending_encoder_reconfiguration_);
575 std::vector<VideoStream> streams =
576 encoder_config_.video_stream_factory->CreateEncoderStreams(
577 last_frame_info_->width, last_frame_info_->height, encoder_config_);
578
579 // TODO(ilnik): If configured resolution is significantly less than provided,
580 // e.g. because there are not enough SSRCs for all simulcast streams,
581 // signal new resolutions via SinkWants to video source.
582
583 // Stream dimensions may be not equal to given because of a simulcast
584 // restrictions.
585 int highest_stream_width = static_cast<int>(streams.back().width);
586 int highest_stream_height = static_cast<int>(streams.back().height);
587 // Dimension may be reduced to be, e.g. divisible by 4.
588 RTC_CHECK_GE(last_frame_info_->width, highest_stream_width);
589 RTC_CHECK_GE(last_frame_info_->height, highest_stream_height);
590 crop_width_ = last_frame_info_->width - highest_stream_width;
591 crop_height_ = last_frame_info_->height - highest_stream_height;
592
593 VideoCodec codec;
594 if (!VideoCodecInitializer::SetupCodec(encoder_config_, settings_, streams,
595 nack_enabled_, &codec,
596 &rate_allocator_)) {
597 LOG(LS_ERROR) << "Failed to create encoder configuration.";
598 }
599
600 codec.startBitrate =
601 std::max(encoder_start_bitrate_bps_ / 1000, codec.minBitrate);
602 codec.startBitrate = std::min(codec.startBitrate, codec.maxBitrate);
603 codec.expect_encode_from_texture = last_frame_info_->is_texture;
604 max_framerate_ = codec.maxFramerate;
605 RTC_DCHECK_LE(max_framerate_, kMaxFramerateFps);
606
607 bool success = video_sender_.RegisterSendCodec(
608 &codec, number_of_cores_,
609 static_cast<uint32_t>(max_data_payload_length_)) == VCM_OK;
610 if (!success) {
611 LOG(LS_ERROR) << "Failed to configure encoder.";
612 rate_allocator_.reset();
613 }
614
615 video_sender_.UpdateChannelParemeters(rate_allocator_.get(),
616 bitrate_observer_);
617
618 // Get the current actual framerate, as measured by the stats proxy. This is
619 // used to get the correct bitrate layer allocation.
620 int current_framerate = stats_proxy_->GetSendFrameRate();
621 if (current_framerate == 0)
622 current_framerate = codec.maxFramerate;
623 stats_proxy_->OnEncoderReconfigured(
624 encoder_config_,
625 rate_allocator_.get()
626 ? rate_allocator_->GetPreferredBitrateBps(current_framerate)
627 : codec.maxBitrate);
628
629 pending_encoder_reconfiguration_ = false;
630
631 sink_->OnEncoderConfigurationChanged(
632 std::move(streams), encoder_config_.min_transmit_bitrate_bps);
633
634 // Get the current target framerate, ie the maximum framerate as specified by
635 // the current codec configuration, or any limit imposed by cpu adaption in
636 // maintain-resolution or balanced mode. This is used to make sure overuse
637 // detection doesn't needlessly trigger in low and/or variable framerate
638 // scenarios.
639 int target_framerate = std::min(
640 max_framerate_, source_proxy_->GetActiveSinkWants().max_framerate_fps);
641 overuse_detector_->OnTargetFramerateUpdated(target_framerate);
642
643 ConfigureQualityScaler();
644 }
645
646 void ViEEncoder::ConfigureQualityScaler() {
647 RTC_DCHECK_RUN_ON(&encoder_queue_);
648 const auto scaling_settings = settings_.encoder->GetScalingSettings();
649 const bool quality_scaling_allowed =
650 IsResolutionScalingEnabled(degradation_preference_) &&
651 scaling_settings.enabled;
652
653 if (quality_scaling_allowed) {
654 if (quality_scaler_.get() == nullptr) {
655 // Quality scaler has not already been configured.
656 // Drop frames and scale down until desired quality is achieved.
657 if (scaling_settings.thresholds) {
658 quality_scaler_.reset(
659 new QualityScaler(this, *(scaling_settings.thresholds)));
660 } else {
661 quality_scaler_.reset(new QualityScaler(this, codec_type_));
662 }
663 }
664 } else {
665 quality_scaler_.reset(nullptr);
666 initial_rampup_ = kMaxInitialFramedrop;
667 }
668
669 stats_proxy_->SetAdaptationStats(GetActiveCounts(kCpu),
670 GetActiveCounts(kQuality));
671 }
672
673 void ViEEncoder::OnFrame(const VideoFrame& video_frame) {
674 RTC_DCHECK_RUNS_SERIALIZED(&incoming_frame_race_checker_);
675 VideoFrame incoming_frame = video_frame;
676
677 // Local time in webrtc time base.
678 int64_t current_time_us = clock_->TimeInMicroseconds();
679 int64_t current_time_ms = current_time_us / rtc::kNumMicrosecsPerMillisec;
680 // In some cases, e.g., when the frame from decoder is fed to encoder,
681 // the timestamp may be set to the future. As the encoding pipeline assumes
682 // capture time to be less than present time, we should reset the capture
683 // timestamps here. Otherwise there may be issues with RTP send stream.
684 if (incoming_frame.timestamp_us() > current_time_us)
685 incoming_frame.set_timestamp_us(current_time_us);
686
687 // Capture time may come from clock with an offset and drift from clock_.
688 int64_t capture_ntp_time_ms;
689 if (video_frame.ntp_time_ms() > 0) {
690 capture_ntp_time_ms = video_frame.ntp_time_ms();
691 } else if (video_frame.render_time_ms() != 0) {
692 capture_ntp_time_ms = video_frame.render_time_ms() + delta_ntp_internal_ms_;
693 } else {
694 capture_ntp_time_ms = current_time_ms + delta_ntp_internal_ms_;
695 }
696 incoming_frame.set_ntp_time_ms(capture_ntp_time_ms);
697
698 // Convert NTP time, in ms, to RTP timestamp.
699 const int kMsToRtpTimestamp = 90;
700 incoming_frame.set_timestamp(
701 kMsToRtpTimestamp * static_cast<uint32_t>(incoming_frame.ntp_time_ms()));
702
703 if (incoming_frame.ntp_time_ms() <= last_captured_timestamp_) {
704 // We don't allow the same capture time for two frames, drop this one.
705 LOG(LS_WARNING) << "Same/old NTP timestamp ("
706 << incoming_frame.ntp_time_ms()
707 << " <= " << last_captured_timestamp_
708 << ") for incoming frame. Dropping.";
709 return;
710 }
711
712 bool log_stats = false;
713 if (current_time_ms - last_frame_log_ms_ > kFrameLogIntervalMs) {
714 last_frame_log_ms_ = current_time_ms;
715 log_stats = true;
716 }
717
718 last_captured_timestamp_ = incoming_frame.ntp_time_ms();
719 encoder_queue_.PostTask(std::unique_ptr<rtc::QueuedTask>(new EncodeTask(
720 incoming_frame, this, rtc::TimeMicros(), log_stats)));
721 }
722
723 bool ViEEncoder::EncoderPaused() const {
724 RTC_DCHECK_RUN_ON(&encoder_queue_);
725 // Pause video if paused by caller or as long as the network is down or the
726 // pacer queue has grown too large in buffered mode.
727 // If the pacer queue has grown too large or the network is down,
728 // last_observed_bitrate_bps_ will be 0.
729 return last_observed_bitrate_bps_ == 0;
730 }
731
732 void ViEEncoder::TraceFrameDropStart() {
733 RTC_DCHECK_RUN_ON(&encoder_queue_);
734 // Start trace event only on the first frame after encoder is paused.
735 if (!encoder_paused_and_dropped_frame_) {
736 TRACE_EVENT_ASYNC_BEGIN0("webrtc", "EncoderPaused", this);
737 }
738 encoder_paused_and_dropped_frame_ = true;
739 }
740
741 void ViEEncoder::TraceFrameDropEnd() {
742 RTC_DCHECK_RUN_ON(&encoder_queue_);
743 // End trace event on first frame after encoder resumes, if frame was dropped.
744 if (encoder_paused_and_dropped_frame_) {
745 TRACE_EVENT_ASYNC_END0("webrtc", "EncoderPaused", this);
746 }
747 encoder_paused_and_dropped_frame_ = false;
748 }
749
750 void ViEEncoder::EncodeVideoFrame(const VideoFrame& video_frame,
751 int64_t time_when_posted_us) {
752 RTC_DCHECK_RUN_ON(&encoder_queue_);
753
754 if (pre_encode_callback_)
755 pre_encode_callback_->OnFrame(video_frame);
756
757 if (!last_frame_info_ || video_frame.width() != last_frame_info_->width ||
758 video_frame.height() != last_frame_info_->height ||
759 video_frame.is_texture() != last_frame_info_->is_texture) {
760 pending_encoder_reconfiguration_ = true;
761 last_frame_info_ = rtc::Optional<VideoFrameInfo>(VideoFrameInfo(
762 video_frame.width(), video_frame.height(), video_frame.is_texture()));
763 LOG(LS_INFO) << "Video frame parameters changed: dimensions="
764 << last_frame_info_->width << "x" << last_frame_info_->height
765 << ", texture=" << last_frame_info_->is_texture << ".";
766 }
767
768 if (initial_rampup_ < kMaxInitialFramedrop &&
769 video_frame.size() >
770 MaximumFrameSizeForBitrate(encoder_start_bitrate_bps_ / 1000)) {
771 LOG(LS_INFO) << "Dropping frame. Too large for target bitrate.";
772 AdaptDown(kQuality);
773 ++initial_rampup_;
774 return;
775 }
776 initial_rampup_ = kMaxInitialFramedrop;
777
778 int64_t now_ms = clock_->TimeInMilliseconds();
779 if (pending_encoder_reconfiguration_) {
780 ReconfigureEncoder();
781 last_parameters_update_ms_.emplace(now_ms);
782 } else if (!last_parameters_update_ms_ ||
783 now_ms - *last_parameters_update_ms_ >=
784 vcm::VCMProcessTimer::kDefaultProcessIntervalMs) {
785 video_sender_.UpdateChannelParemeters(rate_allocator_.get(),
786 bitrate_observer_);
787 last_parameters_update_ms_.emplace(now_ms);
788 }
789
790 if (EncoderPaused()) {
791 TraceFrameDropStart();
792 return;
793 }
794 TraceFrameDropEnd();
795
796 VideoFrame out_frame(video_frame);
797 // Crop frame if needed.
798 if (crop_width_ > 0 || crop_height_ > 0) {
799 int cropped_width = video_frame.width() - crop_width_;
800 int cropped_height = video_frame.height() - crop_height_;
801 rtc::scoped_refptr<I420Buffer> cropped_buffer =
802 I420Buffer::Create(cropped_width, cropped_height);
803 // TODO(ilnik): Remove scaling if cropping is too big, as it should never
804 // happen after SinkWants signaled correctly from ReconfigureEncoder.
805 if (crop_width_ < 4 && crop_height_ < 4) {
806 cropped_buffer->CropAndScaleFrom(
807 *video_frame.video_frame_buffer()->ToI420(), crop_width_ / 2,
808 crop_height_ / 2, cropped_width, cropped_height);
809 } else {
810 cropped_buffer->ScaleFrom(
811 *video_frame.video_frame_buffer()->ToI420().get());
812 }
813 out_frame =
814 VideoFrame(cropped_buffer, video_frame.timestamp(),
815 video_frame.render_time_ms(), video_frame.rotation());
816 out_frame.set_ntp_time_ms(video_frame.ntp_time_ms());
817 }
818
819 TRACE_EVENT_ASYNC_STEP0("webrtc", "Video", video_frame.render_time_ms(),
820 "Encode");
821
822 overuse_detector_->FrameCaptured(out_frame, time_when_posted_us);
823
824 video_sender_.AddVideoFrame(out_frame, nullptr);
825 }
826
827 void ViEEncoder::SendKeyFrame() {
828 if (!encoder_queue_.IsCurrent()) {
829 encoder_queue_.PostTask([this] { SendKeyFrame(); });
830 return;
831 }
832 RTC_DCHECK_RUN_ON(&encoder_queue_);
833 video_sender_.IntraFrameRequest(0);
834 }
835
836 EncodedImageCallback::Result ViEEncoder::OnEncodedImage(
837 const EncodedImage& encoded_image,
838 const CodecSpecificInfo* codec_specific_info,
839 const RTPFragmentationHeader* fragmentation) {
840 // Encoded is called on whatever thread the real encoder implementation run
841 // on. In the case of hardware encoders, there might be several encoders
842 // running in parallel on different threads.
843 stats_proxy_->OnSendEncodedImage(encoded_image, codec_specific_info);
844
845 EncodedImageCallback::Result result =
846 sink_->OnEncodedImage(encoded_image, codec_specific_info, fragmentation);
847
848 int64_t time_sent_us = rtc::TimeMicros();
849 uint32_t timestamp = encoded_image._timeStamp;
850 const int qp = encoded_image.qp_;
851 encoder_queue_.PostTask([this, timestamp, time_sent_us, qp] {
852 RTC_DCHECK_RUN_ON(&encoder_queue_);
853 overuse_detector_->FrameSent(timestamp, time_sent_us);
854 if (quality_scaler_ && qp >= 0)
855 quality_scaler_->ReportQP(qp);
856 });
857
858 return result;
859 }
860
861 void ViEEncoder::OnDroppedFrame() {
862 encoder_queue_.PostTask([this] {
863 RTC_DCHECK_RUN_ON(&encoder_queue_);
864 if (quality_scaler_)
865 quality_scaler_->ReportDroppedFrame();
866 });
867 }
868
869 void ViEEncoder::SendStatistics(uint32_t bit_rate, uint32_t frame_rate) {
870 RTC_DCHECK(module_process_thread_checker_.CalledOnValidThread());
871 stats_proxy_->OnEncoderStatsUpdate(frame_rate, bit_rate);
872 }
873
874 void ViEEncoder::OnReceivedIntraFrameRequest(size_t stream_index) {
875 if (!encoder_queue_.IsCurrent()) {
876 encoder_queue_.PostTask(
877 [this, stream_index] { OnReceivedIntraFrameRequest(stream_index); });
878 return;
879 }
880 RTC_DCHECK_RUN_ON(&encoder_queue_);
881 // Key frame request from remote side, signal to VCM.
882 TRACE_EVENT0("webrtc", "OnKeyFrameRequest");
883 video_sender_.IntraFrameRequest(stream_index);
884 }
885
886 void ViEEncoder::OnBitrateUpdated(uint32_t bitrate_bps,
887 uint8_t fraction_lost,
888 int64_t round_trip_time_ms) {
889 if (!encoder_queue_.IsCurrent()) {
890 encoder_queue_.PostTask(
891 [this, bitrate_bps, fraction_lost, round_trip_time_ms] {
892 OnBitrateUpdated(bitrate_bps, fraction_lost, round_trip_time_ms);
893 });
894 return;
895 }
896 RTC_DCHECK_RUN_ON(&encoder_queue_);
897 RTC_DCHECK(sink_) << "sink_ must be set before the encoder is active.";
898
899 LOG(LS_VERBOSE) << "OnBitrateUpdated, bitrate " << bitrate_bps
900 << " packet loss " << static_cast<int>(fraction_lost)
901 << " rtt " << round_trip_time_ms;
902
903 video_sender_.SetChannelParameters(bitrate_bps, fraction_lost,
904 round_trip_time_ms, rate_allocator_.get(),
905 bitrate_observer_);
906
907 encoder_start_bitrate_bps_ =
908 bitrate_bps != 0 ? bitrate_bps : encoder_start_bitrate_bps_;
909 bool video_is_suspended = bitrate_bps == 0;
910 bool video_suspension_changed = video_is_suspended != EncoderPaused();
911 last_observed_bitrate_bps_ = bitrate_bps;
912
913 if (video_suspension_changed) {
914 LOG(LS_INFO) << "Video suspend state changed to: "
915 << (video_is_suspended ? "suspended" : "not suspended");
916 stats_proxy_->OnSuspendChange(video_is_suspended);
917 }
918 }
919
920 void ViEEncoder::AdaptDown(AdaptReason reason) {
921 RTC_DCHECK_RUN_ON(&encoder_queue_);
922 AdaptationRequest adaptation_request = {
923 last_frame_info_->pixel_count(),
924 stats_proxy_->GetStats().input_frame_rate,
925 AdaptationRequest::Mode::kAdaptDown};
926
927 bool downgrade_requested =
928 last_adaptation_request_ &&
929 last_adaptation_request_->mode_ == AdaptationRequest::Mode::kAdaptDown;
930
931 switch (degradation_preference_) {
932 case VideoSendStream::DegradationPreference::kBalanced:
933 break;
934 case VideoSendStream::DegradationPreference::kMaintainFramerate:
935 if (downgrade_requested &&
936 adaptation_request.input_pixel_count_ >=
937 last_adaptation_request_->input_pixel_count_) {
938 // Don't request lower resolution if the current resolution is not
939 // lower than the last time we asked for the resolution to be lowered.
940 return;
941 }
942 break;
943 case VideoSendStream::DegradationPreference::kMaintainResolution:
944 if (adaptation_request.framerate_fps_ <= 0 ||
945 (downgrade_requested &&
946 adaptation_request.framerate_fps_ < kMinFramerateFps)) {
947 // If no input fps estimate available, can't determine how to scale down
948 // framerate. Otherwise, don't request lower framerate if we don't have
949 // a valid frame rate. Since framerate, unlike resolution, is a measure
950 // we have to estimate, and can fluctuate naturally over time, don't
951 // make the same kind of limitations as for resolution, but trust the
952 // overuse detector to not trigger too often.
953 return;
954 }
955 break;
956 case VideoSendStream::DegradationPreference::kDegradationDisabled:
957 return;
958 }
959
960 if (reason == kCpu) {
961 if (GetConstAdaptCounter().ResolutionCount(kCpu) >=
962 kMaxCpuResolutionDowngrades ||
963 GetConstAdaptCounter().FramerateCount(kCpu) >=
964 kMaxCpuFramerateDowngrades) {
965 return;
966 }
967 }
968
969 switch (degradation_preference_) {
970 case VideoSendStream::DegradationPreference::kBalanced: {
971 // Try scale down framerate, if lower.
972 int fps = MinFps(last_frame_info_->pixel_count());
973 if (source_proxy_->RestrictFramerate(fps)) {
974 GetAdaptCounter().IncrementFramerate(reason);
975 break;
976 }
977 // Scale down resolution.
978 FALLTHROUGH();
979 }
980 case VideoSendStream::DegradationPreference::kMaintainFramerate:
981 // Scale down resolution.
982 if (!source_proxy_->RequestResolutionLowerThan(
983 adaptation_request.input_pixel_count_)) {
984 return;
985 }
986 GetAdaptCounter().IncrementResolution(reason);
987 break;
988 case VideoSendStream::DegradationPreference::kMaintainResolution: {
989 // Scale down framerate.
990 const int requested_framerate = source_proxy_->RequestFramerateLowerThan(
991 adaptation_request.framerate_fps_);
992 if (requested_framerate == -1)
993 return;
994 RTC_DCHECK_NE(max_framerate_, -1);
995 overuse_detector_->OnTargetFramerateUpdated(
996 std::min(max_framerate_, requested_framerate));
997 GetAdaptCounter().IncrementFramerate(reason);
998 break;
999 }
1000 case VideoSendStream::DegradationPreference::kDegradationDisabled:
1001 RTC_NOTREACHED();
1002 }
1003
1004 last_adaptation_request_.emplace(adaptation_request);
1005
1006 UpdateAdaptationStats(reason);
1007
1008 LOG(LS_INFO) << GetConstAdaptCounter().ToString();
1009 }
1010
1011 void ViEEncoder::AdaptUp(AdaptReason reason) {
1012 RTC_DCHECK_RUN_ON(&encoder_queue_);
1013
1014 const AdaptCounter& adapt_counter = GetConstAdaptCounter();
1015 int num_downgrades = adapt_counter.TotalCount(reason);
1016 if (num_downgrades == 0)
1017 return;
1018 RTC_DCHECK_GT(num_downgrades, 0);
1019
1020 AdaptationRequest adaptation_request = {
1021 last_frame_info_->pixel_count(),
1022 stats_proxy_->GetStats().input_frame_rate,
1023 AdaptationRequest::Mode::kAdaptUp};
1024
1025 bool adapt_up_requested =
1026 last_adaptation_request_ &&
1027 last_adaptation_request_->mode_ == AdaptationRequest::Mode::kAdaptUp;
1028
1029 if (degradation_preference_ ==
1030 VideoSendStream::DegradationPreference::kMaintainFramerate) {
1031 if (adapt_up_requested &&
1032 adaptation_request.input_pixel_count_ <=
1033 last_adaptation_request_->input_pixel_count_) {
1034 // Don't request higher resolution if the current resolution is not
1035 // higher than the last time we asked for the resolution to be higher.
1036 return;
1037 }
1038 }
1039
1040 switch (degradation_preference_) {
1041 case VideoSendStream::DegradationPreference::kBalanced: {
1042 // Try scale up framerate, if higher.
1043 int fps = MaxFps(last_frame_info_->pixel_count());
1044 if (source_proxy_->IncreaseFramerate(fps)) {
1045 GetAdaptCounter().DecrementFramerate(reason, fps);
1046 // Reset framerate in case of fewer fps steps down than up.
1047 if (adapt_counter.FramerateCount() == 0 &&
1048 fps != std::numeric_limits<int>::max()) {
1049 LOG(LS_INFO) << "Removing framerate down-scaling setting.";
1050 source_proxy_->IncreaseFramerate(std::numeric_limits<int>::max());
1051 }
1052 break;
1053 }
1054 // Scale up resolution.
1055 FALLTHROUGH();
1056 }
1057 case VideoSendStream::DegradationPreference::kMaintainFramerate: {
1058 // Scale up resolution.
1059 int pixel_count = adaptation_request.input_pixel_count_;
1060 if (adapt_counter.ResolutionCount() == 1) {
1061 LOG(LS_INFO) << "Removing resolution down-scaling setting.";
1062 pixel_count = std::numeric_limits<int>::max();
1063 }
1064 if (!source_proxy_->RequestHigherResolutionThan(pixel_count))
1065 return;
1066 GetAdaptCounter().DecrementResolution(reason);
1067 break;
1068 }
1069 case VideoSendStream::DegradationPreference::kMaintainResolution: {
1070 // Scale up framerate.
1071 int fps = adaptation_request.framerate_fps_;
1072 if (adapt_counter.FramerateCount() == 1) {
1073 LOG(LS_INFO) << "Removing framerate down-scaling setting.";
1074 fps = std::numeric_limits<int>::max();
1075 }
1076
1077 const int requested_framerate =
1078 source_proxy_->RequestHigherFramerateThan(fps);
1079 if (requested_framerate == -1) {
1080 overuse_detector_->OnTargetFramerateUpdated(max_framerate_);
1081 return;
1082 }
1083 overuse_detector_->OnTargetFramerateUpdated(
1084 std::min(max_framerate_, requested_framerate));
1085 GetAdaptCounter().DecrementFramerate(reason);
1086 break;
1087 }
1088 case VideoSendStream::DegradationPreference::kDegradationDisabled:
1089 return;
1090 }
1091
1092 last_adaptation_request_.emplace(adaptation_request);
1093
1094 UpdateAdaptationStats(reason);
1095
1096 LOG(LS_INFO) << adapt_counter.ToString();
1097 }
1098
1099 void ViEEncoder::UpdateAdaptationStats(AdaptReason reason) {
1100 switch (reason) {
1101 case kCpu:
1102 stats_proxy_->OnCpuAdaptationChanged(GetActiveCounts(kCpu),
1103 GetActiveCounts(kQuality));
1104 break;
1105 case kQuality:
1106 stats_proxy_->OnQualityAdaptationChanged(GetActiveCounts(kCpu),
1107 GetActiveCounts(kQuality));
1108 break;
1109 }
1110 }
1111
1112 ViEEncoder::AdaptCounts ViEEncoder::GetActiveCounts(AdaptReason reason) {
1113 ViEEncoder::AdaptCounts counts = GetConstAdaptCounter().Counts(reason);
1114 switch (reason) {
1115 case kCpu:
1116 if (!IsFramerateScalingEnabled(degradation_preference_))
1117 counts.fps = -1;
1118 if (!IsResolutionScalingEnabled(degradation_preference_))
1119 counts.resolution = -1;
1120 break;
1121 case kQuality:
1122 if (!IsFramerateScalingEnabled(degradation_preference_) ||
1123 !quality_scaler_) {
1124 counts.fps = -1;
1125 }
1126 if (!IsResolutionScalingEnabled(degradation_preference_) ||
1127 !quality_scaler_) {
1128 counts.resolution = -1;
1129 }
1130 break;
1131 }
1132 return counts;
1133 }
1134
1135 ViEEncoder::AdaptCounter& ViEEncoder::GetAdaptCounter() {
1136 return adapt_counters_[degradation_preference_];
1137 }
1138
1139 const ViEEncoder::AdaptCounter& ViEEncoder::GetConstAdaptCounter() {
1140 return adapt_counters_[degradation_preference_];
1141 }
1142
1143 // Class holding adaptation information.
1144 ViEEncoder::AdaptCounter::AdaptCounter() {
1145 fps_counters_.resize(kScaleReasonSize);
1146 resolution_counters_.resize(kScaleReasonSize);
1147 static_assert(kScaleReasonSize == 2, "Update MoveCount.");
1148 }
1149
1150 ViEEncoder::AdaptCounter::~AdaptCounter() {}
1151
1152 std::string ViEEncoder::AdaptCounter::ToString() const {
1153 std::stringstream ss;
1154 ss << "Downgrade counts: fps: {" << ToString(fps_counters_);
1155 ss << "}, resolution: {" << ToString(resolution_counters_) << "}";
1156 return ss.str();
1157 }
1158
1159 ViEEncoder::AdaptCounts ViEEncoder::AdaptCounter::Counts(int reason) const {
1160 AdaptCounts counts;
1161 counts.fps = fps_counters_[reason];
1162 counts.resolution = resolution_counters_[reason];
1163 return counts;
1164 }
1165
1166 void ViEEncoder::AdaptCounter::IncrementFramerate(int reason) {
1167 ++(fps_counters_[reason]);
1168 }
1169
1170 void ViEEncoder::AdaptCounter::IncrementResolution(int reason) {
1171 ++(resolution_counters_[reason]);
1172 }
1173
1174 void ViEEncoder::AdaptCounter::DecrementFramerate(int reason) {
1175 if (fps_counters_[reason] == 0) {
1176 // Balanced mode: Adapt up is in a different order, switch reason.
1177 // E.g. framerate adapt down: quality (2), framerate adapt up: cpu (3).
1178 // 1. Down resolution (cpu): res={quality:0,cpu:1}, fps={quality:0,cpu:0}
1179 // 2. Down fps (quality): res={quality:0,cpu:1}, fps={quality:1,cpu:0}
1180 // 3. Up fps (cpu): res={quality:1,cpu:0}, fps={quality:0,cpu:0}
1181 // 4. Up resolution (quality): res={quality:0,cpu:0}, fps={quality:0,cpu:0}
1182 RTC_DCHECK_GT(TotalCount(reason), 0) << "No downgrade for reason.";
1183 RTC_DCHECK_GT(FramerateCount(), 0) << "Framerate not downgraded.";
1184 MoveCount(&resolution_counters_, reason);
1185 MoveCount(&fps_counters_, (reason + 1) % kScaleReasonSize);
1186 }
1187 --(fps_counters_[reason]);
1188 RTC_DCHECK_GE(fps_counters_[reason], 0);
1189 }
1190
1191 void ViEEncoder::AdaptCounter::DecrementResolution(int reason) {
1192 if (resolution_counters_[reason] == 0) {
1193 // Balanced mode: Adapt up is in a different order, switch reason.
1194 RTC_DCHECK_GT(TotalCount(reason), 0) << "No downgrade for reason.";
1195 RTC_DCHECK_GT(ResolutionCount(), 0) << "Resolution not downgraded.";
1196 MoveCount(&fps_counters_, reason);
1197 MoveCount(&resolution_counters_, (reason + 1) % kScaleReasonSize);
1198 }
1199 --(resolution_counters_[reason]);
1200 RTC_DCHECK_GE(resolution_counters_[reason], 0);
1201 }
1202
1203 void ViEEncoder::AdaptCounter::DecrementFramerate(int reason, int cur_fps) {
1204 DecrementFramerate(reason);
1205 // Reset if at max fps (i.e. in case of fewer steps up than down).
1206 if (cur_fps == std::numeric_limits<int>::max())
1207 std::fill(fps_counters_.begin(), fps_counters_.end(), 0);
1208 }
1209
1210 int ViEEncoder::AdaptCounter::FramerateCount() const {
1211 return Count(fps_counters_);
1212 }
1213
1214 int ViEEncoder::AdaptCounter::ResolutionCount() const {
1215 return Count(resolution_counters_);
1216 }
1217
1218 int ViEEncoder::AdaptCounter::FramerateCount(int reason) const {
1219 return fps_counters_[reason];
1220 }
1221
1222 int ViEEncoder::AdaptCounter::ResolutionCount(int reason) const {
1223 return resolution_counters_[reason];
1224 }
1225
1226 int ViEEncoder::AdaptCounter::TotalCount(int reason) const {
1227 return FramerateCount(reason) + ResolutionCount(reason);
1228 }
1229
1230 int ViEEncoder::AdaptCounter::Count(const std::vector<int>& counters) const {
1231 return std::accumulate(counters.begin(), counters.end(), 0);
1232 }
1233
1234 void ViEEncoder::AdaptCounter::MoveCount(std::vector<int>* counters,
1235 int from_reason) {
1236 int to_reason = (from_reason + 1) % kScaleReasonSize;
1237 ++((*counters)[to_reason]);
1238 --((*counters)[from_reason]);
1239 }
1240
1241 std::string ViEEncoder::AdaptCounter::ToString(
1242 const std::vector<int>& counters) const {
1243 std::stringstream ss;
1244 for (size_t reason = 0; reason < kScaleReasonSize; ++reason) {
1245 ss << (reason ? " cpu" : "quality") << ":" << counters[reason];
1246 }
1247 return ss.str();
1248 }
1249
1250 } // namespace webrtc
OLDNEW
« no previous file with comments | « webrtc/video/vie_encoder.h ('k') | webrtc/video/vie_encoder_unittest.cc » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698