Repo created

TMessagesProj/jni/voip/webrtc/call/rtp_bitrate_configurator.h

@@ -0,0 +1,77 @@
+/*
+ *  Copyright (c) 2018 The WebRTC project authors. All Rights Reserved.
+ *
+ *  Use of this source code is governed by a BSD-style license
+ *  that can be found in the LICENSE file in the root of the source
+ *  tree. An additional intellectual property rights grant can be found
+ *  in the file PATENTS.  All contributing project authors may
+ *  be found in the AUTHORS file in the root of the source tree.
+ */
+
+#ifndef CALL_RTP_BITRATE_CONFIGURATOR_H_
+#define CALL_RTP_BITRATE_CONFIGURATOR_H_
+
+#include "absl/types/optional.h"
+#include "api/transport/bitrate_settings.h"
+#include "api/units/data_rate.h"
+
+namespace webrtc {
+
+// RtpBitrateConfigurator calculates the bitrate configuration based on received
+// remote configuration combined with local overrides.
+class RtpBitrateConfigurator {
+ public:
+  explicit RtpBitrateConfigurator(const BitrateConstraints& bitrate_config);
+  ~RtpBitrateConfigurator();
+
+  RtpBitrateConfigurator(const RtpBitrateConfigurator&) = delete;
+  RtpBitrateConfigurator& operator=(const RtpBitrateConfigurator&) = delete;
+
+  BitrateConstraints GetConfig() const;
+
+  // The greater min and smaller max set by this and SetClientBitratePreferences
+  // will be used. The latest non-negative start value from either call will be
+  // used. Specifying a start bitrate (>0) will reset the current bitrate
+  // estimate. This is due to how the 'x-google-start-bitrate' flag is currently
+  // implemented. Passing -1 leaves the start bitrate unchanged. Behavior is not
+  // guaranteed for other negative values or 0.
+  // The optional return value is set with new configuration if it was updated.
+  absl::optional<BitrateConstraints> UpdateWithSdpParameters(
+      const BitrateConstraints& bitrate_config_);
+
+  // The greater min and smaller max set by this and SetSdpBitrateParameters
+  // will be used. The latest non-negative start value form either call will be
+  // used. Specifying a start bitrate will reset the current bitrate estimate.
+  // Assumes 0 <= min <= start <= max holds for set parameters.
+  // Update the bitrate configuration
+  // The optional return value is set with new configuration if it was updated.
+  absl::optional<BitrateConstraints> UpdateWithClientPreferences(
+      const BitrateSettings& bitrate_mask);
+
+  // Apply a cap for relayed calls.
+  absl::optional<BitrateConstraints> UpdateWithRelayCap(DataRate cap);
+
+ private:
+  // Applies update to the BitrateConstraints cached in `config_`, resetting
+  // with `new_start` if set.
+  absl::optional<BitrateConstraints> UpdateConstraints(
+      const absl::optional<int>& new_start);
+
+  // Bitrate config used until valid bitrate estimates are calculated. Also
+  // used to cap total bitrate used. This comes from the remote connection.
+  BitrateConstraints bitrate_config_;
+
+  // The config mask set by SetClientBitratePreferences.
+  // 0 <= min <= start <= max
+  BitrateSettings bitrate_config_mask_;
+
+  // The config set by SetSdpBitrateParameters.
+  // min >= 0, start != 0, max == -1 || max > 0
+  BitrateConstraints base_bitrate_config_;
+
+  // Bandwidth cap applied for relayed calls.
+  DataRate max_bitrate_over_relay_ = DataRate::PlusInfinity();
+};
+}  // namespace webrtc
+
+#endif  // CALL_RTP_BITRATE_CONFIGURATOR_H_