SdpAttributes.hxx
上传用户:sy_wanhua
上传日期:2013-07-25
资源大小:3048k
文件大小:8k
源码类别:

流媒体/Mpeg4/MP4

开发平台:

C/C++

  1. #ifndef _SDPATTRIBUTES_H
  2. #define _SDPATTRIBUTES_H
  3. /* ====================================================================
  4.  * The Vovida Software License, Version 1.0 
  5.  * 
  6.  * Copyright (c) 2000 Vovida Networks, Inc.  All rights reserved.
  7.  * 
  8.  * Redistribution and use in source and binary forms, with or without
  9.  * modification, are permitted provided that the following conditions
  10.  * are met:
  11.  * 
  12.  * 1. Redistributions of source code must retain the above copyright
  13.  *    notice, this list of conditions and the following disclaimer.
  14.  * 
  15.  * 2. Redistributions in binary form must reproduce the above copyright
  16.  *    notice, this list of conditions and the following disclaimer in
  17.  *    the documentation and/or other materials provided with the
  18.  *    distribution.
  19.  * 
  20.  * 3. The names "VOCAL", "Vovida Open Communication Application Library",
  21.  *    and "Vovida Open Communication Application Library (VOCAL)" must
  22.  *    not be used to endorse or promote products derived from this
  23.  *    software without prior written permission. For written
  24.  *    permission, please contact vocal@vovida.org.
  25.  *
  26.  * 4. Products derived from this software may not be called "VOCAL", nor
  27.  *    may "VOCAL" appear in their name, without prior written
  28.  *    permission of Vovida Networks, Inc.
  29.  * 
  30.  * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED
  31.  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  32.  * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND
  33.  * NON-INFRINGEMENT ARE DISCLAIMED.  IN NO EVENT SHALL VOVIDA
  34.  * NETWORKS, INC. OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT DAMAGES
  35.  * IN EXCESS OF $1,000, NOR FOR ANY INDIRECT, INCIDENTAL, SPECIAL,
  36.  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  37.  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  38.  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
  39.  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  40.  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
  41.  * USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
  42.  * DAMAGE.
  43.  * 
  44.  * ====================================================================
  45.  * 
  46.  * This software consists of voluntary contributions made by Vovida
  47.  * Networks, Inc. and many individuals on behalf of Vovida Networks,
  48.  * Inc.  For more information on Vovida Networks, Inc., please see
  49.  * <http://www.vovida.org/>.
  50.  *
  51.  */
  52. static const char* const SdpAttributesVersion =
  53.     "$Id: SdpAttributes.hxx,v 1.14 2001/06/18 23:52:31 chok Exp $";
  54. #include <vector>
  55. #include <string>
  56. #include <strstream>
  57. //#include <assert.h>
  58. #include <cassert>
  59. #include "SdpExterns.hxx"
  60. #include "cpLog.h"
  61. /**
  62.  *  TERMINOLOGY   (for more detailed description, please read RFC 2327)
  63.  *
  64.  * Session Block : lines between "v=" line and "m=" line, "m=" line
  65.  *     not included
  66.  * Media Block : lines between two "m=" lines, the second "m+' line 
  67.  *     not included
  68.  * Session Attribute: attributes specified in the session block
  69.  * Media Attribute: attribute specified in the media block
  70.  * Property attribute : "a=" line in the form of "a=<attribute>"
  71.  * Value attribute : "a=" line in the form of "a=<attribute>:<value>"
  72.  * RTP Map Attribute : a type of media value attribute in the form of
  73.  * "a=rtpmap : <payload type> <encoding name> / <clock rate> [/<encodeing parameters>]"
  74.  *
  75.  *                      ********************                               
  76.  *
  77.  *  Several attribute classes defined. Here is an attemp to explain:
  78.  *
  79.  * SdpAttributes : this is the basic attribute class
  80.  * 1) Both Session & Media property attributes use this class.
  81.  * 2) This class also served as base class of Media attribute,
  82.  *
  83.  * MediaAttributes : 
  84.  * 1) Used as a container for attributes in one media block, 
  85.  * i.e. lines after "m=" line and before next "m=" line
  86.  * 2) Hence this class is contained in the SdpMedia class.
  87.  *
  88.  * SdpRtpMapAttribute :
  89.  * 1) A special class for RTP Map Attribute because the format
  90.  * is different than others.
  91.  * 2) Hence this class is contained in the MediaAttributes class.
  92.  */
  93. /** A single value attribute
  94.  *   a=<attribute>:<value>
  95.  */
  96. class ValueAttribute
  97. {
  98.     public:
  99.         ///
  100.         ValueAttribute();
  101.         ///
  102.         char* getAttribute();
  103.         ///
  104.         char* getValue();
  105.         ///
  106.         void setAttribute(const char* attrib);
  107.         ///
  108.         void setValue(const char* val);
  109.         ///
  110.         void encode (ostrstream& s);
  111.     private:
  112.         char attribute[256];
  113.         char value[256];
  114. };
  115. /** Attributes that are common to Session and Media
  116.     a=<attribute>
  117.     a=<attribute>:<value>
  118.     EXCEPT:
  119.     a=rtpmap:...
  120.  */
  121. class SdpAttributes
  122. {
  123.     public:
  124.         ///
  125.         SdpAttributes();
  126.         ///
  127.         SdpAttributes(const SdpAttributes& attr);
  128.         ///
  129.         ~SdpAttributes()
  130.         { //delete attribvalue
  131.             if (valueAttributes.size() > 0)
  132.             {
  133.                 flushValueAttributes();
  134.             }
  135.         }
  136.         ///
  137.         const SdpAttributes& operator=(SdpAttributes& attrib);
  138.         ///
  139.         void setAttribute(string& str);
  140.         ///
  141.         void setrecvonly();
  142.         ///
  143.         void setsendrecv();
  144.         ///
  145.         void setsendonly();
  146.         ///
  147.         bool getrecvonly();
  148.         ///
  149.         bool getsendrecv();
  150.         ///
  151.         bool getsendonly();
  152.         ///
  153.         void addValueAttribute (ValueAttribute* newValueAttribute)
  154.         {
  155.             valueAttributes.push_back(newValueAttribute);
  156.         }
  157.         ///
  158.         vector < ValueAttribute* > * getValueAttributes()
  159.         {
  160.             return &valueAttributes;
  161.         }
  162.         ///
  163.         void flushValueAttributes();
  164.         /// Check if this is auser defined attribute
  165.         bool isUserDefined(const char* str);
  166.         ///
  167.         void encode (ostrstream& s);
  168.     private:
  169.         bool recvonly;
  170.         bool sendonly;
  171.         bool sendrecv;
  172. void copyValueAttributes(const SdpAttributes& attrib);
  173.         /// Value attributes
  174.         vector < ValueAttribute* > valueAttributes;
  175. };
  176. const int encodingNameLen = 256;
  177. /** rtpmap media attribute
  178.  * a=rtpmap : <payload type> <encoding name> / <clock rate> [/<encodeing parameters>]
  179.  */
  180. class SdpRtpMapAttribute
  181. {
  182.     public:
  183.         ///
  184.         SdpRtpMapAttribute();
  185.         ///
  186.         void setPayloadType(int payload);
  187.         ///
  188.         int getPayloadType();
  189.         ///
  190.         void setEncodingName(const char* name);
  191.         ///
  192.         char* getEncodingName();
  193.         ///
  194.         void setClockRate(int rate);
  195.         ///
  196.         int getClockRate();
  197.         ///
  198.         void setEncodingParms(int parms);
  199.         ///
  200.         int getEncodingParms();
  201.         ///
  202.         void encode (ostrstream& s);
  203.     private:
  204.         int payloadType;
  205.         char encodingName[encodingNameLen];
  206.         int clockrate;
  207.         /// Number of channels for audio streams
  208.         int encodingParms;
  209. };
  210. /** Media attributes: SdpAttributes class plus SdpRtpMapAttribute class
  211.  */
  212. class MediaAttributes : public SdpAttributes
  213. {
  214.     public:
  215.         ///
  216.         MediaAttributes()
  217.         {
  218.             rtpmap.clear();
  219.         }
  220.         void setAttribute(string& attrib);
  221.         ///
  222.         void addmap(SdpRtpMapAttribute* rtpattrib)
  223.         {
  224.             rtpmap.push_back(rtpattrib);
  225.         }
  226.         ///
  227.         vector < SdpRtpMapAttribute* > * getmap()
  228.         {
  229.             return &rtpmap;
  230.         }
  231.         ///
  232.         MediaAttributes& operator=(MediaAttributes& attrib);
  233.         ///
  234.         ~MediaAttributes()
  235.         {
  236.             if (rtpmap.size() > 0)
  237.             {
  238.                 flushrtpmap();
  239.             }
  240.         }
  241.         ///
  242.         void flushrtpmap();
  243.         ///
  244.         void encode (ostrstream& s);
  245.     private:
  246. /// disable copy constructor
  247. MediaAttributes(const MediaAttributes&);
  248.         vector < SdpRtpMapAttribute* > rtpmap;
  249. };
  250. #endif