This class is one of two main classes of concern to an application using the UserAgent library. More...

#include <LibWebRTCMediaStackAdapter.hxx>

Inheritance diagram for recon::LibWebRTCMediaStackAdapter:

Public Member Functions
	LibWebRTCMediaStackAdapter (ConversationManager &conversationManager)
	Note: LibWebRTCtapi Media Interfaces have a finite number of supported endpoints that are allowed in each bridge mixer - by default this value is 10 (1 used for local mic / speaker, 1 for a WAV Player/Recorder and 1 for a Tone Player, leaving 7 remaining for RemoteParticipants - 8 if local audio is disabled).

	LibWebRTCMediaStackAdapter (ConversationManager &conversationManager, int defaultSampleRate, int maxSampleRate)

virtual	~LibWebRTCMediaStackAdapter ()

virtual void	onConnected () override

virtual void	conversationManagerReady (ConversationManager *conversationManager) override

virtual void	shutdown () override

virtual ConversationHandle	createSharedMediaInterfaceConversation (ConversationHandle sharedMediaInterfaceConvHandle, ConversationManager::AutoHoldMode autoHoldMode=ConversationManager::AutoHoldEnabled)
	Only applicable if LibWebRTCConversationMediaInterfaceMode is used.

virtual void	buildSessionCapabilities (const resip::Data &ipaddress, const std::vector< unsigned int > &codecIds, resip::SdpContents &sessionCaps) override
	Builds a session capabilties SDPContents based on the passed in ipaddress and codec ordering.

virtual void	setLibWebRTCTOSValue (int tos)

virtual Conversation *	createConversationInstance (ConversationHandle handle, RelatedConversationSet *relatedConversationSet, ConversationHandle sharedMediaInterfaceConvHandle, ConversationManager::AutoHoldMode autoHoldMode) override

virtual LocalParticipant *	createLocalParticipantInstance (ParticipantHandle partHandle) override

virtual MediaResourceParticipant *	createMediaResourceParticipantInstance (ParticipantHandle partHandle, const resip::Uri &mediaUrl, const std::shared_ptr< resip::Data > &audioBuffer, void *recordingCircularBuffer) override

virtual RemoteParticipant *	createRemoteParticipantInstance (resip::DialogUsageManager &dum, RemoteParticipantDialogSet &rpds) override

virtual RemoteParticipant *	createRemoteParticipantInstance (ParticipantHandle partHandle, resip::DialogUsageManager &dum, RemoteParticipantDialogSet &rpds) override

virtual RemoteParticipantDialogSet *	createRemoteParticipantDialogSetInstance (ConversationManager::ParticipantForkSelectMode forkSelectMode=ConversationManager::ForkSelectAutomatic, std::shared_ptr< ConversationProfile > conversationProfile=nullptr) override

virtual bool	supportsMultipleMediaInterfaces () override

virtual bool	canConversationsShareParticipants (Conversation conversation1, Conversation conversation2) override

virtual bool	supportsLocalAudio () override

Public Member Functions inherited from recon::MediaStackAdapter
	MediaStackAdapter (ConversationManager &conversationManager)

virtual	~MediaStackAdapter ()

virtual void	setRTCPEventLoggingHandler (std::shared_ptr< flowmanager::RTCPEventLoggingHandler > h)

virtual std::shared_ptr< flowmanager::RTCPEventLoggingHandler >	getRTCPEventLoggingHandler () const

Protected Member Functions
virtual void	setUserAgent (UserAgent *userAgent) override

virtual void	configureRemoteParticipantInstance (LibWebRTCRemoteParticipant *krp)

Protected Member Functions inherited from recon::MediaStackAdapter
virtual UserAgent *	getUserAgent ()

ConversationManager &	getConversationManager ()

std::shared_ptr< BridgeMixer > &	getBridgeMixer ()

bool	isShuttingDown ()

ConversationHandle	getNewConversationHandle ()

void	post (resip::Message *message)

Conversation *	getConversation (ConversationHandle convHandle)

std::shared_ptr< resip::ConfigParse >	getConfig ()

Friends
class	DefaultDialogSet

class	Subscription

class	UserAgentShutdownCmd

class	Conversation

class	LibWebRTCConversation

class	OutputBridgeMixWeightsCmd

class	Participant

class	LibWebRTCParticipant

class	RemoteParticipant

class	LibWebRTCRemoteParticipant

class	UserAgent

class	DtmfEvent

class	MediaEvent

class	RemoteParticipantDialogSet

class	LibWebRTCRemoteParticipantDialogSet

class	MediaResourceParticipant

class	LocalParticipant

class	BridgeMixer

class	LibWebRTCMediaInterface

class	MediaResourceParticipantDeleterCmd

class	CreateConversationCmd

class	DestroyConversationCmd

class	JoinConversationCmd

class	CreateRemoteParticipantCmd

