OPAL
Version 3.10.10
|
#include <lidep.h>
Public Member Functions | |
Construction | |
OpalLineEndPoint (OpalManager &manager) | |
~OpalLineEndPoint () | |
Make sure thread has stopped before exiting. More... | |
Overrides from OpalEndPoint | |
virtual PSafePtr< OpalConnection > | MakeConnection (OpalCall &call, const PString &party, void *userData=NULL, unsigned int options=0, OpalConnection::StringOptions *stringOptions=NULL) |
virtual OpalMediaFormatList | GetMediaFormats () const |
Connection management | |
virtual OpalLineConnection * | CreateConnection (OpalCall &call, OpalLine &line, void *userData, const PString &number) |
LID management | |
PSafePtr< OpalLineConnection > | GetLIDConnectionWithLock (const PString &token, PSafetyMode mode=PSafeReadWrite) |
PBoolean | AddLine (OpalLine *line) |
void | RemoveLine (OpalLine *line) |
const PList< OpalLine > & | GetLines () const |
void | RemoveLine (const PString &token) |
void | RemoveAllLines () |
virtual PBoolean | AddLinesFromDevice (OpalLineInterfaceDevice &device) |
void | RemoveLinesFromDevice (OpalLineInterfaceDevice &device) |
PBoolean | AddDeviceNames (const PStringArray &descriptors) |
PBoolean | AddDeviceName (const PString &descriptor) |
const OpalLineInterfaceDevice * | GetDeviceByName (const PString &descriptor) |
virtual PBoolean | AddDevice (OpalLineInterfaceDevice *device) |
void | RemoveDevice (OpalLineInterfaceDevice *device) |
void | RemoveDevices () |
OpalLine * | GetLine (const PString &lineName, bool enableAudio=false, bool terminating=true) |
void | SetDefaultLine (const PString &lineName) |
bool | SetCountryCode (OpalLineInterfaceDevice::T35CountryCodes country) |
bool | SetCountryCodeName (const PString &countryName) |
![]() | |
OpalEndPoint (OpalManager &manager, const PCaselessString &prefix, unsigned attributes) | |
~OpalEndPoint () | |
virtual void | ShutDown () |
void | PrintOn (ostream &strm) const |
PBoolean | StartListeners (const PStringArray &interfaces) |
PBoolean | StartListener (const OpalTransportAddress &iface) |
PBoolean | StartListener (OpalListener *listener) |
virtual PStringArray | GetDefaultListeners () const |
virtual PString | GetDefaultTransport () const |
OpalListener * | FindListener (const OpalTransportAddress &iface) |
bool | FindListenerForProtocol (const char *proto, OpalTransportAddress &addr) |
PBoolean | StopListener (const OpalTransportAddress &iface) |
PBoolean | RemoveListener (OpalListener *listener) |
OpalTransportAddressArray | GetInterfaceAddresses (PBoolean excludeLocalHost=true, const OpalTransport *associatedTransport=NULL) |
PDECLARE_NOTIFIER (PThread, OpalEndPoint, ListenerCallback) | |
virtual PBoolean | NewIncomingConnection (OpalTransport *transport) |
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) |
template<class ConnClass > | |
PSafePtr< ConnClass > | GetConnectionWithLockAs (const PString &token, PSafetyMode mode=PSafeReadWrite) |
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 PBoolean | OnOpenMediaStream (OpalConnection &connection, OpalMediaStream &stream) |
virtual void | OnClosedMediaStream (const OpalMediaStream &stream) |
virtual PBoolean | CreateVideoInputDevice (const OpalConnection &connection, const OpalMediaFormat &mediaFormat, PVideoInputDevice *&device, PBoolean &autoDelete) |
virtual PBoolean | CreateVideoOutputDevice (const OpalConnection &connection, const OpalMediaFormat &mediaFormat, PBoolean preview, PVideoOutputDevice *&device, PBoolean &autoDelete) |
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="#\", 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 PBoolean | GarbageCollection () |
OpalManager & | GetManager () const |
const PString & | GetPrefixName () const |
PBoolean | HasAttribute (Attributes opt) const |
WORD | GetDefaultSignalPort () 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) |
unsigned | GetInitialBandwidth () const |
void | SetInitialBandwidth (unsigned bandwidth) |
const OpalListenerList & | GetListeners () const |
const OpalConnection::StringOptions & | GetDefaultStringOptions () const |
void | SetDefaultStringOptions (const OpalConnection::StringOptions &opts) |
void | SetDefaultStringOption (const PCaselessString &key, const PString &data) |
OpalConnection::SendUserInputModes | GetSendUserInputMode () const |
void | SetSendUserInputMode (OpalConnection::SendUserInputModes mode) |
Protected Member Functions | |
PDECLARE_NOTIFIER (PThread, OpalLineEndPoint, MonitorLines) | |
virtual void | MonitorLine (OpalLine &line) |
![]() | |
OpalConnection * | AddConnection (OpalConnection *connection) |
Protected Attributes | |
OpalLIDList | devices |
OpalLineList | lines |
PString | defaultLine |
PMutex | linesMutex |
PThread * | monitorThread |
PSyncPoint | exitFlag |
![]() | |
OpalManager & | manager |
PCaselessString | prefixName |
unsigned | attributeBits |
WORD | defaultSignalPort |
PINDEX | m_maxSizeUDP |
OpalProductInfo | productInfo |
PString | defaultLocalPartyName |
PString | defaultDisplayName |
unsigned | initialBandwidth |
OpalConnection::StringOptions | m_defaultStringOptions |
OpalConnection::SendUserInputModes | defaultSendUserInputMode |
OpalListenerList | listeners |
OpalEndPoint::ConnectionDict | connectionsActive |
PMutex | inUseFlag |
Additional Inherited Members | |
![]() | |
enum | Attributes { CanTerminateCall = 1, SupportsE164 = 2 } |
This class describes and endpoint that handles LID lines. This is the ancestor class to the LID endpoints that handle PSTN lines and POTS lines respectively.
OpalLineEndPoint::OpalLineEndPoint | ( | OpalManager & | manager | ) |
Create a new endpoint.
manager | Manager of all endpoints. |
OpalLineEndPoint::~OpalLineEndPoint | ( | ) |
Make sure thread has stopped before exiting.
|
virtual |
Add a line interface device to the endpoint. This will add the OpalLineInterfaceDevice descendent and all of the lines that it has to the endpoint.
The lid is then "owned" by the endpoint and will be deleted automatically when the endpoint is destroyed.
Note the device should already be open or no lines are added.
Returns true if at least one line was added.
device | Device to add |
Referenced by GetLines().
PBoolean OpalLineEndPoint::AddDeviceName | ( | const PString & | descriptor | ) |
Add a line interface device to the endpoint by name. This will add the registered OpalLineInterfaceDevice descendent and all of the lines that it has to the endpoint. The parameter is a string as would be returned from the OpalLineInterfaceDevice::GetAllDevices() function.
Returns true if at least one line was added or the descriptor was already present.
descriptor | Device descritption to add |
Referenced by GetLines().
PBoolean OpalLineEndPoint::AddDeviceNames | ( | const PStringArray & | descriptors | ) |
Add a line interface devices to the endpoint by name. This calls AddDeviceName() for each entry in the array.
Returns true if at least one line from one device was added.
descriptors | Device descritptions to add |
Referenced by GetLines().
PBoolean OpalLineEndPoint::AddLine | ( | OpalLine * | line | ) |
Add a line to the endpoint. Note that once the line is added it is "owned" by the endpoint and should not be deleted directly. Use the RemoveLine() function to delete the line.
Returns true if the lines device was open and the line was added.
Referenced by GetLIDConnectionWithLock().
|
virtual |
Add all lines on a device to the endpoint. Note that once the line is added it is "owned" by the endpoint and should not be deleted directly. Use the RemoveLine() function to delete the line.
Note the device should already be open or no lines are added.
Returns true if at least one line was added.
device | Device to add lines |
Referenced by GetLines().
|
virtual |
call | Call that owns the connection |
line | Line connection is to use |
userData | Arbitrary user data from MakeConnection |
number | Number to dial in outgoing call |
const OpalLineInterfaceDevice* OpalLineEndPoint::GetDeviceByName | ( | const PString & | descriptor | ) |
Indicate if the line interface device is in use by the endpoint.
descriptor | Device descritption to add |
Referenced by GetLines().
|
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().
token | Token to identify connection |
mode | Lock mode |
References AddLine(), OpalEndPoint::GetConnectionWithLock(), and RemoveLine().
OpalLine* OpalLineEndPoint::GetLine | ( | const PString & | lineName, |
bool | enableAudio = false , |
||
bool | terminating = true |
||
) |
Get the line by name. The lineName parameter may be "*" to matche the first line.
If the enableAudio flag is true then the EnableAudio() function is called on the line and it is returns only if successful. This effectively locks the line for exclusive use of the caller.
lineName | Name of line to get. |
enableAudio | Flag to enable audio on the line. |
terminating | Flag to indicate should be a terminating line |
Referenced by RemoveDevices().
|
inline |
get all lines of the endpopint
References AddDevice(), AddDeviceName(), AddDeviceNames(), AddLinesFromDevice(), GetDeviceByName(), lines, RemoveAllLines(), RemoveDevice(), RemoveLine(), and RemoveLinesFromDevice().
|
virtual |
Get the data formats this endpoint is capable of operating. This provides a list of media data format names that may be used by an OpalMediaStream may be created by a connection from this endpoint.
Note that a specific connection may not actually support all of the media formats returned here, but should return no more.
The default behaviour is pure.
Implements OpalEndPoint.
Referenced by OpalLineConnection::IsNetworkConnection().
|
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.
call | Owner of connection |
party | Remote party to call |
userData | Arbitrary data to pass to connection |
options | options to pass to conneciton |
stringOptions | Options to pass to connection |
Implements OpalEndPoint.
|
protectedvirtual |
Referenced by RemoveDevices().
|
protected |
Referenced by RemoveDevices().
void OpalLineEndPoint::RemoveAllLines | ( | ) |
Remove all lines from the endpoint. The line is removed from the endpoints processing and deleted. All devices are also deleted from the endpoint
Referenced by GetLines(), and RemoveDevices().
void OpalLineEndPoint::RemoveDevice | ( | OpalLineInterfaceDevice * | device | ) |
Remove the device and all its lines from the endpoint. The device will be automatically deleted.
device | Device to remove |
Referenced by GetLines().
|
inline |
Remove all devices from the endpoint.
References GetLine(), MonitorLine(), PDECLARE_NOTIFIER(), RemoveAllLines(), SetCountryCode(), SetCountryCodeName(), and SetDefaultLine().
void OpalLineEndPoint::RemoveLine | ( | OpalLine * | line | ) |
Remove a line from the endpoint. The line is removed from the endpoints processing and deleted.
Referenced by GetLIDConnectionWithLock(), and GetLines().
void OpalLineEndPoint::RemoveLine | ( | const PString & | token | ) |
Remove a line from the endpoint. The line is removed from the endpoints processing and deleted.
void OpalLineEndPoint::RemoveLinesFromDevice | ( | OpalLineInterfaceDevice & | device | ) |
Remove all lines on a device from the endpoint. The lines are removed from the endpoints processing and deleted.
device | Device to remove lines |
Referenced by GetLines().
bool OpalLineEndPoint::SetCountryCode | ( | OpalLineInterfaceDevice::T35CountryCodes | country | ) |
Set the country code set for the device. This may change the line analogue coefficients, ring detect, call disconnect detect and call progress tones to fit the countries telephone network.
country | Country code for device |
Referenced by RemoveDevices().
bool OpalLineEndPoint::SetCountryCodeName | ( | const PString & | countryName | ) |
Set the country code set for the device.
countryName | Country code for device |
Referenced by RemoveDevices().
void OpalLineEndPoint::SetDefaultLine | ( | const PString & | lineName | ) |
Set the default line to be used on call. If the lineName is "*" then the first available line is used.
lineName | Name of line to set to default. |
Referenced by RemoveDevices().
|
protected |
|
protected |
|
protected |
|
protected |
Referenced by GetLines().
|
protected |
|
protected |