Package org.mp4parser.streaming.output.mp4

Class FragmentedMp4Writer

java.lang.Object

org.mp4parser.streaming.output.mp4.DefaultBoxes

org.mp4parser.streaming.output.mp4.FragmentedMp4Writer

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, SampleSink

public class FragmentedMp4Writer
extends DefaultBoxes
implements SampleSink

Creates a fragmented MP4 file consisting of a header [ftyp, moov], any number of fragments [moof, mdat]+ and a footer [mfra]. The MultiTrackFragmentedMp4Writer is a passive component. It will only be active if one of the source tracks pushes a sample via acceptSample(StreamingSample, StreamingTrack). It has to be closed (close()) actively to trigger the write of remaining buffered samples and the footer.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
class	FragmentedMp4Writer.FragmentContainer

Field Summary

Fields

Modifier and Type	Field	Description
protected java.util.Map<StreamingTrack,java.util.concurrent.CountDownLatch>	congestionControl
protected java.util.Date	creationTime
protected java.util.Map<StreamingTrack,java.util.Queue<FragmentedMp4Writer.FragmentContainer>>	fragmentBuffers	Buffers segements until it's time for a segment to be written.
protected java.util.Map<StreamingTrack,java.lang.Long>	nextFragmentCreateStartTime	Contains the start time of the next segment in line that will be created.
protected java.util.Map<StreamingTrack,java.lang.Long>	nextFragmentWriteStartTime	Contains the start time of the next segment in line that will be written.
protected java.util.Map<StreamingTrack,java.lang.Long>	nextSampleStartTime	Contains the next sample's start time.
static java.lang.Object	OBJ
protected java.util.Map<StreamingTrack,java.util.List<StreamingSample>>	sampleBuffers	Buffers the samples per track until there are enough samples to form a Segment.
protected long	sequenceNumber
protected java.nio.channels.WritableByteChannel	sink
protected java.util.List<StreamingTrack>	source
protected java.util.Map<StreamingTrack,long[]>	tfraOffsets
protected java.util.Map<StreamingTrack,long[]>	tfraTimes

Constructor Summary

Constructors

Constructor	Description
FragmentedMp4Writer(java.util.List<StreamingTrack> source, java.nio.channels.WritableByteChannel sink)

Method Summary

Modifier and Type	Method	Description
void	acceptSample(StreamingSample streamingSample, StreamingTrack streamingTrack)	Adds a samples to the SampleSink.
void	close()	Writes the remaining samples to file (even though the typical condition for wrapping up a segment have not yet been met) and writes the MovieFragmentRandomAccessBox.
protected org.mp4parser.Box[]	createFooter()
protected org.mp4parser.Box[]	createFragment(StreamingTrack streamingTrack, java.util.List<StreamingSample> samples)
protected org.mp4parser.Box[]	createHeader()
protected org.mp4parser.Box	createMdhd(StreamingTrack streamingTrack)
protected org.mp4parser.Box	createMoov()
protected org.mp4parser.Box	createMvex()
protected org.mp4parser.Box	createMvhd()
protected void	createTfdt(StreamingTrack streamingTrack, org.mp4parser.boxes.iso14496.part12.TrackFragmentBox parent)
protected void	createTfhd(StreamingTrack streamingTrack, org.mp4parser.boxes.iso14496.part12.TrackFragmentBox parent)
protected org.mp4parser.Box	createTfra(StreamingTrack track)	Creates a 'tfra' - track fragment random access box for the given track with the isoFile.
protected org.mp4parser.Box	createTrex(StreamingTrack streamingTrack)
protected void	createTrun(StreamingTrack streamingTrack, org.mp4parser.boxes.iso14496.part12.TrackFragmentBox parent, java.util.List<StreamingSample> samples)
protected boolean	isFragmentReady(StreamingTrack streamingTrack, StreamingSample next)	Tests if the currently received samples for a given track form a valid fragment taking the latest received sample into account.
protected void	write(java.nio.channels.WritableByteChannel out, org.mp4parser.Box... boxes)
protected void	writeFooter(org.mp4parser.Box... boxes)	Writes the given boxes.
protected void	writeFragment(org.mp4parser.Box... boxes)	Writes the given boxes.
protected void	writeHeader(org.mp4parser.Box... boxes)	Writes the given boxes.

Methods inherited from class org.mp4parser.streaming.output.mp4.DefaultBoxes

createDinf, createFtyp, createMdia, createMdiaHdlr, createMinf, createStbl, createTkhd, createTrak

Methods inherited from class java.lang.Object

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

Field Detail

OBJ

public static final java.lang.Object OBJ

sink

protected final java.nio.channels.WritableByteChannel sink

source

protected java.util.List<StreamingTrack> source

creationTime

protected java.util.Date creationTime

sequenceNumber

protected long sequenceNumber

congestionControl

protected java.util.Map<StreamingTrack,java.util.concurrent.CountDownLatch> congestionControl

nextFragmentCreateStartTime

protected java.util.Map<StreamingTrack,java.lang.Long> nextFragmentCreateStartTime

Contains the start time of the next segment in line that will be created.

nextFragmentWriteStartTime

protected java.util.Map<StreamingTrack,java.lang.Long> nextFragmentWriteStartTime

Contains the start time of the next segment in line that will be written.

nextSampleStartTime