class	CreateMediaResourceParticipantCmd

class	CreateLocalParticipantCmd

class	DestroyParticipantCmd

class	AddParticipantCmd

class	RemoveParticipantCmd

class	MoveParticipantCmd

class	ModifyParticipantContributionCmd

class	AlertParticipantCmd

class	AnswerParticipantCmd

class	RejectParticipantCmd

class	RedirectParticipantCmd

class	RedirectToParticipantCmd

class	HoldParticipantCmd

Detailed Description

This class is one of two main classes of concern to an application using the UserAgent library.

This class should be subclassed by the application and the ConversationManager handlers should be implemented by it.

This class is responsible for handling tasks that are directly related to managing Conversations. All non-conversation handling is done via the UserAgent class.

This class handles tasks such as: -Creation and destruction of Conversations -Participant management and creation -Placing and receiving calls -Playing audio and/or tones into a conversation -Managing local audio properties

Definition at line 58 of file LibWebRTCMediaStackAdapter.hxx.

Constructor & Destructor Documentation

◆ LibWebRTCMediaStackAdapter() [1/2]

LibWebRTCMediaStackAdapter::LibWebRTCMediaStackAdapter ( ConversationManager & conversationManager )

Note: LibWebRTCtapi Media Interfaces have a finite number of supported endpoints that are allowed in each bridge mixer - by default this value is 10 (1 used for local mic / speaker, 1 for a WAV Player/Recorder and 1 for a Tone Player, leaving 7 remaining for RemoteParticipants - 8 if local audio
is disabled).

Also, if enableExtraPlayAndRecordResources is passed in as true then an extra slot if taken for an additional player and recorder.

