OLD | NEW |
1 /* | 1 /* |
2 * Copyright (c) 2012 The WebRTC project authors. All Rights Reserved. | 2 * Copyright (c) 2012 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 |
(...skipping 41 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
52 void SetFecParameters(const FecProtectionParams* params, | 52 void SetFecParameters(const FecProtectionParams* params, |
53 int num_first_partition); | 53 int num_first_partition); |
54 | 54 |
55 // Adds a media packet to the internal buffer. When enough media packets | 55 // Adds a media packet to the internal buffer. When enough media packets |
56 // have been added, the FEC packets are generated and stored internally. | 56 // have been added, the FEC packets are generated and stored internally. |
57 // These FEC packets are then obtained by calling GetFecPacketsAsRed(). | 57 // These FEC packets are then obtained by calling GetFecPacketsAsRed(). |
58 int AddRtpPacketAndGenerateFec(const uint8_t* data_buffer, | 58 int AddRtpPacketAndGenerateFec(const uint8_t* data_buffer, |
59 size_t payload_length, | 59 size_t payload_length, |
60 size_t rtp_header_length); | 60 size_t rtp_header_length); |
61 | 61 |
| 62 // Returns true if there are generated FEC packets available. |
| 63 bool FecAvailable() const; |
| 64 |
| 65 size_t NumAvailableFecPackets() const; |
| 66 |
| 67 // Returns the overhead, per packet, for FEC (and possibly RED). |
| 68 size_t MaxPacketOverhead() const; |
| 69 |
| 70 // Returns generated FEC packets with RED headers added. |
| 71 std::vector<std::unique_ptr<RedPacket>> GetUlpfecPacketsAsRed( |
| 72 int red_payload_type, |
| 73 int ulpfec_payload_type, |
| 74 uint16_t first_seq_num, |
| 75 size_t rtp_header_length); |
| 76 |
| 77 private: |
| 78 // Overhead is defined as relative to the number of media packets, and not |
| 79 // relative to total number of packets. This definition is inherited from the |
| 80 // protection factor produced by video_coding module and how the FEC |
| 81 // generation is implemented. |
| 82 int Overhead() const; |
| 83 |
62 // Returns true if the excess overhead (actual - target) for the FEC is below | 84 // Returns true if the excess overhead (actual - target) for the FEC is below |
63 // the amount |kMaxExcessOverhead|. This effects the lower protection level | 85 // the amount |kMaxExcessOverhead|. This effects the lower protection level |
64 // cases and low number of media packets/frame. The target overhead is given | 86 // cases and low number of media packets/frame. The target overhead is given |
65 // by |params_.fec_rate|, and is only achievable in the limit of large number | 87 // by |params_.fec_rate|, and is only achievable in the limit of large number |
66 // of media packets. | 88 // of media packets. |
67 bool ExcessOverheadBelowMax() const; | 89 bool ExcessOverheadBelowMax() const; |
68 | 90 |
69 // Returns true if the number of added media packets is at least | 91 // Returns true if the number of added media packets is at least |
70 // |min_num_media_packets_|. This condition tries to capture the effect | 92 // |min_num_media_packets_|. This condition tries to capture the effect |
71 // that, for the same amount of protection/overhead, longer codes | 93 // that, for the same amount of protection/overhead, longer codes |
72 // (e.g. (2k,2m) vs (k,m)) are generally more effective at recovering losses. | 94 // (e.g. (2k,2m) vs (k,m)) are generally more effective at recovering losses. |
73 bool MinimumMediaPacketsReached() const; | 95 bool MinimumMediaPacketsReached() const; |
74 | 96 |
75 // Returns true if there are generated FEC packets available. | 97 void ResetState(); |
76 bool FecAvailable() const; | |
77 | 98 |
78 size_t NumAvailableFecPackets() const; | |
79 | |
80 size_t MaxPacketOverhead() const; | |
81 | |
82 // Returns generated FEC packets with RED headers added. | |
83 std::vector<std::unique_ptr<RedPacket>> GetFecPacketsAsRed( | |
84 int red_payload_type, | |
85 int ulpfec_payload_type, | |
86 uint16_t first_seq_num, | |
87 size_t rtp_header_length); | |
88 | |
89 private: | |
90 void DeleteMediaPackets(); | |
91 int Overhead() const; | |
92 std::unique_ptr<ForwardErrorCorrection> fec_; | 99 std::unique_ptr<ForwardErrorCorrection> fec_; |
93 ForwardErrorCorrection::PacketList media_packets_; | 100 ForwardErrorCorrection::PacketList media_packets_; |
94 std::list<ForwardErrorCorrection::Packet*> generated_fec_packets_; | 101 std::list<ForwardErrorCorrection::Packet*> generated_fec_packets_; |
95 int num_protected_frames_; | 102 int num_protected_frames_; |
96 int num_important_packets_; | 103 int num_important_packets_; |
97 int min_num_media_packets_; | 104 int min_num_media_packets_; |
98 FecProtectionParams params_; | 105 FecProtectionParams params_; |
99 FecProtectionParams new_params_; | 106 FecProtectionParams new_params_; |
100 }; | 107 }; |
101 | 108 |
102 } // namespace webrtc | 109 } // namespace webrtc |
103 | 110 |
104 #endif // WEBRTC_MODULES_RTP_RTCP_SOURCE_PRODUCER_FEC_H_ | 111 #endif // WEBRTC_MODULES_RTP_RTCP_SOURCE_PRODUCER_FEC_H_ |
OLD | NEW |