Index: webrtc/modules/video_coding/nack_module.h |
diff --git a/webrtc/modules/video_coding/nack_module.h b/webrtc/modules/video_coding/nack_module.h |
new file mode 100644 |
index 0000000000000000000000000000000000000000..c36c93c976da62166c8bcee30a8c13e4cbd13237 |
--- /dev/null |
+++ b/webrtc/modules/video_coding/nack_module.h |
@@ -0,0 +1,112 @@ |
+/* |
+ * 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. |
+ */ |
+ |
+#ifndef WEBRTC_MODULES_VIDEO_CODING_NACK_MODULE_H_ |
+#define WEBRTC_MODULES_VIDEO_CODING_NACK_MODULE_H_ |
+ |
+#include <map> |
+#include <vector> |
+#include <set> |
+ |
+#include "webrtc/base/thread_annotations.h" |
+#include "webrtc/base/thread_checker.h" |
stefan-webrtc
2016/03/01 08:52:10
Currently not used
philipel
2016/03/01 10:27:07
Done.
|
+#include "webrtc/modules/include/module.h" |
+#include "webrtc/modules/video_coding/include/video_coding_defines.h" |
+#include "webrtc/modules/video_coding/packet.h" |
+#include "webrtc/modules/video_coding/distribution.h" |
+#include "webrtc/system_wrappers/include/clock.h" |
+#include "webrtc/system_wrappers/include/critical_section_wrapper.h" |
stefan-webrtc
2016/03/01 08:52:10
Use webrtc/base/criticalsection.h instead
philipel
2016/03/01 10:27:07
Done.
|
+ |
+namespace webrtc { |
+ |
+class NackModule : public Module { |
+ public: |
+ NackModule(Clock* clock, |
+ VCMNackSender* nack_sender, |
+ VCMKeyFrameRequestSender* keyframe_request_sender); |
+ |
+ void OnReceivedPacket(const VCMPacket& packet); |
+ void ClearUpTo(uint16_t seq_num); |
+ void UpdateRtt(int64_t rtt_ms); |
+ void Stop(); |
+ |
+ // Module implementation |
+ int64_t TimeUntilNextProcess() override; |
+ int32_t Process() override; |
+ |
+ private: |
+ // Which fields to consider when deciding |
+ // which packet to nack in GetNackBatch. |
stefan-webrtc
2016/03/01 08:52:11
Format comment so that it uses the full line lengt
philipel
2016/03/01 10:27:06
Done.
|
+ enum NackFilterOptions {kSeqNumOnly, kTimeOnly, kSeqNumAndTime}; |
stefan-webrtc
2016/03/01 08:52:10
kSeqNumAndTime doesn't seem to be used?
|
+ |
+ // This class holds the sequence number of the packet that is in the nack list |
+ // as well as the meta data about when it should be nacked and how many times |
+ // we have tried to nack this packet. |
+ struct NackInfo { |
+ NackInfo(); |
+ NackInfo(uint16_t seq_num, uint16_t send_at_seq_num); |
+ |
+ uint16_t seq_num; |
+ uint16_t send_at_seq_num; |
+ int64_t sent_at_time; |
+ int retries; |
+ }; |
+ |
+ void AddPacketsToNack(uint16_t seq_num_start, uint16_t seq_num_end) |
+ EXCLUSIVE_LOCKS_REQUIRED(crit_); |
+ |
+ // Removes packets from the nack list until the next |
+ // keyframe. Returns true if packets were removed. |
stefan-webrtc
2016/03/01 08:52:11
Reformat
philipel
2016/03/01 10:27:06
Done.
|
+ bool RemovePacketsUntilKeyframe() |
+ EXCLUSIVE_LOCKS_REQUIRED(crit_); |
+ void RemovePacketFromNack(uint16_t seq_num) |
+ EXCLUSIVE_LOCKS_REQUIRED(crit_); |
+ std::vector<uint16_t> GetNackBatch(NackFilterOptions options) |
+ EXCLUSIVE_LOCKS_REQUIRED(crit_); |
+ |
+ // Update the reordering distribution. |
+ void UpdateReorderingStatistics(uint16_t seq_num) |
+ EXCLUSIVE_LOCKS_REQUIRED(crit_); |
+ |
+ // Returns how many packets we have to wait in order to receive |
+ // the packet with probability |probabilty| or higher. |
stefan-webrtc
2016/03/01 08:52:11
Reformat
philipel
2016/03/01 10:27:06
Done.
|
+ int WaitNumberOfPackets(float probability) const |
+ EXCLUSIVE_LOCKS_REQUIRED(crit_); |
+ |
+ rtc::CriticalSection crit_; |
stefan-webrtc
2016/03/01 08:52:11
Maybe move the crit down to the group of members t
philipel
2016/03/01 10:27:06
Acknowledged.
|
+ Clock* const clock_; |
+ VCMNackSender* const nack_sender_; |
+ VCMKeyFrameRequestSender* const keyframe_request_sender_; |
+ |
+ struct SeqNumComparator { |
+ SeqNumComparator() { |
+ // Alowes the comparator to wrap back one time in order to compare |
+ // sequence numbers before an actual wrap has occured. |
+ unwrapper_.UpdateLast(0x20000); |
+ } |
+ bool operator()(uint16_t s1, uint16_t s2) { |
+ return unwrapper_.Unwrap(s1) < unwrapper_.Unwrap(s2); |
+ } |
+ SequenceNumberUnwrapper unwrapper_; |
stefan-webrtc
2016/03/01 08:52:10
I'd prefer to get rid of the state and instead bui
philipel
2016/03/01 10:27:06
Done.
|
+ }; |
+ |
+ std::map<int16_t, NackInfo, SeqNumComparator> nack_list_ GUARDED_BY(crit_); |
stefan-webrtc
2016/03/01 08:52:10
Comment on what the int16_t represent here and bel
philipel
2016/03/01 10:27:06
Yes, should be uint16_t.
|
+ std::set<int16_t, SeqNumComparator> keyframe_list_ GUARDED_BY(crit_); |
+ Distribution reordering_distribution_; |
+ bool running_ GUARDED_BY(crit_); |
+ bool initialized_ GUARDED_BY(crit_); |
+ int64_t rtt_ms_ GUARDED_BY(crit_); |
+ uint16_t last_seq_num_ GUARDED_BY(crit_); |
+ int64_t next_process_time_ms_ GUARDED_BY(crit_); |
+}; |
+ |
+} // namespace webrtc |
+ |
+#endif // WEBRTC_MODULES_VIDEO_CODING_NACK_MODULE_H_ |