xref: /aosp_15_r20/external/webrtc/modules/audio_coding/neteq/red_payload_splitter.h (revision d9f758449e529ab9291ac668be2861e7a55c2422)
1 /*
2  *  Copyright (c) 2012 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 MODULES_AUDIO_CODING_NETEQ_RED_PAYLOAD_SPLITTER_H_
12 #define MODULES_AUDIO_CODING_NETEQ_RED_PAYLOAD_SPLITTER_H_
13 
14 #include "modules/audio_coding/neteq/packet.h"
15 
16 namespace webrtc {
17 
18 class DecoderDatabase;
19 
20 static const size_t kRedHeaderLength = 4;  // 4 bytes RED header.
21 static const size_t kRedLastHeaderLength =
22     1;  // reduced size for last RED header.
23 // This class handles splitting of RED payloads into smaller parts.
24 // Codec-specific packet splitting can be performed by
25 // AudioDecoder::ParsePayload.
26 class RedPayloadSplitter {
27  public:
RedPayloadSplitter()28   RedPayloadSplitter() {}
29 
~RedPayloadSplitter()30   virtual ~RedPayloadSplitter() {}
31 
32   RedPayloadSplitter(const RedPayloadSplitter&) = delete;
33   RedPayloadSplitter& operator=(const RedPayloadSplitter&) = delete;
34 
35   // Splits each packet in `packet_list` into its separate RED payloads. Each
36   // RED payload is packetized into a Packet. The original elements in
37   // `packet_list` are properly deleted, and replaced by the new packets.
38   // Note that all packets in `packet_list` must be RED payloads, i.e., have
39   // RED headers according to RFC 2198 at the very beginning of the payload.
40   // Returns kOK or an error.
41   virtual bool SplitRed(PacketList* packet_list);
42 
43   // Checks all packets in `packet_list`. Packets that are DTMF events or
44   // comfort noise payloads are kept. Except that, only one single payload type
45   // is accepted. Any packet with another payload type is discarded.
46   virtual void CheckRedPayloads(PacketList* packet_list,
47                                 const DecoderDatabase& decoder_database);
48 };
49 
50 }  // namespace webrtc
51 #endif  // MODULES_AUDIO_CODING_NETEQ_RED_PAYLOAD_SPLITTER_H_
52