#include <pcss.h>

Inheritance diagram for OpalPCSSEndPoint:

Collaboration diagram for OpalPCSSEndPoint:

Public Member Functions
Construction
	OpalPCSSEndPoint (OpalManager &manager, const char *prefix=OPAL_PCSS_PREFIX)

	~OpalPCSSEndPoint ()

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

Overrides from OpalLocalEndPoint
virtual bool	OnOutgoingCall (const OpalLocalConnection &connection)

virtual bool	OnIncomingCall (OpalLocalConnection &connection)

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

virtual bool	CreateVideoInputDevice (const OpalConnection &connection, const OpalMediaFormat &mediaFormat, PVideoInputDevice *&device, bool &autoDelete)

Customisation call backs
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)

virtual PSoundChannel *	CreateSoundChannel (const OpalPCSSConnection &connection, const OpalMediaFormat &mediaFormat, const PString &device, bool isSource)

User Interface operations
PSafePtr< OpalPCSSConnection >	GetPCSSConnectionWithLock (const PString &token, PSafetyMode mode=PSafeReadWrite)

virtual PBoolean	OnShowIncoming (const OpalPCSSConnection &connection)

virtual PBoolean	AcceptIncomingConnection (const PString &connectionToken)

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

virtual PBoolean	OnShowOutgoing (const OpalPCSSConnection &connection)

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

Member variable access
bool	SetLocalRingbackTone (const PString &tone)

const PString &	GetLocalRingbackTone () const

virtual PBoolean	SetSoundChannelPlayDevice (const PString &name)

const PString &	GetSoundChannelPlayDevice () const

virtual PBoolean	SetSoundChannelRecordDevice (const PString &name)

const PString &	GetSoundChannelRecordDevice () const

virtual bool	SetSoundChannelOnHoldDevice (const PString &name)

const PString &	GetSoundChannelOnHoldDevice () const

virtual bool	SetSoundChannelOnRingDevice (const PString &name)

const PString &	GetSoundChannelOnRingDevice () const

virtual bool	SetVideoGrabberDevice (const PVideoDevice::OpenArgs &args)

const PVideoDevice::OpenArgs &	GetVideoGrabberDevice () const

virtual bool	SetVideoPreviewDevice (const PVideoDevice::OpenArgs &args)

const PVideoDevice::OpenArgs &	GetVideoPreviewDevice () const

virtual bool	SetVideoDisplayDevice (const PVideoDevice::OpenArgs &args)

const PVideoDevice::OpenArgs &	GetVideoDisplayDevice () const

virtual bool	SetVideoOnHoldDevice (const PVideoDevice::OpenArgs &args)

const PVideoDevice::OpenArgs &	GetVideoOnHoldDevice () const

virtual bool	SetVideoOnRingDevice (const PVideoDevice::OpenArgs &args)

const PVideoDevice::OpenArgs &	GetVideoOnRingDevice () const

unsigned	GetSoundChannelBufferDepth () const

void	SetSoundChannelBufferDepth (unsigned depth)

unsigned	GetSoundChannelBufferTime () const

void	SetSoundChannelBufferTime (unsigned depth)

Public Member Functions inherited from OpalLocalEndPoint
	OpalLocalEndPoint (OpalManager &manager, const char *prefix=OPAL_LOCAL_PREFIX, bool useCallbacks=true)

	~OpalLocalEndPoint ()

virtual OpalMediaFormatList	GetMediaFormats () const

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

PSafePtr< OpalLocalConnection >	GetLocalConnectionWithLock (const PString &token, PSafetyMode mode=PSafeReadWrite)

virtual OpalLocalConnection *	CreateConnection (OpalCall &call, void userData, unsigned options, OpalConnection::StringOptions stringOptions)

virtual bool	OnOutgoingSetUp (const OpalLocalConnection &connection)

virtual bool	AlertingIncomingCall (const PString &token, OpalConnection::StringOptions *options=NULL, bool withMedia=false)

virtual bool	AcceptIncomingCall (const PString &token, OpalConnection::StringOptions *options=NULL)

virtual bool	RejectIncomingCall (const PString &token, const OpalConnection::CallEndReason &reason=OpalConnection::EndedByAnswerDenied)

Synchronicity	GetDefaultAudioSynchronicity () const

void	SetDefaultAudioSynchronicity (Synchronicity sync)

Synchronicity	GetDefaultVideoSourceSynchronicity () const

