org.mobicents.csapi.jr.slee.cc.mmccs
Interface IpMultiMediaCallLegConnection

All Superinterfaces:

IpCallLegConnection, IpServiceConnection

public interface IpMultiMediaCallLegConnection
extends IpCallLegConnection

The Multi-Media call leg represents the signalling relationship between the call and an address. Associated with the signalling relationship there can be multiple media channels. Media channels can be started and stopped by the terminals themselves. The application can monitor on these changes and influence them. This interface shall be implemented by a Multi Media Call Control SCF. The mediaStreamAllow() and mediaStreamMonitorReq() methods shall be implemented as a minimum requirement. The minimum required methods from IpCallLeg are also required.

Method Summary

TpMediaStream[]	getMediaStreams() This method is used to return all currently established media streams for the leg.
void	mediaStreamAllow(int[] mediaStreamList) This method can be used to allow setup of a media stream that was reported by a mediaStreamMonitorRes method.
void	mediaStreamMonitorReq(TpMediaStreamRequest[] mediaStreamEventCriteria) With this method the application can set monitors on the addition and subtraction of media streams.

Methods inherited from interface org.mobicents.csapi.jr.slee.cc.mpccs.IpCallLegConnection

attachMediaReq, continueProcessing, deassign, detachMediaReq, eventReportReq, getCall, getCurrentDestinationAddress, getInfoReq, release, routeReq, setAdviceOfCharge, setChargePlan, superviseReq

Methods inherited from interface org.mobicents.csapi.jr.slee.IpServiceConnection

closeConnection

Method Detail

mediaStreamAllow

void mediaStreamAllow(int[] mediaStreamList)
                      throws TpCommonExceptions,
                             javax.slee.resource.ResourceException

This method can be used to allow setup of a media stream that was reported by a mediaStreamMonitorRes method.

Parameters:

mediaStreamList - Refers to the media streams (sessionIDs) as received in the mediaStreamMonitorRes() or in the reportMediaNotification() that is allowed to be established.

Throws:

TpCommonExceptions

javax.slee.resource.ResourceException

mediaStreamMonitorReq

void mediaStreamMonitorReq(TpMediaStreamRequest[] mediaStreamEventCriteria)
                           throws TpCommonExceptions,
                                  P_INVALID_CRITERIA,
                                  P_INVALID_EVENT_TYPE,
                                  javax.slee.resource.ResourceException

With this method the application can set monitors on the addition and subtraction of media streams. The monitors can either be general or restricted to certain types of codecs. Monitoring on addition of media streams can be done in either interrupt of notify mode. In the first case the application has to allow or deny the establishment of the stream with mediaStreamAllow. Monitoring on subtraction of media streams is only allowed in notify mode.

Parameters:

mediaStreamEventCriteria - Specifies the event specific criteria used by the application to define the event required. The mediaMonitorMode .is a parameter of TpMediaStreamRequest and can be in interrupt or in notify mode. If in interrupt mode the application has to respond with mediaStreamAllow().

Throws:

TpCommonExceptions

P_INVALID_CRITERIA

P_INVALID_EVENT_TYPE

javax.slee.resource.ResourceException

getMediaStreams

TpMediaStream[] getMediaStreams()
                                throws TpCommonExceptions,
                                       javax.slee.resource.ResourceException

This method is used to return all currently established media streams for the leg.

Throws:

TpCommonExceptions

javax.slee.resource.ResourceException