/** * The MIT License (MIT) * * Copyright (c) 2013-2020 John * * Permission is hereby granted, free of charge, to any person obtaining a copy of * this software and associated documentation files (the "Software"), to deal in * the Software without restriction, including without limitation the rights to * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of * the Software, and to permit persons to whom the Software is furnished to do so, * subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all * copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ #ifndef SRS_APP_RTC_QUEUE_HPP #define SRS_APP_RTC_QUEUE_HPP #include #include #include #include #include #include class SrsRtpPacket2; class SrsRtpQueue; class SrsRtpRingBuffer; // For UDP, the packets sequence may present as bellow: // [seq1(done)|seq2|seq3 ... seq10|seq11(lost)|seq12|seq13] // \___(head_sequence_) \ \___(highest_sequence_) // \___(no received, in nack list) // * seq1: The packet is done, we have already got and processed it. // * seq2,seq3,...,seq10,seq12,seq13: Theses packets are in queue and wait to be processed. // * seq10: This packet is lost or not received, we will put it in the nack list. // We store the received packets in ring buffer. class SrsRtpRingBuffer { private: // Capacity of the ring-buffer. uint16_t capacity_; // Ring bufer. SrsRtpPacket2** queue_; // Increase one when uint16 flip back, for get_extended_highest_sequence. uint64_t nn_seq_flip_backs; // Whether initialized, because we use uint16 so we can't use -1. bool initialized_; public: // The begin iterator for ring buffer. // For example, when got 1 elems, the begin is 0. uint16_t begin; // The end iterator for ring buffer. // For example, when got 1 elems, the end is 1. uint16_t end; public: SrsRtpRingBuffer(int capacity); virtual ~SrsRtpRingBuffer(); public: // Whether the ring buffer is empty. bool empty(); // Get the count of elems in ring buffer. int size(); // Move the low position of buffer to seq. void advance_to(uint16_t seq); // Free the packet at position. void set(uint16_t at, SrsRtpPacket2* pkt); void remove(uint16_t at); // The highest sequence number, calculate the flip back base. uint32_t get_extended_highest_sequence(); // Update the sequence, got the nack range by [first, last). // @return If false, the seq is too old. bool update(uint16_t seq, uint16_t& nack_first, uint16_t& nack_last); // Get the packet by seq. SrsRtpPacket2* at(uint16_t seq); public: // TODO: FIXME: Refine it? void notify_nack_list_full(); void notify_drop_seq(uint16_t seq); public: void clear_histroy(uint16_t seq); void clear_all_histroy(); }; struct SrsNackOption { int max_count; srs_utime_t max_alive_time; srs_utime_t first_nack_interval; srs_utime_t nack_interval; srs_utime_t max_nack_interval; srs_utime_t min_nack_interval; srs_utime_t nack_check_interval; SrsNackOption(); }; struct SrsRtpNackInfo { // Use to control the time of first nack req and the life of seq. srs_utime_t generate_time_; // Use to control nack interval. srs_utime_t pre_req_nack_time_; // Use to control nack times. int req_nack_count_; SrsRtpNackInfo(); }; class SrsRtpNackForReceiver { private: // Nack queue, seq order, oldest to newest. std::map queue_; // Max nack count. size_t max_queue_size_; SrsRtpRingBuffer* rtp_; SrsNackOption opts_; private: srs_utime_t pre_check_time_; private: int rtt_; public: SrsRtpNackForReceiver(SrsRtpRingBuffer* rtp, size_t queue_size); virtual ~SrsRtpNackForReceiver(); public: void insert(uint16_t first, uint16_t last); void remove(uint16_t seq); SrsRtpNackInfo* find(uint16_t seq); void check_queue_size(); public: void get_nack_seqs(SrsRtcpNack& seqs, uint32_t& timeout_nacks); public: void update_rtt(int rtt); }; #endif