OLD | NEW |
| (Empty) |
1 /* | |
2 * Copyright (c) 2016 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 WEBRTC_MODULES_AUDIO_CODING_CODECS_AUDIO_FORMAT_H_ | |
12 #define WEBRTC_MODULES_AUDIO_CODING_CODECS_AUDIO_FORMAT_H_ | |
13 | |
14 #include <map> | |
15 #include <ostream> | |
16 #include <string> | |
17 #include <utility> | |
18 | |
19 namespace webrtc { | |
20 | |
21 // SDP specification for a single audio codec. | |
22 // NOTE: This class is still under development and may change without notice. | |
23 struct SdpAudioFormat { | |
24 using Parameters = std::map<std::string, std::string>; | |
25 | |
26 SdpAudioFormat(const SdpAudioFormat&); | |
27 SdpAudioFormat(SdpAudioFormat&&); | |
28 SdpAudioFormat(const char* name, int clockrate_hz, int num_channels); | |
29 SdpAudioFormat(const std::string& name, int clockrate_hz, int num_channels); | |
30 SdpAudioFormat(const char* name, | |
31 int clockrate_hz, | |
32 int num_channels, | |
33 const Parameters& param); | |
34 SdpAudioFormat(const std::string& name, | |
35 int clockrate_hz, | |
36 int num_channels, | |
37 const Parameters& param); | |
38 ~SdpAudioFormat(); | |
39 | |
40 SdpAudioFormat& operator=(const SdpAudioFormat&); | |
41 SdpAudioFormat& operator=(SdpAudioFormat&&); | |
42 | |
43 friend bool operator==(const SdpAudioFormat& a, const SdpAudioFormat& b); | |
44 friend bool operator!=(const SdpAudioFormat& a, const SdpAudioFormat& b) { | |
45 return !(a == b); | |
46 } | |
47 | |
48 std::string name; | |
49 int clockrate_hz; | |
50 int num_channels; | |
51 Parameters parameters; | |
52 }; | |
53 | |
54 void swap(SdpAudioFormat& a, SdpAudioFormat& b); | |
55 std::ostream& operator<<(std::ostream& os, const SdpAudioFormat& saf); | |
56 | |
57 // To avoid API breakage, and make the code clearer, AudioCodecSpec should not | |
58 // be directly initializable with any flags indicating optional support. If it | |
59 // were, these initializers would break any time a new flag was added. It's also | |
60 // more difficult to understand: | |
61 // AudioCodecSpec spec{{"format", 8000, 1}, true, false, false, true, true}; | |
62 // than | |
63 // AudioCodecSpec spec({"format", 8000, 1}); | |
64 // spec.allow_comfort_noise = true; | |
65 // spec.future_flag_b = true; | |
66 // spec.future_flag_c = true; | |
67 struct AudioCodecSpec { | |
68 explicit AudioCodecSpec(const SdpAudioFormat& format); | |
69 explicit AudioCodecSpec(SdpAudioFormat&& format); | |
70 ~AudioCodecSpec() = default; | |
71 | |
72 SdpAudioFormat format; | |
73 bool allow_comfort_noise = true; // This codec can be used with an external | |
74 // comfort noise generator. | |
75 bool supports_network_adaption = false; // This codec can adapt to varying | |
76 // network conditions. | |
77 }; | |
78 | |
79 } // namespace webrtc | |
80 | |
81 #endif // WEBRTC_MODULES_AUDIO_CODING_CODECS_AUDIO_FORMAT_H_ | |
OLD | NEW |