summaryrefslogtreecommitdiffstats
path: root/chromium/third_party/webrtc/modules/audio_coding/neteq/decoder_database.h
diff options
context:
space:
mode:
Diffstat (limited to 'chromium/third_party/webrtc/modules/audio_coding/neteq/decoder_database.h')
-rw-r--r--chromium/third_party/webrtc/modules/audio_coding/neteq/decoder_database.h158
1 files changed, 158 insertions, 0 deletions
diff --git a/chromium/third_party/webrtc/modules/audio_coding/neteq/decoder_database.h b/chromium/third_party/webrtc/modules/audio_coding/neteq/decoder_database.h
new file mode 100644
index 00000000000..8a03f2123be
--- /dev/null
+++ b/chromium/third_party/webrtc/modules/audio_coding/neteq/decoder_database.h
@@ -0,0 +1,158 @@
+/*
+ * Copyright (c) 2012 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_AUDIO_CODING_NETEQ_DECODER_DATABASE_H_
+#define WEBRTC_MODULES_AUDIO_CODING_NETEQ_DECODER_DATABASE_H_
+
+#include <map>
+
+#include "webrtc/base/constructormagic.h"
+#include "webrtc/common_types.h" // NULL
+#include "webrtc/modules/audio_coding/neteq/interface/audio_decoder.h"
+#include "webrtc/modules/audio_coding/neteq/packet.h"
+#include "webrtc/typedefs.h"
+
+namespace webrtc {
+
+// Forward declaration.
+class AudioDecoder;
+
+class DecoderDatabase {
+ public:
+ enum DatabaseReturnCodes {
+ kOK = 0,
+ kInvalidRtpPayloadType = -1,
+ kCodecNotSupported = -2,
+ kInvalidSampleRate = -3,
+ kDecoderExists = -4,
+ kDecoderNotFound = -5,
+ kInvalidPointer = -6
+ };
+
+ // Struct used to store decoder info in the database.
+ struct DecoderInfo {
+ // Constructors.
+ DecoderInfo()
+ : codec_type(kDecoderArbitrary),
+ fs_hz(8000),
+ decoder(NULL),
+ external(false) {
+ }
+ DecoderInfo(NetEqDecoder ct, int fs, AudioDecoder* dec, bool ext)
+ : codec_type(ct),
+ fs_hz(fs),
+ decoder(dec),
+ external(ext) {
+ }
+ // Destructor. (Defined in decoder_database.cc.)
+ ~DecoderInfo();
+
+ NetEqDecoder codec_type;
+ int fs_hz;
+ AudioDecoder* decoder;
+ bool external;
+ };
+
+ static const uint8_t kMaxRtpPayloadType = 0x7F; // Max for a 7-bit number.
+ // Maximum value for 8 bits, and an invalid RTP payload type (since it is
+ // only 7 bits).
+ static const uint8_t kRtpPayloadTypeError = 0xFF;
+
+ DecoderDatabase();
+
+ virtual ~DecoderDatabase();
+
+ // Returns true if the database is empty.
+ virtual bool Empty() const;
+
+ // Returns the number of decoders registered in the database.
+ virtual int Size() const;
+
+ // Resets the database, erasing all registered payload types, and deleting
+ // any AudioDecoder objects that were not externally created and inserted
+ // using InsertExternal().
+ virtual void Reset();
+
+ // Registers |rtp_payload_type| as a decoder of type |codec_type|. Returns
+ // kOK on success; otherwise an error code.
+ virtual int RegisterPayload(uint8_t rtp_payload_type,
+ NetEqDecoder codec_type);
+
+ // Registers an externally created AudioDecoder object, and associates it
+ // as a decoder of type |codec_type| with |rtp_payload_type|.
+ virtual int InsertExternal(uint8_t rtp_payload_type,
+ NetEqDecoder codec_type,
+ int fs_hz, AudioDecoder* decoder);
+
+ // Removes the entry for |rtp_payload_type| from the database.
+ // Returns kDecoderNotFound or kOK depending on the outcome of the operation.
+ virtual int Remove(uint8_t rtp_payload_type);
+
+ // Returns a pointer to the DecoderInfo struct for |rtp_payload_type|. If
+ // no decoder is registered with that |rtp_payload_type|, NULL is returned.
+ virtual const DecoderInfo* GetDecoderInfo(uint8_t rtp_payload_type) const;
+
+ // Returns one RTP payload type associated with |codec_type|, or
+ // kDecoderNotFound if no entry exists for that value. Note that one
+ // |codec_type| may be registered with several RTP payload types, and the
+ // method may return any of them.
+ virtual uint8_t GetRtpPayloadType(NetEqDecoder codec_type) const;
+
+ // Returns a pointer to the AudioDecoder object associated with
+ // |rtp_payload_type|, or NULL if none is registered. If the AudioDecoder
+ // object does not exist for that decoder, the object is created.
+ virtual AudioDecoder* GetDecoder(uint8_t rtp_payload_type);
+
+ // Returns true if |rtp_payload_type| is registered as a |codec_type|.
+ virtual bool IsType(uint8_t rtp_payload_type,
+ NetEqDecoder codec_type) const;
+
+ // Returns true if |rtp_payload_type| is registered as comfort noise.
+ virtual bool IsComfortNoise(uint8_t rtp_payload_type) const;
+
+ // Returns true if |rtp_payload_type| is registered as DTMF.
+ virtual bool IsDtmf(uint8_t rtp_payload_type) const;
+
+ // Returns true if |rtp_payload_type| is registered as RED.
+ virtual bool IsRed(uint8_t rtp_payload_type) const;
+
+ // Sets the active decoder to be |rtp_payload_type|. If this call results in a
+ // change of active decoder, |new_decoder| is set to true. The previous active
+ // decoder's AudioDecoder object is deleted.
+ virtual int SetActiveDecoder(uint8_t rtp_payload_type, bool* new_decoder);
+
+ // Returns the current active decoder, or NULL if no active decoder exists.
+ virtual AudioDecoder* GetActiveDecoder();
+
+ // Sets the active comfort noise decoder to be |rtp_payload_type|. If this
+ // call results in a change of active comfort noise decoder, the previous
+ // active decoder's AudioDecoder object is deleted.
+ virtual int SetActiveCngDecoder(uint8_t rtp_payload_type);
+
+ // Returns the current active comfort noise decoder, or NULL if no active
+ // comfort noise decoder exists.
+ virtual AudioDecoder* GetActiveCngDecoder();
+
+ // Returns kOK if all packets in |packet_list| carry payload types that are
+ // registered in the database. Otherwise, returns kDecoderNotFound.
+ virtual int CheckPayloadTypes(const PacketList& packet_list) const;
+
+ private:
+ typedef std::map<uint8_t, DecoderInfo> DecoderMap;
+
+ DecoderMap decoders_;
+ int active_decoder_;
+ int active_cng_decoder_;
+
+ DISALLOW_COPY_AND_ASSIGN(DecoderDatabase);
+};
+
+} // namespace webrtc
+#endif // WEBRTC_MODULES_AUDIO_CODING_NETEQ_DECODER_DATABASE_H_