CpMediaInterfaceFactory.h

Go to the documentation of this file.

//
// Copyright (C) 2005-2021 SIPez LLC.
// Licensed to SIPfoundry under a Contributor Agreement.
// 
// Copyright (C) 2004-2008 SIPfoundry Inc.
// Licensed by SIPfoundry under the LGPL license.
//
// Copyright (C) 2004-2006 Pingtel Corp.  All rights reserved.
// Licensed to SIPfoundry under a Contributor Agreement.
//
// $$


#ifndef _CpMediaInterfaceFactory_h_
#define _CpMediaInterfaceFactory_h_

// SYSTEM INCLUDES
// APPLICATION INCLUDES
#include <os/OsStatus.h>
#include <utl/UtlDefs.h>
#include <utl/UtlString.h>

// DEFINES
// MACROS
// EXTERNAL FUNCTIONS
// EXTERNAL VARIABLES
// CONSTANTS
// STRUCTS
// TYPEDEFS
// FORWARD DECLARATIONS
class CpMediaInterfaceFactoryImpl ;
class CpMediaInterface ;
class SdpCodec ;
class OsMsgDispatcher ;

class CpMediaInterfaceFactory
{
/* //////////////////////////// PUBLIC //////////////////////////////////// */
public:

/* ============================ CREATORS ================================== */

   CpMediaInterfaceFactory();
     

   virtual ~CpMediaInterfaceFactory();

   static int (*sGetInputDeviceListFunction)(UtlContainer&);
   static int (*sGetOutputDeviceListFunction)(UtlContainer&);

/* ============================ MANIPULATORS ============================== */

   void setFactoryImplementation(CpMediaInterfaceFactoryImpl* pFactoryInterface) ;


   CpMediaInterface* createMediaInterface(const char* publicAddress,
                                          const char* localAddress,
                                          int numCodecs,
                                          SdpCodec* sdpCodecArray[],
                                          const char* locale,
                                          int expeditedIpTos,
                                          const char* szStunServer,
                                          int iStunPort,
                                          int iStunKeepAlivePeriodSecs,
                                          const char* szTurnServer,
                                          int iTurnPort,
                                          const char* szTurnUsername,
                                          const char* szTurnPassword,
                                          int iTurnKeepAlivePeriodSecs,
                                          UtlBoolean bEnableICE,
                                          uint32_t samplesPerSec = 0, 
                                          OsMsgDispatcher* pDispatcher = NULL
                                         );

   void setDispatcher(OsMsgDispatcher* dispatcher);

   static OsStatus addCodecPaths(const size_t nCodecPaths, const UtlString codecPaths[]);
   static void clearCodecPaths();


/* ============================ ACCESSORS ================================= */

   CpMediaInterfaceFactoryImpl* getFactoryImplementation() ;

   static int getInputDeviceList(UtlContainer& deviceNames);
   
   static int getOutputDeviceList(UtlContainer& deviceNames);

/* ============================ INQUIRY =================================== */

/* //////////////////////////// PROTECTED ///////////////////////////////// */
protected:
   CpMediaInterfaceFactoryImpl* mpFactoryImpl ; 

/* //////////////////////////// PRIVATE /////////////////////////////////// */
private:

   CpMediaInterfaceFactory& operator=(const CpMediaInterfaceFactory& rhs);  

   CpMediaInterfaceFactory(const CpMediaInterfaceFactory& rCpMediaInterfaceFactory);     
};

/* ============================ INLINE METHODS ============================ */

#endif  // _CpMediaInterfaceFactory_h_