rtpep.h

Go to the documentation of this file.

/*
 * Endpoint abstraction
 *
 * Open Phone Abstraction Library (OPAL)
 *
 * Copyright (C) 2007 Post Increment
 *
 * The contents of this file are subject to the Mozilla Public License
 * Version 1.0 (the "License"); you may not use this file except in
 * compliance with the License. You may obtain a copy of the License at
 * http://www.mozilla.org/MPL/
 *
 * Software distributed under the License is distributed on an "AS IS"
 * basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
 * the License for the specific language governing rights and limitations
 * under the License.
 *
 * The Original Code is Open Phone Abstraction Library.
 *
 * The Initial Developer of the Original Code is Post Increment
 *
 * Contributor(s): ______________________________________.
 */

#ifndef OPAL_OPAL_RTPEP_H
#define OPAL_OPAL_RTPEP_H

#ifdef P_USE_PRAGMA
#pragma interface
#endif

#include <opal_config.h>

#include <opal/endpoint.h>


class OpalRTPMediaStream;


#if OPAL_RTP_FEC
namespace OpalFEC
{
  const OpalMediaType & MediaType();

  // RFC 2193 media format "place holders"
  #define OPAL_REDUNDANT_PREFIX  "Redundant"
  #define OPAL_REDUNDANT_AUDIO   OPAL_REDUNDANT_PREFIX"-Audio"
  #define OpalRedundantAudio     OpalFEC::RedundantAudio()
  extern const OpalMediaFormat & RedundantAudio();

#if OPAL_VIDEO
  #define OPAL_REDUNDANT_VIDEO   OPAL_REDUNDANT_PREFIX"-Video"
  #define OpalRedundantVideo     OpalFEC::RedundantVideo()
  extern const OpalMediaFormat & RedundantVideo();
#endif

  // RFC 5109 media format "place holders"
  #define OPAL_ULP_FEC_PREFIX    "ULP-FEC"
  #define OPAL_ULP_FEC_AUDIO     OPAL_ULP_FEC_PREFIX"-Audio"
  #define OpalUlpFecAudio        OpalFEC::UlpFecAudio()
  extern const OpalMediaFormat & UlpFecAudio();

#if OPAL_VIDEO
  #define OPAL_ULP_FEC_VIDEO     OPAL_ULP_FEC_PREFIX"-Video"
  #define OpalUlpFecVideo        OpalFEC::UlpFecVideo()
  extern const OpalMediaFormat & UlpFecVideo();
#endif

  const PString & MediaTypeOption();
};
#endif // OPAL_RTP_FEC


class OpalRTPEndPoint : public OpalEndPoint
{
  PCLASSINFO(OpalRTPEndPoint, OpalEndPoint);

    OpalRTPEndPoint(
      OpalManager & manager,          
      const PCaselessString & prefix, 
      Attributes attributes           
    );

    ~OpalRTPEndPoint();

    virtual PStringList GetAvailableStringOptions() const;

    virtual void OnReleased(
      OpalConnection & connection   
    );

    virtual OpalMediaFormatList GetMediaFormats() const;

    virtual void OnClosedMediaStream(
      const OpalMediaStream & stream     
    );

    virtual PBoolean IsRTPNATEnabled(
      OpalConnection & connection,            
      const PIPSocket::Address & localAddr,   
      const PIPSocket::Address & peerAddr,    
      const PIPSocket::Address & signalAddr,  
      PBoolean incoming                       
    );

    virtual bool OnLocalRTP(
      OpalConnection & connection1, 
      OpalConnection & connection2, 
      unsigned sessionID,           
      bool opened                   
    ) const;

    // Check for local RTP connection. Internal function.
    bool CheckForLocalRTP(const OpalRTPMediaStream & stream);

    // Check for local RTP connection. Internal function.
    void CheckEndLocalRTP(OpalConnection & connection, OpalRTPSession * rtp);

    // Check for local RTP connection. Internal function.
    void RegisterLocalRTP(OpalRTPSession * rtp, bool removed);

  protected:
    struct LocalRtpInfo {
      LocalRtpInfo(OpalConnection & connection) : m_connection(connection), m_previousResult(-1) { }

      OpalConnection & m_connection;
      int              m_previousResult;
    };
    typedef std::map<OpalTransportAddress, LocalRtpInfo> LocalRtpInfoMap;
    LocalRtpInfoMap m_connectionsByRtpLocalAddr;
    PDECLARE_MUTEX(m_connectionsByRtpMutex);
};


#endif // OPAL_OPAL_RTPEP_H