Skip navigation links

com.oracle.sft.api
Interface ConversationParticipantExtension

All Superinterfaces:

ParticipantExtension

public interface ConversationParticipantExtension

extends ParticipantExtension

ConversationParticipantExtension is an interface to define some abilities which are applicable for Participant instance within a Conversation only. Instance of ConversationParticipantExtension is created for a Participant when Conversation is created firstly with a Participant or a Participant is added into a Conversation. User could retrieve the instance of ConversationParticipantExtension by calling:

 ConversationParticipantExtension extension = userParticipant.getExtension(ConversationParticipantExtension.class);
 

Method Summary

void	deferMediaInfoExchange() Decide if media info exchange of this participant involved need to be deferred.

Method Detail

deferMediaInfoExchange

void deferMediaInfoExchange()

Decide if media info exchange of this participant involved need to be deferred.

This function is only effective on a participant which acts as called party or it's not the initiator.

To establish an audio or video media communication, participant need exchange media info with party it communicates, the media info includes address, port, transport protocol, type of media, format of media, etc. In common cases, calling party offer its media info first, after receive it, called party answer its media info to calling party to accomplish media info exchange. Or say, commonly, once called party gives its media info to calling party, the media info exchange accomplishes.

However, before calling party and called party establish the call, if one of them also need media exchange with third party, such as media server, then usually we need invoke this function on called party to defer media info exchange this called party involved. When this API is invoked, SFT will prevent the first media info of calling party from delivering to called party, called party will first give its media info to calling party or other party(such as MS) before it receive any media info, after that, framework delivers another media info to called party to accomplish the media info exchange. the another media info is from calling party or other party, will be carried by ACKnowledgment message. And usually the later media info is different to the first media info of calling party, but it's not absolute.

In some announcement scenarios(especially early media situations), the function is needed for us to assure both media communication and subsequent call correct. In such situations, the function should be invoked in ParticipantEvent.Type.INITIALIZATION on Participant which acts as called party.
There is no effect to invoke it on a calling party or initiator.

Skip navigation links