void	SetDefaultVideoSourceSynchronicity (Synchronicity sync)

bool	IsDeferredAlerting () const

void	SetDeferredAlerting (bool defer)

bool	IsDeferredAnswer () const

void	SetDeferredAnswer (bool defer)

bool	WillPauseTransmitMediaOnHold () const

void	SetPauseTransmitMediaOnHold (bool pause)

void	SetFarEndCameraCapabilityChangedNotifier (const PNotifier &notifier)
	Set a callback for when the far end camera control capabilities change. More...

const PNotifier &	GetFarEndCameraCapabilityChangedNotifier () const
	Get a callback for when the far end camera control capabilities change. More...

void	SetFarEndCameraActionNotifier (const PNotifier &notifier)
	Set a callback for when a far end camera control action comes from remote. More...

const PNotifier &	GetFarEndCameraActionNotifier () const
	Get a callback for when a far end camera control action comes from remote. More...

	P_DECLARE_BITWISE_ENUM (CallbackUsage, 2,(NoCallbacks, UseSourceCallback, UseSinkCallback))
	Enumeration for usage of media callback direction in CallbackMap. More...

bool	UseCallback (const OpalMediaFormat &mediaFormat, bool isSource) const
	Indicate media type and direction is to use virtual callback functions. More...

bool	SetCallbackUsage (const OpalMediaType &mediaType, CallbackUsage usage)
	Set callback usage for media type. More...

virtual bool	OnReadMediaFrame (const OpalLocalConnection &connection, const OpalMediaStream &mediaStream, RTP_DataFrame &frame)

virtual bool	OnWriteMediaFrame (const OpalLocalConnection &connection, const OpalMediaStream &mediaStream, RTP_DataFrame &frame)

virtual bool	OnReadMediaData (const OpalLocalConnection &connection, const OpalMediaStream &mediaStream, void *data, PINDEX size, PINDEX &length)

virtual bool	OnWriteMediaData (const OpalLocalConnection &connection, const OpalMediaStream &mediaStream, const void *data, PINDEX length, PINDEX &written)

virtual bool	CreateVideoOutputDevice (const OpalConnection &connection, const OpalMediaFormat &mediaFormat, bool preview, PVideoOutputDevice *&device, bool &autoDelete)

virtual Synchronicity	GetSynchronicity (const OpalMediaFormat &mediaFormat, bool isSource) const

Public Member Functions inherited from OpalEndPoint
	P_DECLARE_BITWISE_ENUM (Attributes, 2,(NoAttributes, IsNetworkEndPoint, SupportsE164))

	OpalEndPoint (OpalManager &manager, const PCaselessString &prefix, Attributes attributes)

	~OpalEndPoint ()

virtual void	ShutDown ()

void	PrintOn (ostream &strm) const

bool	StartListeners (const PStringArray &interfaces, bool add=true)

PBoolean	StartListener (const OpalTransportAddress &iface)

PBoolean	StartListener (OpalListener *listener)

virtual PStringArray	GetDefaultListeners () const

virtual PString	GetDefaultTransport () const

virtual WORD	GetDefaultSignalPort () const

OpalListener *	FindListener (const OpalTransportAddress &iface)

bool	FindListenerForProtocol (const char *proto, OpalTransportAddress &addr)

PBoolean	StopListener (const OpalTransportAddress &iface)

PBoolean	RemoveListener (OpalListener *listener)

OpalTransportAddressArray	GetInterfaceAddresses (const OpalTransport *associatedTransport=NULL) const

	PDECLARE_AcceptHandlerNotifier (OpalEndPoint, NewIncomingConnection)

virtual void	OnNewConnection (OpalCall &call, OpalConnection &connection)

virtual PBoolean	OnSetUpConnection (OpalConnection &connection)

virtual PBoolean	OnIncomingConnection (OpalConnection &connection, unsigned options, OpalConnection::StringOptions *stringOptions)

virtual void	OnProceeding (OpalConnection &connection)

virtual void	OnAlerting (OpalConnection &connection)

virtual OpalConnection::AnswerCallResponse	OnAnswerCall (OpalConnection &connection, const PString &caller)

virtual void	OnConnected (OpalConnection &connection)

virtual void	OnEstablished (OpalConnection &connection)

virtual void	OnReleased (OpalConnection &connection)

virtual void	OnHold (OpalConnection &connection, bool fromRemote, bool onHold)

virtual void	OnHold (OpalConnection &connection)

