com.smaxe.uv.client.rtsp

Class RtspPlaySession

java.lang.Object

com.smaxe.uv.client.rtsp.RtspPlaySession

All Implemented Interfaces:

RtspClient.IRtcpHandler

public final class RtspPlaySession
extends java.lang.Object
implements RtspClient.IRtcpHandler

RtspPlaySession - RTSP play session.

Version:

1.3.0

Author:

Andrei Sochirca

See Also:

JUV RTSP/RTP Client

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	RtspPlaySession.IListener IListener - listener.

Nested classes/interfaces inherited from interface com.smaxe.uv.client.rtsp.RtspClient.IRtcpHandler

RtspClient.IRtcpHandler.ICallback

Field Summary

Fields

Modifier and Type	Field and Description
static IReceiverSession[]	EMPTY_SESSIONS EMPTY_SESSIONS
static IVideo	EMPTY_VIDEO EMPTY_VIDEO

Constructor Summary

Constructors

Constructor and Description
RtspPlaySession(RtspClient client, RtspConnection connection, IPresentation presentation, RtpUdpSessionManager sessionManager, int responseTimeout) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
void	pause() Pauses the playback.
void	play(IVideo video, java.lang.Object... args) Starts the playback (using "Range: npt=0.0-" header field).
void	play(IVideo video, java.lang.String range, java.lang.Object... args) Starts the playback.
void	resume() Resumes the playback.
void	sendApp(MediaTrackInfo track, int subtype, java.lang.String name, ByteArray data) Sends 'app' event.
void	setCallback(RtspClient.IRtcpHandler.ICallback callback) Sets callback.
void	setJitterBufferMargin(MediaTrackInfo track, int margin) Sets jitter buffer margin for the track.
void	setListener(RtspPlaySession.IListener listener) Sets the listener.
void	setMulticastAddress(java.lang.String address) Sets multicast address.
void	setProfile(java.lang.String profile) Sets profile.
int[]	setup() Setups presentation's media tracks for TCP/IP (or INTERLEAVED) mode.
int[]	setup(int rtpPort) Setups presentation's media tracks.
int[]	setup(int rtpPort, java.lang.Object... args) Setups presentation's media tracks.
int[]	setup(UnicastUdpTransport transport) Setups presentation's media tracks for UDP/IP mode.
void	teardown() Teardowns playback.

Methods inherited from class java.lang.Object

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

Field Detail

EMPTY_SESSIONS

public static final IReceiverSession[] EMPTY_SESSIONS

EMPTY_SESSIONS

EMPTY_VIDEO

public static final IVideo EMPTY_VIDEO

EMPTY_VIDEO

Constructor Detail

RtspPlaySession

public RtspPlaySession(RtspClient client,
               RtspConnection connection,
               IPresentation presentation,
               RtpUdpSessionManager sessionManager,
               int responseTimeout)

Constructor.

Parameters:

client -

connection -

presentation -

sessionManager -

responseTimeout - response timeout

Method Detail

setListener

public void setListener(RtspPlaySession.IListener listener)

Sets the listener.

Parameters:

listener -

setMulticastAddress

public void setMulticastAddress(java.lang.String address)

Sets multicast address.

Parameters:

address -

setProfile

public void setProfile(java.lang.String profile)

Sets profile.

Note:
- "RTP/AVP" - for RTP/UDP
- "MP2T/H2221/UDP" - for UDP

Parameters:

profile -

setJitterBufferMargin

public void setJitterBufferMargin(MediaTrackInfo track,
                         int margin)

Sets jitter buffer margin for the track.

Parameters:

track -

margin -

setup

public int[] setup()

Setups presentation's media tracks for TCP/IP (or INTERLEAVED) mode.

Returns:

setup media status codes

setup

public int[] setup(UnicastUdpTransport transport)

Setups presentation's media tracks for UDP/IP mode.

Note:
- If UnicastUdpTransport determines that UDP is not possible to use, because of NAT configuration then TCP/IP (or INTERLEAVED) mode is setup.

Parameters:

transport -

Returns:

setup media status codes

setup

public int[] setup(int rtpPort)

Setups presentation's media tracks.

Note: - If rtpPort is less than 255 then interleaved mode is used.

Parameters:

rtpPort - first media track RTP port

Returns:

setup media status codes

setup

public int[] setup(int rtpPort,
          java.lang.Object... args)

Setups presentation's media tracks.

Note: - If rtpPort is less than 255 then interleaved mode is used.

Parameters:

rtpPort - first media track RTP port

args - setup arguments

Returns:

setup media status codes

play

public void play(IVideo video,
        java.lang.String range,
        java.lang.Object... args)
          throws java.lang.IllegalStateException,
                 RtspMethodException

Starts the playback.

Parameters:

video - IVideo instance that accepts media data

range - 'Range' header value

args - play arguments

Throws:

java.lang.IllegalStateException - if connection is not established yet

RtspMethodException - if response status code is different from 2xx.

play

public void play(IVideo video,
        java.lang.Object... args)
          throws java.lang.IllegalStateException,
                 RtspMethodException

Starts the playback (using "Range: npt=0.0-" header field).

Parameters:

video - IVideo instance that accepts media data

args - play arguments

Throws:

java.lang.IllegalStateException - if connection is not established yet

RtspMethodException - if response status code is different from 2xx.

pause

public void pause()
           throws java.lang.IllegalStateException,
                  RtspMethodException

Pauses the playback.

Throws:

java.lang.IllegalStateException - if connection is not established yet

RtspMethodException - if response status code is different from 2xx.

resume

public void resume()
            throws java.lang.IllegalStateException,
                   RtspMethodException

Resumes the playback.

Throws:

java.lang.IllegalStateException - if connection is not established yet

RtspMethodException - if response status code is different from 2xx.

teardown

public void teardown()
              throws java.lang.IllegalStateException,
                     RtspMethodException

Teardowns playback.

Throws:

java.lang.IllegalStateException - if connection is not established yet

RtspMethodException - if response status code is different from 2xx.

setCallback

public void setCallback(RtspClient.IRtcpHandler.ICallback callback)

Description copied from interface: RtspClient.IRtcpHandler

Sets callback.

Specified by:

setCallback in interface RtspClient.IRtcpHandler

sendApp

public void sendApp(MediaTrackInfo track,
           int subtype,
           java.lang.String name,
           ByteArray data)

Description copied from interface: RtspClient.IRtcpHandler

Sends 'app' event.

Specified by:

sendApp in interface RtspClient.IRtcpHandler

Parameters:

track - media track, null to send 'app' event to all tracks

name - 4-chars app name

data - app data