com.cisco.jtapi.extensions
Interface CiscoMediaOpenIPPortEv

All Superinterfaces:
CiscoEv, CiscoTermEv, javax.telephony.events.Ev, javax.telephony.events.TermEv

public interface CiscoMediaOpenIPPortEv
extends CiscoTermEv

Introduction

The system sends a CiscoMediaOpenIPPortEv event when CiscoMediaTerminal or CiscoRouteTerminal registered with the registration type as CiscoBaseMediaTerminal.DYNAMIC_MEDIA_REGISTRATION_FOR_GET_PORT_SUPPORT or CiscoBaseMediaTerminal.STATIC_MEDIA_REGISTRATION_FOR_GET_PORT_SUPPORT. Upon receiving this event, applications must can check for the registration type for the terminal using the CiscoBaseMediaTerminal.getRegistrationType() API. If the getRegistrationType() returns CiscoBaseMediaTerminal.DYNAMIC_MEDIA_REGISTRATION_FOR_GET_PORT_SUPPORT applications must invoke setRTPParams on CiscoMediaTerminal or CiscoRouteTerminal and pass in the IP address and port number where they want to terminate the media, along with the rtpHandle that this event delivers and also open the ports. If getRegistrationType() returns CiscoBaseMediaTerminal.STATIC_MEDIA_REGISTRATION_FOR_GET_PORT_SUPPORT, applications need to open the port which they had provided while registering the terminal. Applications can get a call reference by using CiscoProvider.getCall(CiscoRTPHandle). Applications must be aware that the far end and local end may not be able to invoke features unless the setRTPParams method is invoked. If applications fail to respond to this event within the specified time, the call may get disconnected.

Since:
8.5

Field Summary
static int ID
           
 
Fields inherited from interface javax.telephony.events.Ev
CAUSE_CALL_CANCELLED, CAUSE_DEST_NOT_OBTAINABLE, CAUSE_INCOMPATIBLE_DESTINATION, CAUSE_LOCKOUT, CAUSE_NETWORK_CONGESTION, CAUSE_NETWORK_NOT_OBTAINABLE, CAUSE_NEW_CALL, CAUSE_NORMAL, CAUSE_RESOURCES_NOT_AVAILABLE, CAUSE_SNAPSHOT, CAUSE_UNKNOWN, META_CALL_ADDITIONAL_PARTY, META_CALL_ENDING, META_CALL_MERGING, META_CALL_PROGRESS, META_CALL_REMOVING_PARTY, META_CALL_STARTING, META_CALL_TRANSFERRING, META_SNAPSHOT, META_UNKNOWN
 
Method Summary
 CiscoRTPHandle getCiscoRTPHandle()
           Returns CiscoRTPHandle object.
 int getMediaIPAddressingMode()
           This interface return int Application could get following values for required IP Addressing Mode :- CiscoTerminal.IP_ADDRESSING_IPv4: Means application need to provide IPv4 format IP Address in set RTP Params request. CiscoTerminal.IP_ADDRESSING_IPv6: Means application need to provide IPv6 format IP Address in set RTP Params request.
 
Methods inherited from interface javax.telephony.events.TermEv
getTerminal
 
Methods inherited from interface javax.telephony.events.Ev
getCause, getID, getMetaCode, getObserved, isNewMetaEvent
 

Field Detail

ID

static final int ID
See Also:
Constant Field Values
Method Detail

getMediaIPAddressingMode

int getMediaIPAddressingMode()

This interface return int Application could get following values for required IP Addressing Mode :-

  • CiscoTerminal.IP_ADDRESSING_IPv4: Means application need to provide IPv4 format IP Address in set RTP Params request.
  • CiscoTerminal.IP_ADDRESSING_IPv6: Means application need to provide IPv6 format IP Address in set RTP Params request.
  • Returns:
    int
    Since:
    8.5

    getCiscoRTPHandle

    CiscoRTPHandle getCiscoRTPHandle()

    Returns CiscoRTPHandle object. Applications should pass this handle along with RTPParameters to CiscoMediaTerminal or CiscoRouteTerminal. Applications can get call reference using CiscoProvider.getCall If there is no callobserver or there was no callobserver when this event is delivered, then CiscoProvider.getCall may return null

    Returns:
    CiscoRTPHandle
    Since:
    8.5
    See Also:
    CiscoRTPParams