ivr.h

Go to the documentation of this file.

/*
 * ivr.h
 *
 * Interactive Voice Response 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: 24495 $
 * $Author: rjongbloed $
 * $Date: 2010-06-14 23:22:45 -0500 (Mon, 14 Jun 2010) $
 */

#ifndef OPAL_OPAL_IVR_H
#define OPAL_OPAL_IVR_H

#ifdef P_USE_PRAGMA
#pragma interface
#endif

#include <opal/buildopts.h>

#if OPAL_IVR

#include <opal/opalvxml.h>
#include <opal/localep.h>

class OpalIVRConnection;


class OpalIVREndPoint : public OpalLocalEndPoint
{
    PCLASSINFO(OpalIVREndPoint, OpalLocalEndPoint);
  public:
    OpalIVREndPoint(
      OpalManager & manager,  
      const char * prefix = "ivr" 
    );

    ~OpalIVREndPoint();

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

    );

    virtual OpalMediaFormatList GetMediaFormats() const;

    virtual OpalIVRConnection * CreateConnection(
      OpalCall & call,        
      void * userData,        
      const PString & vxml,   
      unsigned int options,
      OpalConnection::StringOptions * stringOptions = NULL
    );

    PSafePtr<OpalIVRConnection> GetIVRConnectionWithLock(
      const PString & token,     
      PSafetyMode mode = PSafeReadWrite
    ) { return PSafePtrCast<OpalConnection, OpalIVRConnection>(GetConnectionWithLock(token, mode)); }

    const PString & GetDefaultVXML() const { return defaultVXML; }

    void SetDefaultVXML(
      const PString & vxml
    );

    void SetDefaultMediaFormats(
      const OpalMediaFormatList & formats
    );

    virtual void OnEndDialog(
      OpalIVRConnection & connection  
    );

    void SetDefaultTextToSpeech(const PString & tts)
    { defaultTts = tts; }

    PString GetDefaultTextToSpeech() const
    { return defaultTts; }


  protected:
    PString             defaultVXML;
    OpalMediaFormatList defaultMediaFormats;
    PString             defaultTts;

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


class OpalIVRConnection : public OpalLocalConnection
{
    PCLASSINFO(OpalIVRConnection, OpalLocalConnection);
  public:
    OpalIVRConnection(
      OpalCall & call,            
      OpalIVREndPoint & endpoint, 
      void * userData,            
      const PString & vxml,       
      unsigned int options,
      OpalConnection::StringOptions * stringOptions = NULL
    );

    ~OpalIVRConnection();

    virtual bool IsNetworkConnection() const { return false; }

    virtual PString GetLocalPartyURL() const;

    void OnEstablished();

    virtual bool TransferConnection(
      const PString & remoteParty   
    );
    
    virtual OpalMediaFormatList GetMediaFormats() const;

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

    virtual PBoolean SendUserInputString(
      const PString & value                   
    );

    virtual void OnEndDialog();

    const PString & GetVXML() const { return m_vxmlScript; }

    PTextToSpeech * GetTextToSpeech() const { return m_vxmlSession.GetTextToSpeech(); }
    PTextToSpeech * SetTextToSpeech(const PString & ttsName) { return m_vxmlSession.SetTextToSpeech(ttsName); }
    PTextToSpeech * SetTextToSpeech(PTextToSpeech * tts, PBoolean autoDelete = false) { return m_vxmlSession.SetTextToSpeech(tts, autoDelete); }

  protected:
    virtual bool StartVXML(const PString & vxml);
    virtual bool StartScript(const PString & script);

    OpalIVREndPoint   & endpoint;
    PString             m_vxmlScript;
    OpalMediaFormatList m_vxmlMediaFormats;
    OpalVXMLSession     m_vxmlSession;
};


class OpalIVRMediaStream : public OpalRawMediaStream
{
    PCLASSINFO(OpalIVRMediaStream, OpalRawMediaStream);
  public:
    OpalIVRMediaStream(
      OpalIVRConnection & conn,
      const OpalMediaFormat & mediaFormat, 
      unsigned sessionID,                  
      PBoolean isSource,                       
      PVXMLSession & vxml                  
    );

    virtual PBoolean Open();

    virtual PBoolean Close();

    virtual PBoolean IsSynchronous() const;

  protected:
    OpalConnection & conn;
    PVXMLSession & vxmlSession;
};


#endif // OPAL_IVR

#endif // OPAL_OPAL_IVR_H


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

---