de.humatic.dsj.src
Class FLVSource

java.lang.Object
  de.humatic.dsj.src.Source
      de.humatic.dsj.src.NetworkSource
          de.humatic.dsj.src.FLVSource

public class FLVSource
extends NetworkSource

FLVSource reads mime-type video/x-flv "pseudo" streams from http connections served by lighttpd or Apache mod_flv_streaming modules or php based streaming solutions like xmoov - basically what Flash does on youtube. The source can also be used to play local .flv files (DSMovie requires a non-standard splitter filter to parse flv files in addition to decoders, while this source only needs the decoders).

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

FLVSource(java.net.URL flvUrl, int flags, java.beans.PropertyChangeListener listener)
Opens the stream at the given http:// or file:// URL.

Method Summary

boolean	canSeek()
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.
DSMediaType[]	getMediaTypes() Returns the media types created by this source.
int	getSourceTime()
void	setSourceTime(int time) Repositions the source, application code should rather not use this method directly, but stick with DSFiltergraph methods.

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, getMinBufferTime, getNumChannels, getOffsetTime, getPath, getSourceDuration, getSourceFilter, getSourceFilters, getSourceFlags, getTransport, getType, isLive, notifyChannelFailure, queryParameter_int, read, sendEvent, setOffsetTime, setSourceRate, streamSeek, syncRead

Methods inherited from class java.lang.Object

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

Constructor Detail

FLVSource

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

Opens the stream at the given http:// or file:// URL. An initial starttime can be passed in the URL's query string and will be interpreted as milliseconds or - given it contains a floating point - as seconds into the stream (i.e.: start=20.5 and start=20500 will do the same). Both offseting on start as well as seeking in general are only available when the stream contains keyframe and fileposition metadata. There are a number of tools to add this data to existing files with the most popular probably being FLVTool2.
The source currently takes no flags.

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

setSourceTime

public void setSourceTime(int time)

Description copied from class: Source

Repositions the source, application code should rather not use this method directly, but stick with DSFiltergraph methods. The DSGraph created by a Source knows best when and how to interfere with the javaside data reading.

Overrides:

setSourceTime 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

getSourceTime

public int getSourceTime()

Overrides:

getSourceTime in class Source

canSeek

public boolean canSeek()

Overrides:

canSeek in class Source