virtual PBoolean	OnForwarded (OpalConnection &connection, const PString &remoteParty)

virtual bool	OnTransferNotify (OpalConnection &connection, const PStringToString &info)

virtual PBoolean	ClearCall (const PString &token, OpalConnection::CallEndReason reason=OpalConnection::EndedByLocalUser, PSyncPoint *sync=NULL)

virtual PBoolean	ClearCallSynchronous (const PString &token, OpalConnection::CallEndReason reason=OpalConnection::EndedByLocalUser, PSyncPoint *sync=NULL)

virtual void	ClearAllCalls (OpalConnection::CallEndReason reason=OpalConnection::EndedByLocalUser, PBoolean wait=true)

PSafePtr< OpalConnection >	GetConnectionWithLock (const PString &token, PSafetyMode mode=PSafeReadWrite) const

template<class ConnClass >
PSafePtr< ConnClass >	GetConnectionWithLockAs (const PString &token, PSafetyMode mode=PSafeReadWrite) const

PStringList	GetAllConnections ()

PINDEX	GetConnectionCount () const

virtual PBoolean	HasConnection (const PString &token)

virtual void	DestroyConnection (OpalConnection *connection)

virtual void	AdjustMediaFormats (bool local, const OpalConnection &connection, OpalMediaFormatList &mediaFormats) const

virtual bool	GetMediaTransportAddresses (const OpalConnection &source, const OpalConnection &destination, const OpalMediaType &mediaType, OpalTransportAddressArray &transports) const

virtual PBoolean	OnOpenMediaStream (OpalConnection &connection, OpalMediaStream &stream)

virtual void	OnClosedMediaStream (const OpalMediaStream &stream)

virtual void	OnFailedMediaStream (OpalConnection &connection, bool fromRemote, const PString &reason)

void	SetMediaCryptoSuites (const PStringArray &security)

PStringArray	GetMediaCryptoSuites () const

virtual PStringArray	GetAllMediaCryptoSuites () const

virtual void	OnUserInputString (OpalConnection &connection, const PString &value)

virtual void	OnUserInputTone (OpalConnection &connection, char tone, int duration)

virtual PString	ReadUserInput (OpalConnection &connection, const char *terminators="#\r\n", unsigned lastDigitTimeout=4, unsigned firstDigitTimeout=30)

virtual PBoolean	Message (const PString &to, const PString &body)

virtual PBoolean	Message (const PURL &to, const PString &type, const PString &body, PURL &from, PString &conversationId)

virtual PBoolean	Message (OpalIM &Message)

virtual void	OnMessageReceived (const OpalIM &message)

virtual void	OnMWIReceived (const PString &party, OpalManager::MessageWaitingType type, const PString &extraInfo)

virtual bool	GetConferenceStates (OpalConferenceStates &states, const PString &name=PString::Empty()) const

virtual void	OnConferenceStatusChanged (OpalEndPoint &endpoint, const PString &uri, OpalConferenceState::ChangeType change)

virtual PStringList	GetNetworkURIs (const PString &name) const

virtual PBoolean	GarbageCollection ()

OpalManager &	GetManager () const

const PString &	GetPrefixName () const

bool	HasAttribute (Attributes opt) const

const OpalProductInfo &	GetProductInfo () const

void	SetProductInfo (const OpalProductInfo &info)

const PString &	GetDefaultLocalPartyName () const

virtual void	SetDefaultLocalPartyName (const PString &name)

const PString &	GetDefaultDisplayName () const

void	SetDefaultDisplayName (const PString &name)

OpalBandwidth	GetInitialBandwidth (OpalBandwidth::Direction dir) const

void	SetInitialBandwidth (OpalBandwidth::Direction dir, OpalBandwidth bandwidth)

const OpalListenerList &	GetListeners () const

const OpalConnection::StringOptions &	GetDefaultStringOptions () const

void	SetDefaultStringOptions (const OpalConnection::StringOptions &opts)

void	SetDefaultStringOption (const PCaselessString &key, const PString &data)

void	RemoveDefaultStringOption (const PCaselessString &key)

virtual PStringList	GetAvailableStringOptions () const

OpalConnection::SendUserInputModes	GetSendUserInputMode () const

void	SetSendUserInputMode (OpalConnection::SendUserInputModes mode)

Protected Attributes
PString	m_localRingbackTone

PString	m_soundChannelPlayDevice

PString	m_soundChannelRecordDevice

PString	m_soundChannelOnHoldDevice

