Home | History | Annotate | Download | only in base
      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