• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * libjingle
3  * Copyright 2012 Google Inc.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions are met:
7  *
8  *  1. Redistributions of source code must retain the above copyright notice,
9  *     this list of conditions and the following disclaimer.
10  *  2. Redistributions in binary form must reproduce the above copyright notice,
11  *     this list of conditions and the following disclaimer in the documentation
12  *     and/or other materials provided with the distribution.
13  *  3. The name of the author may not be used to endorse or promote products
14  *     derived from this software without specific prior written permission.
15  *
16  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
17  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
18  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
19  * EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
20  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
21  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
22  * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
23  * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
24  * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
25  * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26  */
27 
28 #ifndef TALK_MEDIA_BASE_CONSTANTS_H_
29 #define TALK_MEDIA_BASE_CONSTANTS_H_
30 
31 #include <string>
32 
33 // This file contains constants related to media.
34 
35 namespace cricket {
36 
37 extern const int kVideoCodecClockrate;
38 extern const int kDataCodecClockrate;
39 extern const int kDataMaxBandwidth;  // bps
40 
41 // Default CPU thresholds.
42 extern const float kHighSystemCpuThreshold;
43 extern const float kLowSystemCpuThreshold;
44 extern const float kProcessCpuThreshold;
45 
46 extern const char kRtxCodecName[];
47 extern const char kRedCodecName[];
48 extern const char kUlpfecCodecName[];
49 
50 // Codec parameters
51 extern const char kCodecParamAssociatedPayloadType[];
52 
53 extern const char kOpusCodecName[];
54 extern const char kIsacCodecName[];
55 extern const char kL16CodecName[];
56 extern const char kG722CodecName[];
57 extern const char kIlbcCodecName[];
58 extern const char kPcmuCodecName[];
59 extern const char kPcmaCodecName[];
60 extern const char kCnCodecName[];
61 extern const char kDtmfCodecName[];
62 
63 // Attribute parameters
64 extern const char kCodecParamPTime[];
65 extern const char kCodecParamMaxPTime[];
66 // fmtp parameters
67 extern const char kCodecParamMinPTime[];
68 extern const char kCodecParamSPropStereo[];
69 extern const char kCodecParamStereo[];
70 extern const char kCodecParamUseInbandFec[];
71 extern const char kCodecParamUseDtx[];
72 extern const char kCodecParamMaxAverageBitrate[];
73 extern const char kCodecParamMaxPlaybackRate[];
74 extern const char kCodecParamSctpProtocol[];
75 extern const char kCodecParamSctpStreams[];
76 
77 extern const char kParamValueTrue[];
78 // Parameters are stored as parameter/value pairs. For parameters who do not
79 // have a value, |kParamValueEmpty| should be used as value.
80 extern const char kParamValueEmpty[];
81 
82 // opus parameters.
83 // Default value for maxptime according to
84 // http://tools.ietf.org/html/draft-spittka-payload-rtp-opus-03
85 extern const int kOpusDefaultMaxPTime;
86 extern const int kOpusDefaultPTime;
87 extern const int kOpusDefaultMinPTime;
88 extern const int kOpusDefaultSPropStereo;
89 extern const int kOpusDefaultStereo;
90 extern const int kOpusDefaultUseInbandFec;
91 extern const int kOpusDefaultUseDtx;
92 extern const int kOpusDefaultMaxPlaybackRate;
93 
94 // Prefered values in this code base. Note that they may differ from the default
95 // values in http://tools.ietf.org/html/draft-spittka-payload-rtp-opus-03
96 // Only frames larger or equal to 10 ms are currently supported in this code
97 // base.
98 extern const int kPreferredMaxPTime;
99 extern const int kPreferredMinPTime;
100 extern const int kPreferredSPropStereo;
101 extern const int kPreferredStereo;
102 extern const int kPreferredUseInbandFec;
103 
104 // rtcp-fb messages according to RFC 4585
105 extern const char kRtcpFbParamNack[];
106 extern const char kRtcpFbNackParamPli[];
107 // rtcp-fb messages according to
108 // http://tools.ietf.org/html/draft-alvestrand-rmcat-remb-00
109 extern const char kRtcpFbParamRemb[];
110 // rtcp-fb messages according to
111 // https://tools.ietf.org/html/draft-holmer-rmcat-transport-wide-cc-extensions-01
112 extern const char kRtcpFbParamTransportCc[];
113 // ccm submessages according to RFC 5104
114 extern const char kRtcpFbParamCcm[];
115 extern const char kRtcpFbCcmParamFir[];
116 // Google specific parameters
117 extern const char kCodecParamMaxBitrate[];
118 extern const char kCodecParamMinBitrate[];
119 extern const char kCodecParamStartBitrate[];
120 extern const char kCodecParamMaxQuantization[];
121 extern const char kCodecParamPort[];
122 
123 // We put the data codec names here so callers of
124 // DataEngine::CreateChannel don't have to import rtpdataengine.h or
125 // sctpdataengine.h to get the codec names they want to pass in.
126 extern const int kGoogleRtpDataCodecId;
127 extern const char kGoogleRtpDataCodecName[];
128 
129 // TODO(pthatcher): Find an id that won't conflict with anything.  On
130 // the other hand, it really shouldn't matter since the id won't be
131 // used on the wire.
132 extern const int kGoogleSctpDataCodecId;
133 extern const char kGoogleSctpDataCodecName[];
134 
135 extern const char kComfortNoiseCodecName[];
136 
137 // Header extension for audio levels, as defined in
138 // http://tools.ietf.org/html/draft-ietf-avtext-client-to-mixer-audio-level-03
139 extern const int kRtpAudioLevelHeaderExtensionDefaultId;
140 extern const char kRtpAudioLevelHeaderExtension[];
141 
142 // Header extension for RTP timestamp offset, see RFC 5450 for details:
143 // http://tools.ietf.org/html/rfc5450
144 extern const int kRtpTimestampOffsetHeaderExtensionDefaultId;
145 extern const char kRtpTimestampOffsetHeaderExtension[];
146 
147 // Header extension for absolute send time, see url for details:
148 // http://www.webrtc.org/experiments/rtp-hdrext/abs-send-time
149 extern const int kRtpAbsoluteSenderTimeHeaderExtensionDefaultId;
150 extern const char kRtpAbsoluteSenderTimeHeaderExtension[];
151 
152 // Header extension for coordination of video orientation, see url for details:
153 // http://www.etsi.org/deliver/etsi_ts/126100_126199/126114/12.07.00_60/
154 // ts_126114v120700p.pdf
155 extern const int kRtpVideoRotationHeaderExtensionDefaultId;
156 extern const char kRtpVideoRotationHeaderExtension[];
157 // We don't support 6 bit CVO. Added here for testing purpose.
158 extern const char kRtpVideoRotation6BitsHeaderExtensionForTesting[];
159 
160 // Header extension for transport sequence number, see url for details:
161 // http://www.ietf.org/id/draft-holmer-rmcat-transport-wide-cc-extensions
162 extern const int kRtpTransportSequenceNumberHeaderExtensionDefaultId;
163 extern const char kRtpTransportSequenceNumberHeaderExtension[];
164 
165 extern const int kNumDefaultUnsignalledVideoRecvStreams;
166 
167 extern const char kVp8CodecName[];
168 extern const char kVp9CodecName[];
169 extern const char kH264CodecName[];
170 
171 extern const int kDefaultVp8PlType;
172 extern const int kDefaultVp9PlType;
173 extern const int kDefaultH264PlType;
174 extern const int kDefaultRedPlType;
175 extern const int kDefaultUlpfecType;
176 extern const int kDefaultRtxVp8PlType;
177 
178 extern const int kDefaultVideoMaxWidth;
179 extern const int kDefaultVideoMaxHeight;
180 extern const int kDefaultVideoMaxFramerate;
181 }  // namespace cricket
182 
183 #endif  // TALK_MEDIA_BASE_CONSTANTS_H_
184 
185