PString	m_soundChannelOnRingDevice

unsigned	m_soundChannelBuffers

unsigned	m_soundChannelBufferTime

PVideoDevice::OpenArgs	m_videoOnHoldDevice

PVideoDevice::OpenArgs	m_videoOnRingDevice

Protected Attributes inherited from OpalLocalEndPoint
bool	m_deferredAlerting

bool	m_deferredAnswer

bool	m_pauseTransmitMediaOnHold

CallbackMap	m_useCallback

Synchronicity	m_defaultAudioSynchronicity

Synchronicity	m_defaultVideoSourceSynchronicity

PNotifier	m_farEndCameraCapabilityChangedNotifier

PNotifier	m_farEndCameraActionNotifier

Protected Attributes inherited from OpalEndPoint
OpalManager &	manager

PCaselessString	prefixName

Attributes	m_attributes

PINDEX	m_maxSizeUDP

OpalProductInfo	productInfo

PString	defaultLocalPartyName

PString	defaultDisplayName

PStringArray	m_mediaCryptoSuites

OpalBandwidth	m_initialRxBandwidth

OpalBandwidth	m_initialTxBandwidth

OpalConnection::StringOptions	m_defaultStringOptions

OpalConnection::SendUserInputModes	defaultSendUserInputMode

OpalListenerList	listeners

OpalEndPoint::ConnectionDict	connectionsActive

Additional Inherited Members
Public Types inherited from OpalLocalEndPoint
enum	Synchronicity { e_Synchronous, e_Asynchronous, e_SimulateSyncronous }

typedef map< OpalMediaType, CallbackUsage >	CallbackMap
	Map for indicating if a media type is to use callback virtual functions. More...

Protected Member Functions inherited from OpalEndPoint
OpalConnection *	AddConnection (OpalConnection *connection)

Detailed Description

PC Sound System endpoint.

Constructor & Destructor Documentation

OpalPCSSEndPoint::OpalPCSSEndPoint	(	OpalManager &	manager,
		const char *	prefix = `OPAL_PCSS_PREFIX`
	)

Create a new endpoint.

Parameters

manager	Manager of all endpoints.
prefix	Prefix for URL style address strings

OpalPCSSEndPoint::~OpalPCSSEndPoint ( )

Destroy endpoint.

Member Function Documentation

virtual PBoolean OpalPCSSEndPoint::AcceptIncomingConnection ( const PString & connectionToken )

virtual

Accept the incoming connection. Returns false if the connection token does not correspond to a valid connection.

Parameters

connectionToken Token of connection to accept call

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

virtual

Create a connection for the PCSS endpoint. The default implementation is to create a OpalPCSSConnection.

Parameters

call	Owner of connection
playDevice	Sound channel play device
recordDevice	Sound channel record device
userData	Arbitrary data to pass to connection
options	Option bit map to be passed to connection
stringOptions	Options to be passed to connection

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

virtual

Create an PSoundChannel based media stream.

Parameters

connection	Connection needing created sound channel
mediaFormat	Media format for the connection
isSource	Direction for channel

virtual PSoundChannel* OpalPCSSEndPoint::CreateSoundChannel	(	const OpalPCSSConnection &	connection,
		const OpalMediaFormat &	mediaFormat,
		const PString &	device,
		bool	isSource
	)

virtual

Create an PSoundChannel based media stream.

Parameters

connection	Connection needing created sound channel
mediaFormat	Media format for the connection
device	Name of audio device to create
isSource	Direction for channel

virtual bool OpalPCSSEndPoint::CreateVideoInputDevice	(	const OpalConnection &	connection,
		const OpalMediaFormat &	mediaFormat,
		PVideoInputDevice *&	device,
		bool &	autoDelete
	)

virtual

Create an PVideoInputDevice for a source media stream.

Parameters

connection	Connection needing created video device
mediaFormat	Media format for stream
device	Created device
autoDelete	Flag for auto delete device

Reimplemented from OpalLocalEndPoint.

const PString& OpalPCSSEndPoint::GetLocalRingbackTone ( ) const

inline

Get the local ringback tone to be played when remote indicates it is ringing.

References m_localRingbackTone.

PSafePtr<OpalPCSSConnection> OpalPCSSEndPoint::GetPCSSConnectionWithLock	(	const PString &	token,
		PSafetyMode	mode = `PSafeReadWrite`
	)

inline

