OLD | NEW |
1 /* | 1 /* |
2 * Copyright (c) 2014 The WebRTC project authors. All Rights Reserved. | 2 * Copyright (c) 2014 The WebRTC project authors. All Rights Reserved. |
3 * | 3 * |
4 * Use of this source code is governed by a BSD-style license | 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 | 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 | 6 * tree. An additional intellectual property rights grant can be found |
7 * in the file PATENTS. All contributing project authors may | 7 * in the file PATENTS. All contributing project authors may |
8 * be found in the AUTHORS file in the root of the source tree. | 8 * be found in the AUTHORS file in the root of the source tree. |
9 */ | 9 */ |
10 | 10 |
11 #ifndef WEBRTC_MODULES_PACING_BITRATE_PROBER_H_ | 11 #ifndef WEBRTC_MODULES_PACING_BITRATE_PROBER_H_ |
12 #define WEBRTC_MODULES_PACING_BITRATE_PROBER_H_ | 12 #define WEBRTC_MODULES_PACING_BITRATE_PROBER_H_ |
13 | 13 |
14 #include <queue> | 14 #include <queue> |
15 | 15 |
16 #include "webrtc/base/basictypes.h" | 16 #include "webrtc/base/basictypes.h" |
| 17 #include "webrtc/modules/include/module_common_types.h" |
17 #include "webrtc/typedefs.h" | 18 #include "webrtc/typedefs.h" |
18 | 19 |
19 namespace webrtc { | 20 namespace webrtc { |
20 | 21 |
21 // Note that this class isn't thread-safe by itself and therefore relies | 22 // Note that this class isn't thread-safe by itself and therefore relies |
22 // on being protected by the caller. | 23 // on being protected by the caller. |
23 class BitrateProber { | 24 class BitrateProber { |
24 public: | 25 public: |
25 BitrateProber(); | 26 BitrateProber(); |
26 | 27 |
(...skipping 10 matching lines...) Expand all Loading... |
37 void OnIncomingPacket(size_t packet_size); | 38 void OnIncomingPacket(size_t packet_size); |
38 | 39 |
39 // Create a cluster used to probe for |bitrate_bps| with |num_probes| number | 40 // Create a cluster used to probe for |bitrate_bps| with |num_probes| number |
40 // of probes. | 41 // of probes. |
41 void CreateProbeCluster(int bitrate_bps, int64_t now_ms); | 42 void CreateProbeCluster(int bitrate_bps, int64_t now_ms); |
42 | 43 |
43 // Returns the number of milliseconds until the next probe should be sent to | 44 // Returns the number of milliseconds until the next probe should be sent to |
44 // get accurate probing. | 45 // get accurate probing. |
45 int TimeUntilNextProbe(int64_t now_ms); | 46 int TimeUntilNextProbe(int64_t now_ms); |
46 | 47 |
47 // Which cluster that is currently being used for probing. | 48 // Information about the current probing cluster. |
48 int CurrentClusterId() const; | 49 PacedPacketInfo CurrentCluster() const; |
49 | 50 |
50 // Returns the minimum number of bytes that the prober recommends for | 51 // Returns the minimum number of bytes that the prober recommends for |
51 // the next probe. | 52 // the next probe. |
52 size_t RecommendedMinProbeSize() const; | 53 size_t RecommendedMinProbeSize() const; |
53 | 54 |
54 // Called to report to the prober that a probe has been sent. In case of | 55 // Called to report to the prober that a probe has been sent. In case of |
55 // multiple packets per probe, this call would be made at the end of sending | 56 // multiple packets per probe, this call would be made at the end of sending |
56 // the last packet in probe. |probe_size| is the total size of all packets | 57 // the last packet in probe. |probe_size| is the total size of all packets |
57 // in probe. | 58 // in probe. |
58 void ProbeSent(int64_t now_ms, size_t probe_size); | 59 void ProbeSent(int64_t now_ms, size_t probe_size); |
59 | 60 |
60 private: | 61 private: |
61 enum class ProbingState { | 62 enum class ProbingState { |
62 // Probing will not be triggered in this state at all times. | 63 // Probing will not be triggered in this state at all times. |
63 kDisabled, | 64 kDisabled, |
64 // Probing is enabled and ready to trigger on the first packet arrival. | 65 // Probing is enabled and ready to trigger on the first packet arrival. |
65 kInactive, | 66 kInactive, |
66 // Probe cluster is filled with the set of data rates to be probed and | 67 // Probe cluster is filled with the set of data rates to be probed and |
67 // probes are being sent. | 68 // probes are being sent. |
68 kActive, | 69 kActive, |
69 // Probing is enabled, but currently suspended until an explicit trigger | 70 // Probing is enabled, but currently suspended until an explicit trigger |
70 // to start probing again. | 71 // to start probing again. |
71 kSuspended, | 72 kSuspended, |
72 }; | 73 }; |
73 | 74 |
74 // A probe cluster consists of a set of probes. Each probe in turn can be | 75 // A probe cluster consists of a set of probes. Each probe in turn can be |
75 // divided into a number of packets to accommodate the MTU on the network. | 76 // divided into a number of packets to accommodate the MTU on the network. |
76 struct ProbeCluster { | 77 struct ProbeCluster { |
77 int min_probes = 0; | 78 PacedPacketInfo pace_info; |
78 int min_bytes = 0; | |
79 int bitrate_bps = 0; | |
80 int id = -1; | |
81 | 79 |
82 int sent_probes = 0; | 80 int sent_probes = 0; |
83 int sent_bytes = 0; | 81 int sent_bytes = 0; |
84 int64_t time_created_ms = -1; | 82 int64_t time_created_ms = -1; |
85 int64_t time_started_ms = -1; | 83 int64_t time_started_ms = -1; |
86 | |
87 int retries = 0; | 84 int retries = 0; |
88 }; | 85 }; |
89 | 86 |
90 // Resets the state of the prober and clears any cluster/timing data tracked. | 87 // Resets the state of the prober and clears any cluster/timing data tracked. |
91 void ResetState(int64_t now_ms); | 88 void ResetState(int64_t now_ms); |
92 | 89 |
93 int64_t GetNextProbeTime(const ProbeCluster& cluster); | 90 int64_t GetNextProbeTime(const ProbeCluster& cluster); |
94 | 91 |
95 ProbingState probing_state_; | 92 ProbingState probing_state_; |
96 | 93 |
97 // Probe bitrate per packet. These are used to compute the delta relative to | 94 // Probe bitrate per packet. These are used to compute the delta relative to |
98 // the previous probe packet based on the size and time when that packet was | 95 // the previous probe packet based on the size and time when that packet was |
99 // sent. | 96 // sent. |
100 std::queue<ProbeCluster> clusters_; | 97 std::queue<ProbeCluster> clusters_; |
101 | 98 |
102 // Time the next probe should be sent when in kActive state. | 99 // Time the next probe should be sent when in kActive state. |
103 int64_t next_probe_time_ms_; | 100 int64_t next_probe_time_ms_; |
104 | 101 |
105 int next_cluster_id_; | 102 int next_cluster_id_; |
106 }; | 103 }; |
107 | 104 |
108 } // namespace webrtc | 105 } // namespace webrtc |
109 | 106 |
110 #endif // WEBRTC_MODULES_PACING_BITRATE_PROBER_H_ | 107 #endif // WEBRTC_MODULES_PACING_BITRATE_PROBER_H_ |
OLD | NEW |