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 |
11 #ifndef WEBRTC_MODULES_AUDIO_CODING_NETEQ_PAYLOAD_SPLITTER_H_ | 11 #ifndef WEBRTC_MODULES_AUDIO_CODING_NETEQ_PAYLOAD_SPLITTER_H_ |
12 #define WEBRTC_MODULES_AUDIO_CODING_NETEQ_PAYLOAD_SPLITTER_H_ | 12 #define WEBRTC_MODULES_AUDIO_CODING_NETEQ_PAYLOAD_SPLITTER_H_ |
13 | 13 |
14 #include "webrtc/base/constructormagic.h" | 14 #include "webrtc/base/constructormagic.h" |
15 #include "webrtc/modules/audio_coding/neteq/packet.h" | 15 #include "webrtc/modules/audio_coding/neteq/packet.h" |
16 | 16 |
17 namespace webrtc { | 17 namespace webrtc { |
18 | 18 |
19 // Forward declarations. | 19 // Forward declarations. |
20 class DecoderDatabase; | 20 class DecoderDatabase; |
21 | 21 |
22 // This class handles splitting of payloads into smaller parts. | 22 // This class handles splitting of payloads into smaller parts. |
23 // The class does not have any member variables, and the methods could have | 23 |
24 // been made static. The reason for not making them static is testability. | 24 // For RED and FEC the splitting is done internally. Other codecs' packets are |
25 // With this design, the splitting functionality can be mocked during testing | 25 // split by calling AudioDecoder::SplitPacket. |
26 // of the NetEqImpl class. | |
27 class PayloadSplitter { | 26 class PayloadSplitter { |
28 public: | 27 public: |
29 enum SplitterReturnCodes { | 28 enum SplitterReturnCodes { |
30 kOK = 0, | 29 kOK = 0, |
31 kNoSplit = 1, | 30 kNoSplit = 1, |
32 kTooLargePayload = -1, | |
33 kFrameSplitError = -2, | 31 kFrameSplitError = -2, |
34 kUnknownPayloadType = -3, | 32 kUnknownPayloadType = -3, |
35 kRedLengthMismatch = -4, | 33 kRedLengthMismatch = -4, |
36 kFecSplitError = -5, | 34 kFecSplitError = -5, |
37 }; | 35 }; |
38 | 36 |
39 PayloadSplitter() {} | 37 PayloadSplitter() {} |
40 | 38 |
41 virtual ~PayloadSplitter() {} | 39 virtual ~PayloadSplitter() {} |
42 | 40 |
(...skipping 18 matching lines...) Expand all Loading... |
61 const DecoderDatabase& decoder_database); | 59 const DecoderDatabase& decoder_database); |
62 | 60 |
63 // Iterates through |packet_list| and, if possible, splits each audio payload | 61 // Iterates through |packet_list| and, if possible, splits each audio payload |
64 // into suitable size chunks. The result is written back to |packet_list| as | 62 // into suitable size chunks. The result is written back to |packet_list| as |
65 // new packets. The decoder database is needed to get information about which | 63 // new packets. The decoder database is needed to get information about which |
66 // payload type each packet contains. | 64 // payload type each packet contains. |
67 virtual int SplitAudio(PacketList* packet_list, | 65 virtual int SplitAudio(PacketList* packet_list, |
68 const DecoderDatabase& decoder_database); | 66 const DecoderDatabase& decoder_database); |
69 | 67 |
70 private: | 68 private: |
71 // Splits the payload in |packet|. The payload is assumed to be from a | |
72 // sample-based codec. | |
73 virtual void SplitBySamples(const Packet* packet, | |
74 size_t bytes_per_ms, | |
75 uint32_t timestamps_per_ms, | |
76 PacketList* new_packets); | |
77 | |
78 // Splits the payload in |packet|. The payload will be split into chunks of | |
79 // size |bytes_per_frame|, corresponding to a |timestamps_per_frame| | |
80 // RTP timestamps. | |
81 virtual int SplitByFrames(const Packet* packet, | |
82 size_t bytes_per_frame, | |
83 uint32_t timestamps_per_frame, | |
84 PacketList* new_packets); | |
85 | 69 |
86 RTC_DISALLOW_COPY_AND_ASSIGN(PayloadSplitter); | 70 RTC_DISALLOW_COPY_AND_ASSIGN(PayloadSplitter); |
87 }; | 71 }; |
88 | 72 |
89 } // namespace webrtc | 73 } // namespace webrtc |
90 #endif // WEBRTC_MODULES_AUDIO_CODING_NETEQ_PAYLOAD_SPLITTER_H_ | 74 #endif // WEBRTC_MODULES_AUDIO_CODING_NETEQ_PAYLOAD_SPLITTER_H_ |
OLD | NEW |