rtpconn.h

Go to the documentation of this file.

/*
 * rtpconn.h
 *
 * Connection 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_RTPCONN_H
#define OPAL_OPAL_RTPCONN_H

#ifdef P_USE_PRAGMA
#pragma interface
#endif

#include <opal_config.h>

#include <opal/connection.h>
#include <opal/mediatype.h>
#include <opal/mediasession.h>
#include <rtp/rtp_session.h>
#include <codec/rfc2833.h>
#include <ptlib/bitwise_enum.h>


class OpalRTPEndPoint;


#define OPAL_OPT_DISABLE_NAT  "Disable-NAT"


class OpalRTPConnection : public OpalConnection
{
    PCLASSINFO(OpalRTPConnection, OpalConnection);
  public:
    OpalRTPConnection(
      OpalCall & call,                         
      OpalRTPEndPoint & endpoint,              
      const PString & token,                   
      unsigned options = 0,                    
      OpalConnection::StringOptions * stringOptions = NULL     
    );  

    ~OpalRTPConnection();

    virtual void OnReleased();


    virtual OpalMediaStream * CreateMediaStream(
      const OpalMediaFormat & mediaFormat, 
      unsigned sessionID,                  
      PBoolean isSource                        
    );

    virtual bool GetMediaTransportAddresses(
      OpalConnection & otherConnection,      
      unsigned sessionId,                    
      const OpalMediaType & mediaType,       
      OpalTransportAddressArray & transports 
    ) const;

    virtual void AdjustMediaFormats(
      bool local,                             
      const OpalConnection * otherConnection, 
      OpalMediaFormatList & mediaFormats      
    ) const;

    virtual void OnPatchMediaStream(
      PBoolean isSource,        
      OpalMediaPatch & patch    
    );

    virtual bool OnMediaCommand(
      OpalMediaStream & stream,         
      const OpalMediaCommand & command  
    );

    virtual PBoolean SendUserInputTone(
      char tone,        
      unsigned duration = 0  
    );


    virtual unsigned GetNextSessionID(
      const OpalMediaType & mediaType,   
      bool isSource                      
    );

    virtual OpalMediaCryptoSuite::KeyExchangeModes GetMediaCryptoKeyExchangeModes() const;

    vector<bool> CreateAllMediaSessions();

    virtual OpalMediaSession * CreateMediaSession(
      unsigned sessionId,               
      const OpalMediaType & mediaType,  
      const PString & sessionType = PString::Empty() 
    );

    virtual OpalMediaSession * GetMediaSession(
      unsigned sessionID    
    ) const;

    virtual OpalMediaSession * FindSessionByMediaType(
      const OpalMediaType & mediaType  
    ) const;

    virtual OpalMediaSession * FindSessionByLocalPort(
      WORD port    
    ) const;

    virtual OpalMediaSession * UseMediaSession(
      unsigned sessionId,               
      const OpalMediaType & mediaType,  
      const PString & sessionType = PString::Empty() 
    );

    virtual void ReleaseMediaSession(
      unsigned sessionID    
    );

    virtual bool ChangeSessionID(
      unsigned fromSessionID,   
      unsigned toSessionID      
    );

    virtual void ReplaceMediaSession(
      unsigned sessionId,             
      OpalMediaSession * mediaSession 
    );

#if OPAL_VIDEO

    virtual void AddAudioVideoGroup(
      const PString & id = OpalMediaSession::GetBundleGroupId()
    );

    virtual void SetAudioVideoMediaStreamIDs(OpalRTPSession::Direction direction);
#endif

    virtual bool SetSessionQoS(
      OpalRTPSession * session
    );

    virtual void DetermineRTPNAT(
      const OpalTransport & transport,          
      const OpalTransportAddress & signalAddr   
    );

    typedef PSafeDictionary<PKey<unsigned>, OpalMediaSession> SessionMap;

  protected:
    virtual bool GarbageCollection();
    PDECLARE_NOTIFIER2(OpalRFC2833Info, OpalRTPConnection, OnUserInputInlineRFC2833, OpalRFC2833Proto::NotifyState);

#if OPAL_RTP_FEC
    OpalMediaFormatList NegotiateFECMediaFormats(OpalMediaSession & session);
#endif


    SessionMap m_sessions;
    bool m_remoteBehindNAT;

    OpalRFC2833Proto * m_rfc2833Handler;
#if OPAL_T38_CAPABILITY
    OpalRFC2833Proto * m_ciscoNSEHandler;
#endif

    P_REMOVE_VIRTUAL(PBoolean,IsRTPNATEnabled(const PIPSocket::Address&,const PIPSocket::Address&,const PIPSocket::Address&,PBoolean),false);
};


#endif // OPAL_OPAL_RTPCONN_H