de.humatic.dsj.src

Class DASHSource

java.lang.Object

de.humatic.dsj.src.Source

de.humatic.dsj.src.NetworkSource

de.humatic.dsj.src.DASHSource

public class DASHSource
extends NetworkSource

DASH (Dynamic Adaptive Streaming over HTTP) is an emerging new ISO / MPEG standard for streaming over HTTP connections. It uses segmented MPEG4 files and can be used with every standard webserver.
This source is new in dsj 0_8_64 and should be seen as a first and still incomplete implementation. Amongst others it does not yet support seeking and you will likely find streams it will fail with (Feedback is welcome).
As the underlying principle is very similiar to Apple's and Microsoft's approaches to HTTP streaming (often dubbed "Cupertino" resp. "Smooth" streaming) future versions of dsj will likely combine this source and the existing HTTPStreamingSource into one.

Field Summary

Fields inherited from class de.humatic.dsj.src.NetworkSource

BUFFER_OVERFLOW, CONNECTION_TIMEOUT, FASTSTART, H264_FASTSTART, H264_FORCE_INLINE_SPS, H264_OMMIT_SPS, H264_PASS_INLINE_SPS, IDLE_TIMEOUT, KF_NOTIFY, LIVE_SRC, MAX_BUFFER_TIME, MAX_DURATION, MAX_FRAME_TIME, NO_USER_PROMPT, READ_USER_DATA, RECEIVE_TIMEOUT, RTCP_RECEIVE_ERROR, SEEK_FAILURE, SOCKET_ERROR, STARVING, UDP_UNCONNECTED

Fields inherited from class de.humatic.dsj.src.Source

ASYNC, AUTO_GC, DIRECT, ES, FILTER_SETUP_ERROR, FLV, HTTP, HTTP_AUDIO, JAS, MJPG, MKV, MP4, PSNET, PULL, PUSH, RAW, RTMP, RTP, RTSP, SHOUTCAST, SS_CLOSED, SS_CONNECT, SS_CONNECTED, SS_DONE, SS_EOS, SS_FORMAT_READ, SS_RUNNING, SS_SEEKING, SS_SETUP, SS_STREAMS_READ, SS_TCP_ROLLOVER, TIMEOUT, TSFILE, TSNET, UNKNOWN

Constructor Summary

Constructors

Constructor and Description
DASHSource(java.net.URL mpdURL, int flags, java.beans.PropertyChangeListener listener) Opens the mpd (Media Presentation Description) at the given http:// URL.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	canSeek() Overridden to return false, this source can not yet seek.
void	closeSource(boolean terminate) Closes down the source.
DSGraph	createGraph(int graphFlags) Creates a DSGraph object with CompressedJavaSource filters that are fed from this source.
DSGraph	createGraph(int graphFlags, DSFilterInfo videoDecoder, DSFilterInfo audioDecoder) Creates a DSGraph object with CompressedJavaSource filters, fed from this source and the given video and audio decoders.
protected void	downloadSegments(java.lang.String[] urls, int numSegs)
DSMediaType[]	getMediaTypes() Returns the media types created by this source.
int	getMinBufferTime() Returns this Source's minimum buffer requirements in msec worth of data.
protected int	getNextSegment()
int	getSourceTime()
void	selectStream(java.lang.String bandWidth) To select a bandwith specific stream, this method can be called in reaction to a PLAYLIST_PARSED event, which will pass a String[] describing available streams.

Methods inherited from class de.humatic.dsj.src.NetworkSource

configurePasswordDialog, getDefaultInterfaceAddress, getPasswordDialogOptions, getServerInfo, getTimeConstraint, setConnectionTimeout, setHTTPConnector, setNetworkInterface, setSocketFactory, setTimeConstraint, setUserAgent

Methods inherited from class de.humatic.dsj.src.Source

addSourceFilter, asyncRead, createSourceFilter_async, createSourceFilter, getAvailable, getBuffered, getGraph, getID, getMaxTimeLoaded, getNumChannels, getOffsetTime, getPath, getSourceDuration, getSourceFilter, getSourceFilters, getSourceFlags, getTransport, getType, isLive, notifyChannelFailure, queryParameter_int, read, sendEvent, setOffsetTime, setSourceRate, setSourceTime, streamSeek, syncRead

Methods inherited from class java.lang.Object

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

Constructor Detail

DASHSource

public DASHSource(java.net.URL mpdURL,
          int flags,
          java.beans.PropertyChangeListener listener)
           throws java.lang.Exception

Opens the mpd (Media Presentation Description) at the given http:// URL.

Throws:

java.lang.Exception

Method Detail

closeSource

public void closeSource(boolean terminate)

Description copied from class: Source

Closes down the source. When %terminate is true, all socket and stream resources etc. will also be freed. This method is called internally when disposing off the graph that was using this source and is not normally used by application code.

Overrides:

closeSource in class Source

getSourceTime

public int getSourceTime()

Overrides:

getSourceTime in class Source

canSeek

public boolean canSeek()

Overridden to return false, this source can not yet seek.

Overrides:

canSeek in class Source

getMinBufferTime

public int getMinBufferTime()

Description copied from class: Source

Returns this Source's minimum buffer requirements in msec worth of data. Usually only PUSH mode network sources work with buffers.

Overrides:

getMinBufferTime in class Source

createGraph

public DSGraph createGraph(int graphFlags)

Description copied from class: Source

Creates a DSGraph object with CompressedJavaSource filters that are fed from this source.

Overrides:

createGraph in class Source

createGraph

public DSGraph createGraph(int graphFlags,
                  DSFilterInfo videoDecoder,
                  DSFilterInfo audioDecoder)

Description copied from class: Source

Creates a DSGraph object with CompressedJavaSource filters, fed from this source and the given video and audio decoders. This is for special use cases where you know exactly what media formats to expect. Any decoder you do not want to specify may be null or DSFilterInfo.doNotRender(). Failure to put a given decoder into the graph will be announced via GRAPH_ERROR events and dsj will try to automatically pick an alternative (no exception will be thrown!).

Overrides:

createGraph in class Source

getMediaTypes

public DSMediaType[] getMediaTypes()

Description copied from class: Source

Returns the media types created by this source. Depending on the time of calling, this method needs to be taken with care as during format negotiation mediatype information may not yet or only be partially available.

Overrides:

getMediaTypes in class Source

selectStream

public void selectStream(java.lang.String bandWidth)

To select a bandwith specific stream, this method can be called in reaction to a PLAYLIST_PARSED event, which will pass a String[] describing available streams. The source will pick a stream automatically if this is not used.

getNextSegment

protected int getNextSegment()

downloadSegments

protected void downloadSegments(java.lang.String[] urls,
                    int numSegs)