protected java.util.Map<StreamingTrack,java.lang.Long> nextSampleStartTime

Contains the next sample's start time.

sampleBuffers

protected java.util.Map<StreamingTrack,java.util.List<StreamingSample>> sampleBuffers

Buffers the samples per track until there are enough samples to form a Segment.

fragmentBuffers

protected java.util.Map<StreamingTrack,java.util.Queue<FragmentedMp4Writer.FragmentContainer>> fragmentBuffers

Buffers segements until it's time for a segment to be written.

tfraOffsets

protected java.util.Map<StreamingTrack,long[]> tfraOffsets

tfraTimes

protected java.util.Map<StreamingTrack,long[]> tfraTimes

Constructor Detail

FragmentedMp4Writer

public FragmentedMp4Writer(java.util.List<StreamingTrack> source,
                           java.nio.channels.WritableByteChannel sink)
                    throws java.io.IOException

Throws:

java.io.IOException

Method Detail

close

public void close()
           throws java.io.IOException

Writes the remaining samples to file (even though the typical condition for wrapping up a segment have not yet been met) and writes the MovieFragmentRandomAccessBox. It does not close the sink!

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface SampleSink

Throws:

java.io.IOException - if writing to the underlying data sink fails

See Also:

MovieFragmentRandomAccessBox

write

protected void write(java.nio.channels.WritableByteChannel out,
                     org.mp4parser.Box... boxes)
              throws java.io.IOException

Throws:

java.io.IOException

createMdhd

protected org.mp4parser.Box createMdhd(StreamingTrack streamingTrack)

Specified by:

createMdhd in class DefaultBoxes

createMvex

protected org.mp4parser.Box createMvex()

createTrex

protected org.mp4parser.Box createTrex(StreamingTrack streamingTrack)

createMvhd

protected org.mp4parser.Box createMvhd()

Specified by:

createMvhd in class DefaultBoxes

createMoov

protected org.mp4parser.Box createMoov()

createHeader

protected org.mp4parser.Box[] createHeader()

acceptSample

public void acceptSample(StreamingSample streamingSample,
                         StreamingTrack streamingTrack)
                  throws java.io.IOException

Description copied from interface: SampleSink

Adds a samples to the SampleSink. This might or might not cause writing the sample any output stream or channel. Once this method is called the StreamingTrack must be ready and accept calls to any method.

Specified by:

acceptSample in interface SampleSink

Throws:

java.io.IOException - if writing (or reading) fails.

isFragmentReady

protected boolean isFragmentReady(StreamingTrack streamingTrack,
                                  StreamingSample next)

Tests if the currently received samples for a given track form a valid fragment taking the latest received sample into account. The next sample is not part of the segment and will be added to the fragment buffer later.

Parameters:

streamingTrack - track to test

next - the lastest samples

Returns:

true if a fragment has been created.

createFragment

protected org.mp4parser.Box[] createFragment(StreamingTrack streamingTrack,
                                             java.util.List<StreamingSample> samples)

writeHeader

protected void writeHeader(org.mp4parser.Box... boxes)
                    throws java.io.IOException

Writes the given boxes. It's called as soon as the MultiTrackFragmentedMp4Writer received a sample from each source as this is the first point in time where the MultiTrackFragmentedMp4Writer can be sure that all config data is available from the sources. It typically writes a ftyp/moov pair but will write what ever the boxes argument contains

Parameters:

boxes - any number of boxes that form the header

Throws:

java.io.IOException - when writing to the sink fails.

See Also:

FileTypeBox, ProgressiveDownloadInformationBox, MovieBox, SegmentIndexBox

writeFragment

protected void writeFragment(org.mp4parser.Box... boxes)
                      throws java.io.IOException

Writes the given boxes. It's called as soon as a fragment is created. It typically write a single moof/mdat pair but will write what ever the boxes argument contains

Parameters:

boxes - any number of boxes that form fragment

Throws:

java.io.IOException - when writing to the sink fails.

See Also:

MovieFragmentBox, MediaDataBox, SegmentTypeBox, SegmentIndexBox

writeFooter

protected void writeFooter(org.mp4parser.Box... boxes)
                    throws java.io.IOException

Writes the given boxes. It's called as last write operation. Typically the only box written is the MovieFragmentRandomAccessBox.

Parameters:

boxes - any number of boxes to conclude the file.

Throws:

java.io.IOException - when writing to the sink fails.

See Also:

MovieFragmentRandomAccessBox

createTfhd

protected void createTfhd(StreamingTrack streamingTrack,
                          org.mp4parser.boxes.iso14496.part12.TrackFragmentBox parent)

createTfdt

protected void createTfdt(StreamingTrack streamingTrack,
                          org.mp4parser.boxes.iso14496.part12.TrackFragmentBox parent)

createTrun

protected void createTrun(StreamingTrack streamingTrack,
                          org.mp4parser.boxes.iso14496.part12.TrackFragmentBox parent,
                          java.util.List<StreamingSample> samples)

createFooter

protected org.mp4parser.Box[] createFooter()

createTfra

protected org.mp4parser.Box createTfra(StreamingTrack track)

Creates a 'tfra' - track fragment random access box for the given track with the isoFile. The tfra contains a map of random access points with time as key and offset within the isofile as value.

Parameters:

track - the concerned track

Returns:

a track fragment random access box.