Find a connection that uses the specified token. This searches the endpoint for the connection that contains the token as provided by functions such as MakeConnection(). If not then it attempts to use the token as a OpalCall token and find a connection of the same class.

Parameters

token	Token to identify connection
mode	Lock mode

unsigned OpalPCSSEndPoint::GetSoundChannelBufferDepth ( ) const

inline

Get default the sound channel buffer depth. Note the largest of the depth in frames and the depth in milliseconds as returned by GetSoundBufferTime() is used.

References m_soundChannelBuffers.

unsigned OpalPCSSEndPoint::GetSoundChannelBufferTime ( ) const

inline

Get default the sound channel buffer time in milliseconds. Note the largest of the depth in frames and the depth in milliseconds as returned by GetSoundBufferTime() is used.

References m_soundChannelBufferTime.

const PString& OpalPCSSEndPoint::GetSoundChannelOnHoldDevice ( ) const

inline

Get the name for the sound channel to be used for input when on hold. This defaults to the "Null Audio".

References m_soundChannelOnHoldDevice.

const PString& OpalPCSSEndPoint::GetSoundChannelOnRingDevice ( ) const

inline

Get the name for the sound channel to be used for input when on hold. This defaults to an empty string which does not send video on ringing.

References m_soundChannelOnRingDevice.

const PString& OpalPCSSEndPoint::GetSoundChannelPlayDevice ( ) const

inline

Get the name for the sound channel to be used for output. This defaults to the value of the PSoundChannel::GetDefaultDevice() function.

References m_soundChannelPlayDevice.

const PString& OpalPCSSEndPoint::GetSoundChannelRecordDevice ( ) const

inline

Get the name for the sound channel to be used for input. This defaults to the value of the PSoundChannel::GetDefaultDevice() function.

References m_soundChannelRecordDevice.

const PVideoDevice::OpenArgs& OpalPCSSEndPoint::GetVideoDisplayDevice ( ) const

inline

Get the name for the video device to be used for displaying received video.

References OpalEndPoint::GetManager(), and OpalManager::GetVideoOutputDevice().

const PVideoDevice::OpenArgs& OpalPCSSEndPoint::GetVideoGrabberDevice ( ) const

inline

Get the name for the video device to be used for sent video.

References OpalEndPoint::GetManager(), and OpalManager::GetVideoInputDevice().

const PVideoDevice::OpenArgs& OpalPCSSEndPoint::GetVideoOnHoldDevice ( ) const

inline

Get the name for the video device to be used for input when on hold. This defaults to the "Null Video Out".

References m_videoOnHoldDevice.

const PVideoDevice::OpenArgs& OpalPCSSEndPoint::GetVideoOnRingDevice ( ) const

inline

Get the name for the video device to be used for input when ringing. This defaults to an empty string which does not send video on ringing.

References m_videoOnRingDevice.

const PVideoDevice::OpenArgs& OpalPCSSEndPoint::GetVideoPreviewDevice ( ) const

inline

Get the name for the video device to be used for displaying sent video.

References OpalEndPoint::GetManager(), and OpalManager::GetVideoPreviewDevice().

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

virtual

Set up a connection to a remote party. This is called from the OpalManager::MakeConnection() function once it has determined that this is the endpoint for the protocol.

The general form for this party parameter is:

 [proto:][alias@][transport$]address[:port]

where the various fields will have meanings specific to the endpoint type. For example, with H.323 it could be "h323:Fred@site.com" which indicates a user Fred at gatekeeper size.com. Whereas for the PSTN endpoint it could be "pstn:5551234" which is to call 5551234 on the first available PSTN line.

The proto field is optional when passed to a specific endpoint. If it is present, however, it must agree with the endpoints protocol name or false is returned.

This function usually returns almost immediately with the connection continuing to occur in a new background thread.

If false is returned then the connection could not be established. For example if a PSTN endpoint is used and the assiciated line is engaged then it may return immediately. Returning a non-NULL value does not mean that the connection will succeed, only that an attempt is being made.

The default behaviour is pure.

Parameters

call	Owner of connection
party	Remote party to call
userData	Arbitrary data to pass to connection
options	Option bit map to be passed to connection
stringOptions	Options to be passed to connection

virtual bool OpalPCSSEndPoint::OnIncomingCall ( OpalLocalConnection & connection )

virtual

Call back to indicate that there is an incoming call. Note this function should not block or it will impede the operation of the stack.

The default implementation returns true;

Returns: false is returned the call is aborted with status of EndedByLocalBusy.

