org.jivesoftware.smackx.jingle.mediaimpl.jspeex

Class AudioMediaSession

java.lang.Object

org.jivesoftware.smackx.jingle.media.JingleMediaSession

org.jivesoftware.smackx.jingle.mediaimpl.jspeex.AudioMediaSession

All Implemented Interfaces:

mil.jfcom.cie.media.session.MediaSessionListener

public class AudioMediaSession
extends JingleMediaSession
implements mil.jfcom.cie.media.session.MediaSessionListener

This Class implements a complete JingleMediaSession. It sould be used to transmit and receive audio captured from the Mic. This Class should be automaticly controlled by JingleSession. But you could also use in any VOIP application. For better NAT Traversal support this implementation don't support only receive or only transmit. To receive you MUST transmit. So the only implemented and functionally methods are startTransmit() and stopTransmit()

Constructor Summary

Constructors

Constructor and Description
AudioMediaSession(PayloadType payloadType, TransportCandidate remote, TransportCandidate local, String locator, JingleSession jingleSession) Creates a org.jivesoftware.jingleaudio.jspeex.AudioMediaSession with defined payload type, remote and local candidates

Method Summary

Methods

Modifier and Type	Method and Description
static mil.jfcom.cie.media.session.MediaSession	createSession(String localhost, int localPort, String remoteHost, int remotePort, mil.jfcom.cie.media.session.MediaSessionListener eventHandler, int quality, boolean secure, boolean micOn) Create a Session using Speex Codec
protected int	getFreePort() Obtain a free port we can use.
void	initialize() Initialize the Audio Channel to make it able to send and receive audio
void	newStreamIdentified(mil.jfcom.cie.media.session.StreamPlayer streamPlayer)
void	senderReportReceived(javax.media.rtp.rtcp.SenderReport report)
void	setTrasmit(boolean active) Set transmit activity.
void	startReceive() For NAT Reasons this method does nothing.
void	startTrasmit() Starts transmission and for NAT Traversal reasons start receiving also.
void	stopReceive() For NAT Reasons this method does nothing.
void	stopTrasmit() Stops transmission and for NAT Traversal reasons stop receiving also.
void	streamClosed(mil.jfcom.cie.media.session.StreamPlayer stream, boolean timeout)

Methods inherited from class org.jivesoftware.smackx.jingle.media.JingleMediaSession

addMediaReceivedListener, getJingleSession, getLocal, getMediaLocator, getPayloadType, getRemote, mediaReceived, removeAllMediaReceivedListener, removeMediaReceivedListener, setMediaLocator

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AudioMediaSession

public AudioMediaSession(PayloadType payloadType,
                 TransportCandidate remote,
                 TransportCandidate local,
                 String locator,
                 JingleSession jingleSession)

Creates a org.jivesoftware.jingleaudio.jspeex.AudioMediaSession with defined payload type, remote and local candidates

Parameters:

payloadType - Payload of the jmf

remote - the remote information. The candidate that the jmf will be sent to.

local - the local information. The candidate that will receive the jmf

locator - media locator

Method Detail

createSession

public static mil.jfcom.cie.media.session.MediaSession createSession(String localhost,
                                                     int localPort,
                                                     String remoteHost,
                                                     int remotePort,
                                                     mil.jfcom.cie.media.session.MediaSessionListener eventHandler,
                                                     int quality,
                                                     boolean secure,
                                                     boolean micOn)
                                                              throws javax.media.NoProcessorException,
                                                                     javax.media.format.UnsupportedFormatException,
                                                                     IOException,
                                                                     GeneralSecurityException

Create a Session using Speex Codec

Parameters:

localhost - localHost

localPort - localPort

remoteHost - remoteHost

remotePort - remotePort

eventHandler - eventHandler

quality - quality

secure - secure

micOn - micOn

Returns:

MediaSession

Throws:

javax.media.NoProcessorException

javax.media.format.UnsupportedFormatException

IOException

GeneralSecurityException

initialize

public void initialize()

Initialize the Audio Channel to make it able to send and receive audio

Specified by:

initialize in class JingleMediaSession

startTrasmit

public void startTrasmit()

Starts transmission and for NAT Traversal reasons start receiving also.

Specified by:

startTrasmit in class JingleMediaSession

setTrasmit

public void setTrasmit(boolean active)

Set transmit activity. If the active is true, the instance should trasmit. If it is set to false, the instance should pause transmit.

Specified by:

setTrasmit in class JingleMediaSession

Parameters:

active - active state

startReceive

public void startReceive()

For NAT Reasons this method does nothing. Use startTransmit() to start transmit and receive jmf

Specified by:

startReceive in class JingleMediaSession

stopTrasmit

public void stopTrasmit()

Stops transmission and for NAT Traversal reasons stop receiving also.

Specified by:

stopTrasmit in class JingleMediaSession

stopReceive

public void stopReceive()

For NAT Reasons this method does nothing. Use startTransmit() to start transmit and receive jmf

Specified by:

stopReceive in class JingleMediaSession

newStreamIdentified

public void newStreamIdentified(mil.jfcom.cie.media.session.StreamPlayer streamPlayer)

Specified by:

newStreamIdentified in interface mil.jfcom.cie.media.session.MediaSessionListener

senderReportReceived

public void senderReportReceived(javax.media.rtp.rtcp.SenderReport report)

Specified by:

senderReportReceived in interface mil.jfcom.cie.media.session.MediaSessionListener

streamClosed

public void streamClosed(mil.jfcom.cie.media.session.StreamPlayer stream,
                boolean timeout)

Specified by:

streamClosed in interface mil.jfcom.cie.media.session.MediaSessionListener

getFreePort

protected int getFreePort()

Obtain a free port we can use.

Returns:

A free port number.