Add support for a forced software encoder fallback.

webrtc/media/engine/videoencodersoftwarefallbackwrapper.h

 /*
  *  Copyright (c) 2016 The WebRTC project authors. All Rights Reserved.
  *
  *  Use of this source code is governed by a BSD-style license
  *  that can be found in the LICENSE file in the root of the source
  *  tree. An additional intellectual property rights grant can be found
  *  in the file PATENTS.  All contributing project authors may
  *  be found in the AUTHORS file in the root of the source tree.
  */
 
@@ skipping 28 matching lines @@
   int32_t Encode(const VideoFrame& frame,
                  const CodecSpecificInfo* codec_specific_info,
                  const std::vector<FrameType>* frame_types) override;
   int32_t SetChannelParameters(uint32_t packet_loss, int64_t rtt) override;
   int32_t SetRateAllocation(const BitrateAllocation& bitrate_allocation,
                             uint32_t framerate) override;
   bool SupportsNativeHandle() const override;
   ScalingSettings GetScalingSettings() const override;
   const char *ImplementationName() const override;
 
+  // If |forced_fallback_enabled_| is true and the encoded resolution
+  // is <= |max_pixels|:
+  // The forced fallback is enabled if the target bitrate is below |low_kbps|
+  // for more than |min_low_ms|. If the bitrate is above |high_kbps|, the forced

[sprang_webrtc, 2017/08/07 08:59:12]

Does same time limit apply for high_kbps?

[åsapersson, 2017/08/08 10:40:54]

No, updated comment.

+  // fallback is disabled.
+  struct ForcedFallbackParams {
+    rtc::Optional<int64_t> start_ms;

[brandtr, 2017/08/04 11:16:23]

IIUC, start_ms is the timestamp when we go below |low_kbps| ?

[åsapersson, 2017/08/08 10:40:54]

Added comment.

[brandtr, 2017/08/09 09:05:02]

Thanks. It's easier to understand now.

+    uint32_t low_kbps = 100;
+    uint32_t high_kbps = 150;
+    int64_t min_low_ms = 10000;
+    const int max_pixels = 76800;  // 320 * 240

[brandtr, 2017/08/04 11:16:23]

Maybe remove comment and write max_pixels = 320 * 240 ?

[åsapersson, 2017/08/08 10:40:54]

Done.

+  };
+
  private:
   bool InitFallbackEncoder();
 
+  bool StartForcedFallback();
+  bool TryReleaseForcedFallbackEncoder();
+  bool TryReInitForcedFallbackEncoder();
+  void ValidateSettingsForForcedFallback();
+
   // Settings used in the last InitEncode call and used if a dynamic fallback to
   // software is required.
   VideoCodec codec_settings_;
   int32_t number_of_cores_;
   size_t max_payload_size_;
 
   // The last bitrate/framerate set, and a flag for noting they are set.
   bool rates_set_;
   BitrateAllocation bitrate_allocation_;
   uint32_t framerate_;
 
   // The last channel parameters set, and a flag for noting they are set.
   bool channel_parameters_set_;
   uint32_t packet_loss_;
   int64_t rtt_;
 
   const cricket::VideoCodec codec_;
   webrtc::VideoEncoder* const encoder_;
 
   std::unique_ptr<webrtc::VideoEncoder> fallback_encoder_;
   std::string fallback_implementation_name_;
   EncodedImageCallback* callback_;
+
+  bool forced_fallback_enabled_;

[brandtr, 2017/08/04 11:16:23]

How about |forced_fallback_possible_|? This member only shows if we can do the
forced fallback, not if we have actually done it.

[åsapersson, 2017/08/08 10:40:54]

Done.

+  ForcedFallbackParams forced_fallback_;
 };
 
 }  // namespace webrtc
 
 #endif  // WEBRTC_MEDIA_ENGINE_VIDEOENCODERSOFTWAREFALLBACKWRAPPER_H_