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/mod_ops.h" | |
20 #include "webrtc/base/thread_annotations.h" | |
21 #include "webrtc/modules/include/module.h" | |
22 #include "webrtc/modules/video_coding/include/video_coding_defines.h" | |
23 #include "webrtc/modules/video_coding/packet.h" | |
24 #include "webrtc/modules/video_coding/histogram.h" | |
25 #include "webrtc/system_wrappers/include/clock.h" | |
26 | |
27 namespace webrtc { | |
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 struct SeqNumComparator { | |
63 bool operator()(uint16_t s1, uint16_t s2) const { return AheadOf(s2, s1); } | |
64 }; | |
65 | |
66 void AddPacketsToNack(uint16_t seq_num_start, uint16_t seq_num_end) | |
67 EXCLUSIVE_LOCKS_REQUIRED(crit_); | |
68 | |
69 // Removes packets from the nack list until the next keyframe. Returns true | |
70 // if packets were removed. | |
71 bool RemovePacketsUntilKeyFrame() EXCLUSIVE_LOCKS_REQUIRED(crit_); | |
72 std::vector<uint16_t> GetNackBatch(NackFilterOptions options) | |
73 EXCLUSIVE_LOCKS_REQUIRED(crit_); | |
74 | |
75 // Update the reordering distribution. | |
76 void UpdateReorderingStatistics(uint16_t seq_num) | |
77 EXCLUSIVE_LOCKS_REQUIRED(crit_); | |
78 | |
79 // Returns how many packets we have to wait in order to receive the packet | |
80 // with probability |probabilty| or higher. | |
81 int WaitNumberOfPackets(float probability) const | |
82 EXCLUSIVE_LOCKS_REQUIRED(crit_); | |
83 | |
84 rtc::CriticalSection crit_; | |
85 Clock* const clock_; | |
86 NackSender* const nack_sender_; | |
87 KeyFrameRequestSender* const keyframe_request_sender_; | |
88 | |
89 std::map<uint16_t, NackInfo, SeqNumComparator> nack_list_ GUARDED_BY(crit_); | |
90 std::set<uint16_t, SeqNumComparator> keyframe_list_ GUARDED_BY(crit_); | |
91 video_coding::Histogram reordering_histogram_ GUARDED_BY(crit_); | |
92 bool running_ GUARDED_BY(crit_); | |
93 bool initialized_ GUARDED_BY(crit_); | |
94 int64_t rtt_ms_ GUARDED_BY(crit_); | |
95 uint16_t last_seq_num_ GUARDED_BY(crit_); | |
96 int64_t next_process_time_ms_ GUARDED_BY(crit_); | |
97 }; | |
98 | |
99 } // namespace webrtc | |
100 | |
101 #endif // WEBRTC_MODULES_VIDEO_CODING_NACK_MODULE_H_ | |
OLD | NEW |