The limit of 10 is controlled by the preprocessor define DEFAULT_BRIDGE_MAX_IN_OUTPUTS (see http://www.resiprocate.org/Limitations_with_LibWebRTCtapi_media_Integration for more details.

LibWebRTCGlobalMediaInterfaceMode - uses 1 global LibWebRTCtapi media interface and allows for participants to exist in multiple conversations at the same time and have the bridge mixer properly control their mixing. In this mode, there can only be a single MediaParticipant at a time performing each operation (ie. 1 playing a WAV, 1 recording and one playing a tone is allowed, but only 1 of each type) for all conversations. If enableExtraPlayAndRecordResources is enabled then you are allowed to have 2 players and 2 recorders. This architecture/mode is appropriate for single user agent devices (ie. sip phones).

LibWebRTCConversationMediaInterfaceMode - by default uses 1 LibWebRTCtapi media interface per conversation. If you use createSharedMediaInterfaceConversation instead of createConversation then you can specify that 2 (multiple) conversations can share the same media interface. This allows participants to be moved between any conversations that share the same media interface. Using this mode, participants can only exist in multiple conversations at the same time if those conversations share the same media interface. This means the limit of remote participants is no longer global, it now applies to each media interface. The limit on media participants is per media interface. This architecture/mode is appropriate for server applications, such as multi-party conference servers (up to 8 participants per conference), music on hold servers and call park servers. API restrictions in this mode: -joinConversation -restricted to functioning only if both source and destination conversations share the same media inteface -addParticipant -can only add a participant to multiple conversations if the conversations share the same media interface -moveParticipant -can only move a participant to another conversation if both source and destination conversations share the same media inteface -alertParticipant -if you are using the EarlyFlag then the RemoteParticipant must be added to a conversation before calling this -answerParticipant -RemoteParticipant must be added to a conversation before calling this Note: Only LocalParticipants can only exist outside of a conversation. If they exist in multiple conversations then those conversations must have the same media interface.

Definition at line 42 of file LibWebRTCMediaStackAdapter.cxx.

◆ LibWebRTCMediaStackAdapter() [2/2]

LibWebRTCMediaStackAdapter::LibWebRTCMediaStackAdapter	(	ConversationManager &	conversationManager,
		int	defaultSampleRate,
		int	maxSampleRate
	)

Definition at line 49 of file LibWebRTCMediaStackAdapter.cxx.

◆ ~LibWebRTCMediaStackAdapter()

LibWebRTCMediaStackAdapter::~LibWebRTCMediaStackAdapter ( )

virtual

Definition at line 98 of file LibWebRTCMediaStackAdapter.cxx.

Member Function Documentation

◆ buildSessionCapabilities()

void LibWebRTCMediaStackAdapter::buildSessionCapabilities	(	const resip::Data &	ipaddress,
		const std::vector< unsigned int > &	codecIds,
		resip::SdpContents &	sessionCaps
	)

overridevirtual

Builds a session capabilties SDPContents based on the passed in ipaddress and codec ordering.

Note: Codec ordering is an array of sipX internal codecId's. Id's for codecs not loaded are ignored.

Implements recon::MediaStackAdapter.

Definition at line 170 of file LibWebRTCMediaStackAdapter.cxx.

◆ canConversationsShareParticipants()

bool LibWebRTCMediaStackAdapter::canConversationsShareParticipants	(	Conversation *	conversation1,
		Conversation *	conversation2
	)

overridevirtual

Implements recon::MediaStackAdapter.

Definition at line 212 of file LibWebRTCMediaStackAdapter.cxx.

◆ configureRemoteParticipantInstance()

void LibWebRTCMediaStackAdapter::configureRemoteParticipantInstance ( LibWebRTCRemoteParticipant * krp )

protectedvirtual

Definition at line 239 of file LibWebRTCMediaStackAdapter.cxx.

◆ conversationManagerReady()

void LibWebRTCMediaStackAdapter::conversationManagerReady ( ConversationManager * conversationManager )

overridevirtual

Implements recon::MediaStackAdapter.

Definition at line 105 of file LibWebRTCMediaStackAdapter.cxx.

◆ createConversationInstance()

Conversation * LibWebRTCMediaStackAdapter::createConversationInstance	(	ConversationHandle	handle,
		RelatedConversationSet *	relatedConversationSet,
		ConversationHandle	sharedMediaInterfaceConvHandle,
		ConversationManager::AutoHoldMode	autoHoldMode
	)

overridevirtual

Implements recon::MediaStackAdapter.

Definition at line 218 of file LibWebRTCMediaStackAdapter.cxx.

◆ createLocalParticipantInstance()

LocalParticipant * LibWebRTCMediaStackAdapter::createLocalParticipantInstance ( ParticipantHandle partHandle )

overridevirtual

Implements recon::MediaStackAdapter.

Definition at line 227 of file LibWebRTCMediaStackAdapter.cxx.

◆ createMediaResourceParticipantInstance()

MediaResourceParticipant * LibWebRTCMediaStackAdapter::createMediaResourceParticipantInstance	(	ParticipantHandle	partHandle,
		const resip::Uri &	mediaUrl,
		const std::shared_ptr< resip::Data > &	audioBuffer,
		void *	recordingCircularBuffer
	)

overridevirtual

Implements recon::MediaStackAdapter.

Definition at line 233 of file LibWebRTCMediaStackAdapter.cxx.

◆ createRemoteParticipantDialogSetInstance()

RemoteParticipantDialogSet * LibWebRTCMediaStackAdapter::createRemoteParticipantDialogSetInstance	(	ConversationManager::ParticipantForkSelectMode	forkSelectMode = `ConversationManager::ForkSelectAutomatic`,
		std::shared_ptr< ConversationProfile >	conversationProfile = `nullptr`
	)

overridevirtual

Implements recon::MediaStackAdapter.

Definition at line 268 of file LibWebRTCMediaStackAdapter.cxx.

◆ createRemoteParticipantInstance() [1/2]

RemoteParticipant * LibWebRTCMediaStackAdapter::createRemoteParticipantInstance	(	ParticipantHandle	partHandle,
		resip::DialogUsageManager &	dum,
		RemoteParticipantDialogSet &	rpds
	)

overridevirtual

Implements recon::MediaStackAdapter.

Definition at line 260 of file LibWebRTCMediaStackAdapter.cxx.

◆ createRemoteParticipantInstance() [2/2]

RemoteParticipant * LibWebRTCMediaStackAdapter::createRemoteParticipantInstance	(	resip::DialogUsageManager &	dum,
		RemoteParticipantDialogSet &	rpds
	)

overridevirtual

Implements recon::MediaStackAdapter.

Definition at line 252 of file LibWebRTCMediaStackAdapter.cxx.

◆ createSharedMediaInterfaceConversation()

ConversationHandle LibWebRTCMediaStackAdapter::createSharedMediaInterfaceConversation	(	ConversationHandle	sharedMediaInterfaceConvHandle,
		ConversationManager::AutoHoldMode	autoHoldMode = `ConversationManager::AutoHoldEnabled`
	)

virtual

Only applicable if LibWebRTCConversationMediaInterfaceMode is used.

Create a new empty Conversation to which participants can be added. This new conversation will share the media interface from the passed in conversation handle. This allows participants to be moved between these two conversations, or any conversations that share the same media interface. This method will fail (return 0) if this ConversationManager is in LibWebRTCGlobalMediaInterfaceMode.

Parameters

autoHoldMode - enum specifying one of the following: AutoHoldDisabled - Never auto hold, only hold if holdParticipant API is used AutoHoldEnabled - Default. Automatically put a RemoteParticipant on-hold if there are no other participants in the conversation with them. AutoHoldBroadcastOnly - Use this if you are broadcasting media to all participants and don't need to receive any inbound media. All participants in the conversation will be SIP held and will receive media from an added MediaParticipant. Remote offers with inactive will be responded with sendonly as well. This option is useful for implementing music on hold servers.