OLD | NEW |
---|---|
(Empty) | |
1 /* | |
2 * Copyright (c) 2016 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 #ifndef WEBRTC_MODULES_VIDEO_CODING_NACK_MODULE_H_ | |
12 #define WEBRTC_MODULES_VIDEO_CODING_NACK_MODULE_H_ | |
13 | |
14 #include <map> | |
15 #include <vector> | |
16 #include <set> | |
17 | |
18 #include "webrtc/base/criticalsection.h" | |
19 #include "webrtc/base/thread_annotations.h" | |
20 #include "webrtc/modules/include/module.h" | |
21 #include "webrtc/modules/video_coding/include/video_coding_defines.h" | |
22 #include "webrtc/modules/video_coding/packet.h" | |
23 #include "webrtc/modules/video_coding/histogram.h" | |
24 #include "webrtc/system_wrappers/include/clock.h" | |
25 | |
26 namespace webrtc { | |
27 | |
28 | |
29 class NackModule : public Module { | |
30 public: | |
31 NackModule(Clock* clock, | |
32 NackSender* nack_sender, | |
33 KeyFrameRequestSender* keyframe_request_sender); | |
34 | |
35 void OnReceivedPacket(const VCMPacket& packet); | |
36 void ClearUpTo(uint16_t seq_num); | |
37 void UpdateRtt(int64_t rtt_ms); | |
38 void Stop(); | |
39 | |
40 // Module implementation | |
41 int64_t TimeUntilNextProcess() override; | |
42 void Process() override; | |
43 | |
44 private: | |
45 // Which fields to consider when deciding which packet to nack in | |
46 // GetNackBatch. | |
47 enum NackFilterOptions { kSeqNumOnly, kTimeOnly, kSeqNumAndTime }; | |
48 | |
49 // This class holds the sequence number of the packet that is in the nack list | |
50 // as well as the meta data about when it should be nacked and how many times | |
51 // we have tried to nack this packet. | |
52 struct NackInfo { | |
53 NackInfo(); | |
54 NackInfo(uint16_t seq_num, uint16_t send_at_seq_num); | |
55 | |
56 uint16_t seq_num; | |
57 uint16_t send_at_seq_num; | |
58 int64_t sent_at_time; | |
59 int retries; | |
60 }; | |
61 | |
62 void AddPacketsToNack(uint16_t seq_num_start, uint16_t seq_num_end) | |
63 EXCLUSIVE_LOCKS_REQUIRED(crit_); | |
64 | |
65 // Removes packets from the nack list until the next keyframe. Returns true | |
66 // if packets were removed. | |
67 bool RemovePacketsUntilKeyFrame() EXCLUSIVE_LOCKS_REQUIRED(crit_); | |
68 std::vector<uint16_t> GetNackBatch(NackFilterOptions options) | |
69 EXCLUSIVE_LOCKS_REQUIRED(crit_); | |
70 | |
71 // Update the reordering distribution. | |
72 void UpdateReorderingStatistics(uint16_t seq_num) | |
73 EXCLUSIVE_LOCKS_REQUIRED(crit_); | |
74 | |
75 // Returns how many packets we have to wait in order to receive the packet | |
76 // with probability |probabilty| or higher. | |
77 int WaitNumberOfPackets(float probability) const | |
78 EXCLUSIVE_LOCKS_REQUIRED(crit_); | |
79 | |
80 rtc::CriticalSection crit_; | |
81 Clock* const clock_; | |
82 NackSender* const nack_sender_; | |
83 KeyFrameRequestSender* const keyframe_request_sender_; | |
84 | |
85 struct SeqNumComparator { | |
86 bool operator()(uint16_t s1, uint16_t s2) { | |
87 return IsNewerSequenceNumber(s2, s1); | |
88 } | |
89 }; | |
stefan-webrtc
2016/03/01 12:16:34
Prefer moving this up to the other types, e.g., Na
philipel
2016/03/01 13:31:09
Done.
| |
90 | |
91 std::map<uint16_t, NackInfo, SeqNumComparator> nack_list_ GUARDED_BY(crit_); | |
92 std::set<uint16_t, SeqNumComparator> keyframe_list_ GUARDED_BY(crit_); | |
93 video_coding::Histogram reordering_histogram_; | |
stefan-webrtc
2016/03/01 12:16:34
Does this not have to be guarded by crit_? In that
philipel
2016/03/01 13:31:09
Should be guarded by crit_, fixed.
| |
94 bool running_ GUARDED_BY(crit_); | |
95 bool initialized_ GUARDED_BY(crit_); | |
96 int64_t rtt_ms_ GUARDED_BY(crit_); | |
97 uint16_t last_seq_num_ GUARDED_BY(crit_); | |
98 int64_t next_process_time_ms_ GUARDED_BY(crit_); | |
99 }; | |
100 | |
101 } // namespace webrtc | |
102 | |
103 #endif // WEBRTC_MODULES_VIDEO_CODING_NACK_MODULE_H_ | |
OLD | NEW |