Skip navigation links

com.oracle.sft.api
Interface Focus

All Superinterfaces:

Participant

public interface Focus

extends Participant

Focus is a special Participant in a Conference, application can use it to initialize the media server mixer setting using JSR309 API.

If using CommunicationSession to create Conference without Focus instance as parameter, container will create a default Focus implementation and add it to Conference.

The default Focus setting for javax.media.mscontrol.mixer.MediaMixer is MediaMixer.AUDIO.

Application can add customized setting by pass an instance of Focus using methods:

   CommunicationSession.createConference(Focus)
   CommunicationSession.createConference(String, Focus)
   CommunicationSession.createConference(String, Conversation, Focus)
 

The following example illustrates how to create a Focus and use it to create a Conference:

• First, application need lookup the JNDI tree to get instance of javax.media.mscontrol.MsControlFactory, then use JSR309 API to create javax.media.mscontrol.mixer.MediaMixer, do some Parameters setting if needed.

   MsControlFactory msControlFactory =
    (MsControlFactory)(new InitialContext()).lookup("mscontrol_jndi_name");
   MediaSession mSession = msControlFactory.createMediaSession();
   Parameters params = mSession.createParameters();
   MediaMixer mixer =
          (MediaMixer) mSession.createMediaMixer(MediaMixer.AUDIO_VIDEO, params);
   ...
   
  

• Second, application use the SFT API to create a Focus, then using it parameter to create Conference:

   CommunicationSession sess = ...;
   Focus focus = sess.createParticipant(Focus.class, "focus", mixer);
   Conference conf = sess.createConference("conf1@example.com", focus);
   
  

  If not given a name, the Focus name by default is the Conference name.

  Method Summary

  Methods inherited from interface com.oracle.sft.api.Participant

  addAgent, getAgent, getAgents, getExtension, getJoinable, getName, getNickName, removeAgent, setName, setNickName