Parameters

connection Connection having event

Reimplemented from OpalLocalEndPoint.

Reimplemented in OpalConsolePCSSEndPoint.

virtual bool OpalPCSSEndPoint::OnOutgoingCall ( const OpalLocalConnection & connection )

virtual

Call back to indicate that remote is ringing. If false is returned the call is aborted.

The default implementation does nothing.

Parameters

connection Connection having event

Reimplemented from OpalLocalEndPoint.

virtual PBoolean OpalPCSSEndPoint::OnShowIncoming ( const OpalPCSSConnection & connection )

virtual

Call back to indicate that there is an incoming call. Note this function should not block or it will impede the operation of the stack.

The default implementation calls OpalPCSSEndPoint::OnIncomingCall().

Returns: false is returned the call is aborted with status of EndedByLocalBusy.

Parameters

connection Connection having event

virtual PBoolean OpalPCSSEndPoint::OnShowOutgoing ( const OpalPCSSConnection & connection )

virtual

Call back to indicate that remote is ringing. If false is returned the call is aborted.

The default implementation is pure.

Parameters

connection Connection having event

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

virtual

Call back to indicate that the remote user has indicated something. If false is returned the call is aborted.

The default implementation does nothing.

Parameters

connection	Connection having event
indication	Received user input indications

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

virtual

Call back to indicate that the remote user has indicated something. If false is returned the call is aborted.

The default implementation does nothing.

Parameters

connection	Connection having event
indication	Received user input indications

Reimplemented from OpalLocalEndPoint.

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

virtual

Reject the incoming connection. Returns false if the connection token does not correspond to a valid connection.

Parameters

connectionToken	Token of connection to accept call
reason	Reason for rejecting the call

bool OpalPCSSEndPoint::SetLocalRingbackTone ( const PString & tone )

Set the local ringback tone to be played when remote indicates it is ringing.

This string may be one of several forms: A filename for an existing WAV file. A two letter country code, or the full country name. A tone specification as per PTones class.

Parameters

tone	Tone specification string

void OpalPCSSEndPoint::SetSoundChannelBufferDepth ( unsigned depth )

Set the default sound channel buffer depth. Note the largest of the depth in frames and the depth in milliseconds as returned by GetSoundBufferTime() is used.

Parameters

depth New depth

void OpalPCSSEndPoint::SetSoundChannelBufferTime ( unsigned depth )

Set the default sound channel buffer time in milliseconds. Note the largest of the depth in frames and the depth in milliseconds as returned by GetSoundBufferTime() is used.

Parameters

depth New depth in milliseconds

virtual bool OpalPCSSEndPoint::SetSoundChannelOnHoldDevice ( const PString & name )

virtual

Set the name for the sound channel to be used for input when on hold. If the name is not suitable for use with the PSoundChannel class then the function will return false and not change the device.

This defaults to the "Null Audio".

virtual bool OpalPCSSEndPoint::SetSoundChannelOnRingDevice ( const PString & name )

virtual

Set the name for the sound channel to be used for input when ringing.

This defaults to an empty string which does not send video on ringing.

virtual PBoolean OpalPCSSEndPoint::SetSoundChannelPlayDevice ( const PString & name )

virtual

Set the name for the sound channel to be used for output. If the name is not suitable for use with the PSoundChannel class then the function will return false and not change the device.

This defaults to the value of the PSoundChannel::GetDefaultDevice() function.

virtual PBoolean OpalPCSSEndPoint::SetSoundChannelRecordDevice ( const PString & name )

virtual

Set the name for the sound channel to be used for input. If the name is not suitable for use with the PSoundChannel class then the function will return false and not change the device.

This defaults to the value of the PSoundChannel::GetDefaultDevice() function.

virtual bool OpalPCSSEndPoint::SetVideoDisplayDevice ( const PVideoDevice::OpenArgs & args )

virtual

Set the name for the video device to be used for displaying received video.

virtual bool OpalPCSSEndPoint::SetVideoGrabberDevice ( const PVideoDevice::OpenArgs & args )

virtual

Set the name for the video device to be used for sent video.

virtual bool OpalPCSSEndPoint::SetVideoOnHoldDevice ( const PVideoDevice::OpenArgs & args )

virtual

Set the name for the video device to be used for input when on hold. This defaults to the "Null Video Out".

virtual bool OpalPCSSEndPoint::SetVideoOnRingDevice ( const PVideoDevice::OpenArgs & args )

virtual