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

流媒体/Mpeg4/MP4

开发平台:

C/C++

  1. #ifndef RTCPTRANSMITTER_HXX
  2. #define RTCPTRANSMITTER_HXX
  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 RtcpTransmitter_hxx_Version =
  53.     "$Id: RtcpTransmitter.hxx,v 1.12 2001/03/12 20:55:07 jliou Exp $";
  54. #include "Rtcp.hxx"
  55. #include <sys/types.h>
  56. #include "rtpTypes.h"
  57. #include "UdpStack.hxx"
  58. #include "NetworkAddress.h"
  59. class RtcpReceiver;
  60. class RtcpPacket;
  61. ///Class to transmit RTCP packets
  62. class RtcpTransmitter
  63. {
  64.     public:
  65.         /** Constructor creating outgoing RTCP stack using port ranges
  66.             @param remoteHost DNS name receiving the packets
  67.             @param port associated port
  68.          **/
  69.         RtcpTransmitter (const char* remoteHost, int remoteMinPort,
  70.                          int remoteMaxPort, RtcpReceiver* receiver);
  71.         /** Constructor creating outgoing RTCP stack using specified port
  72.             @param remoteHost DNS name receiving the packets
  73.             @param port associated port
  74.          **/
  75.         RtcpTransmitter (const char* remoteHost, int remotePort,
  76.                          RtcpReceiver* receiver);
  77.         /// consturctor init (don't call this function)
  78.         void constructRtcpTransmitter ();
  79.         /// Deconstructor
  80.         ~RtcpTransmitter ();
  81.         /** Transmits RTCP packet to remoteHost/port.
  82.             Doesn't remove packet from memory.
  83.             Returns -1 failure or number of bytes sent on success
  84.          **/
  85.         int transmit (RtcpPacket* packet);
  86.         /// set timer to next interval
  87.         void updateInterval ();
  88.         /// Check if time to send RTCP packet.  Returns 1 then time up
  89.         int checkInterval ();
  90.         /// Adds SR packet into compound packet
  91.         int addSR (RtcpPacket* packet, int npadSize = 0);
  92.         /// Adds specificed SDES item to compound packet
  93.         int addSDES (RtcpPacket* packet, RtcpSDESType item, int npadSize = 0);
  94.         /// Adds all known SDES items to compound packet
  95.         int addSDES (RtcpPacket* packet, int npadSize = 0);
  96.         /// Adds specificed SDES items in SDESlist, which ends with RTCP_SDES_END
  97.         int addSDES (RtcpPacket* packet, RtcpSDESType* SDESlist, int npadSize = 0);
  98.         /** Adds BYE packet using transmitter's SRC numbers
  99.             @param reason optional text, null-term
  100.          **/
  101.         int addBYE (RtcpPacket* packet, char* reason = NULL, int npadSize = 0);
  102.         /** Adds BYE packet using specified list of SRC numbers
  103.             @param reason optional text, null-term
  104.             @param count number of items in list
  105.          **/
  106.         int addBYE (RtcpPacket* packet, RtpSrc* list, int count,
  107.                     char* reason = NULL, int npadSize = 0);
  108.         /// future: not implemented
  109.         int addAPP (RtcpPacket* packet, int newpadbyeSize = 0);
  110.         /// Used for calculating RR information
  111.         u_int32_t calcLostFrac (RtpTranInfo* source);
  112.         /// Used for calculating RR information
  113.         u_int32_t calcLostCount (RtpTranInfo* source);
  114.         ///
  115.         void setSdesCname ();
  116.         ///
  117.         void setSdesName (char* text);
  118.         ///
  119.         void setSdesEmail (char* text);
  120.         ///
  121.         void setSdesPhone (char* text);
  122.         ///
  123.         void setSdesLoc (char* text);
  124.         ///
  125.         void setSdesTool (char* text);
  126.         ///
  127.         void setSdesNote (char* text);
  128.         ///
  129.         char* getSdesCname ();
  130.         ///
  131.         char* getSdesName ();
  132.         ///
  133.         char* getSdesEmail ();
  134.         ///
  135.         char* getSdesPhone ();
  136.         ///
  137.         char* getSdesLoc ();
  138.         ///
  139.         char* getSdesTool ();
  140.         ///
  141.         char* getSdesNote ();
  142.         /// Sets RTP transmitter if one is used
  143.         void setRTPtran (RtpTransmitter* tran);
  144.         /// Sets RTCP transmitter if one is used
  145.         void setRTPrecv (RtpReceiver* recv);
  146.         /// Sets RTCP receiver if one is used
  147.         void setRTCPrecv (RtcpReceiver* rtcpRecv);
  148.         /// Port this tramsitter is sending it singal
  149.         int getPort ();
  150.         /// Socket File Descriptor used for select()
  151.         int getSocketFD ();
  152.         /// get the ptr of my UdpStack
  153.         UdpStack* getUdpStack()
  154.         {
  155.             return myStack;
  156.         }
  157.         ///
  158.         NetworkAddress* getRemoteAddr ()
  159.         {
  160.             return &remoteAddr;
  161.         }
  162.         ///
  163.         void setRemoteAddr (const NetworkAddress& theAddr) ;
  164.     private:
  165.         /// Next time to submit RTCP packet
  166.         NtpTime nextInterval;
  167.         /// Transmission interval in ms
  168.         static const int RTCP_INTERVAL = 5000;
  169.         /** Transmitter SDES information
  170.          *  data stored as null-term strings
  171.          **/
  172.         SDESdata* SDESInfo;
  173.         ///
  174.         RtpTransmitter* tran;
  175.         ///
  176.         RtpReceiver* recv;
  177.         ///
  178.         RtcpReceiver* rtcpRecv;
  179.         /// my UDP stack
  180.         UdpStack* myStack;
  181.         ///
  182.         bool freeStack;
  183.         NetworkAddress remoteAddr;
  184. };
  185. #endif // RTCPTRANSMITTER_HXX