pcss.h

Go to the documentation of this file.

/*
 * pcss.h
 *
 * PC Sound System support.
 *
 * Open Phone Abstraction Library (OPAL)
 * Formally known as the Open H323 project.
 *
 * Copyright (c) 2001 Equivalence Pty. Ltd.
 *
 * 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 Equivalence Pty. Ltd.
 *
 * Contributor(s): ______________________________________.
 *
 * $Revision: 31065 $
 * $Author: rjongbloed $
 * $Date: 2013-12-11 17:08:05 +1100 (Wed, 11 Dec 2013) $
 */

#ifndef OPAL_OPAL_PCSS_H
#define OPAL_OPAL_PCSS_H

#ifdef P_USE_PRAGMA
#pragma interface
#endif


#include <opal/buildopts.h>

#if OPAL_HAS_PCSS

#include <ptlib/sound.h>
#include <ep/localep.h>


class OpalPCSSConnection;

#define OPAL_PCSS_PREFIX "pc"


class OpalPCSSEndPoint : public OpalLocalEndPoint
{
    PCLASSINFO(OpalPCSSEndPoint, OpalLocalEndPoint);
  public:
    OpalPCSSEndPoint(
      OpalManager & manager,  
      const char * prefix = OPAL_PCSS_PREFIX 
    );

    ~OpalPCSSEndPoint();

    virtual PSafePtr<OpalConnection> MakeConnection(
      OpalCall & call,           
      const PString & party,     
      void * userData = NULL,    
      unsigned options = 0,                    
      OpalConnection::StringOptions * stringOptions = NULL 
    );

    virtual bool OnOutgoingCall(
      const OpalLocalConnection & connection 
    );

    virtual bool OnIncomingCall(
      OpalLocalConnection & connection 
    );

    virtual bool OnUserInput(
      const OpalLocalConnection & connection, 
      const PString & indication              
    );

    virtual OpalPCSSConnection * CreateConnection(
      OpalCall & call,    
      const PString & playDevice, 
      const PString & recordDevice, 
      void * userData,    
      unsigned options,                    
      OpalConnection::StringOptions * stringOptions 
    );

    virtual PSoundChannel * CreateSoundChannel(
      const OpalPCSSConnection & connection, 
      const OpalMediaFormat & mediaFormat,   
      PBoolean isSource                          
    );

    PSafePtr<OpalPCSSConnection> GetPCSSConnectionWithLock(
      const PString & token,     
      PSafetyMode mode = PSafeReadWrite 
    ) { return GetConnectionWithLockAs<OpalPCSSConnection>(token, mode); }

    virtual PBoolean OnShowIncoming(
      const OpalPCSSConnection & connection 
    ) = 0;

    virtual PBoolean AcceptIncomingConnection(
      const PString & connectionToken 
    );

    virtual PBoolean RejectIncomingConnection(
      const PString & connectionToken,       
      const OpalConnection::CallEndReason & reason = OpalConnection::EndedByAnswerDenied 
    );

    virtual PBoolean OnShowOutgoing(
      const OpalPCSSConnection & connection 
    ) = 0;

    virtual PBoolean OnShowUserInput(
      const OpalPCSSConnection & connection, 
      const PString & indication             
    );

    virtual PBoolean SetSoundChannelPlayDevice(const PString & name);

    const PString & GetSoundChannelPlayDevice() const { return soundChannelPlayDevice; }

    virtual PBoolean SetSoundChannelRecordDevice(const PString & name);

    const PString & GetSoundChannelRecordDevice() const { return soundChannelRecordDevice; }

    unsigned GetSoundChannelBufferDepth() const { return soundChannelBuffers; }

    void SetSoundChannelBufferDepth(
      unsigned depth    
    );

    unsigned GetSoundChannelBufferTime() const { return m_soundChannelBufferTime; }

    void SetSoundChannelBufferTime(
      unsigned depth    
    );

  protected:
    PString  soundChannelPlayDevice;
    PString  soundChannelRecordDevice;
    unsigned soundChannelBuffers;
    unsigned m_soundChannelBufferTime;

  private:
    P_REMOVE_VIRTUAL(OpalPCSSConnection *, CreateConnection(OpalCall &, const PString &, const PString &, void *), 0)
};


class OpalPCSSConnection : public OpalLocalConnection
{
    PCLASSINFO(OpalPCSSConnection, OpalLocalConnection);
  public:
    OpalPCSSConnection(
      OpalCall & call,              
      OpalPCSSEndPoint & endpoint,  
      const PString & playDevice,   
      const PString & recordDevice,  
      unsigned options = 0,                    
      OpalConnection::StringOptions * stringOptions = NULL 
    );

    ~OpalPCSSConnection();

    virtual bool TransferConnection(
      const PString & remoteParty   
    );

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

    virtual PBoolean SetAudioVolume(
      PBoolean source,        
      unsigned percentage     
    );

    virtual PBoolean GetAudioVolume(
      PBoolean source,        
      unsigned & percentage   
    );

    virtual bool SetAudioMute(
      bool source,        
      bool mute           
    );

    virtual bool GetAudioMute(
      bool source,        
      bool & mute         
    );

    virtual unsigned GetAudioSignalLevel(
      PBoolean source                   
    );

    virtual PSoundChannel * CreateSoundChannel(
      const OpalMediaFormat & mediaFormat, 
      PBoolean isSource                        
    );

    const PString & GetSoundChannelPlayDevice() const { return soundChannelPlayDevice; }

    const PString & GetSoundChannelRecordDevice() const { return soundChannelRecordDevice; }

    unsigned GetSoundChannelBufferDepth() const { return soundChannelBuffers; }

    unsigned GetSoundChannelBufferTime() const { return m_soundChannelBufferTime; }


  protected:
    OpalPCSSEndPoint & endpoint;
    PString            soundChannelPlayDevice;
    PString            soundChannelRecordDevice;
    unsigned           soundChannelBuffers;
    unsigned           m_soundChannelBufferTime;
};

#else

#ifdef _MSC_VER
#pragma message("PTLib soundcard support not available")
#else
#warning "PTLib soundcard support not available"
#endif


#endif // OPAL_HAS_PCSS

#endif // OPAL_OPAL_PCSS_H


// End of File ///////////////////////////////////////////////////////////////