com.googlecode.mp4parser.authoring.tracks

Class CencEncryptingTrackImpl

java.lang.Object

com.googlecode.mp4parser.authoring.tracks.CencEncryptingTrackImpl

All Implemented Interfaces:

Track, CencEncryptedTrack, Closeable, AutoCloseable

public class CencEncryptingTrackImpl
extends Object
implements CencEncryptedTrack

Encrypts a given track with common encryption.

Constructor Summary

Constructors

Constructor and Description
CencEncryptingTrackImpl(Track source, UUID defaultKeyId, Map<UUID,SecretKey> keys, Map<CencSampleEncryptionInformationGroupEntry,long[]> keyRotation, String encryptionAlgo, boolean dummyIvs)
CencEncryptingTrackImpl(Track source, UUID defaultKeyId, Map<UUID,SecretKey> keys, Map<CencSampleEncryptionInformationGroupEntry,long[]> keyRotation, String encryptionAlgo, boolean dummyIvs, boolean encryptButAllClear) Encrypts a given source track.
CencEncryptingTrackImpl(Track source, UUID defaultKeyId, SecretKey key, boolean dummyIvs)

Method Summary

Modifier and Type	Method and Description
void	close()
List<CompositionTimeToSample.Entry>	getCompositionTimeEntries()
UUID	getDefaultKeyId()
long	getDuration() The duration of the track in track timescale.
List<Edit>	getEdits()
String	getHandler()
String	getName() A name for identification purposes.
List<SampleDependencyTypeBox.Entry>	getSampleDependencies()
SampleDescriptionBox	getSampleDescriptionBox()
long[]	getSampleDurations() Each samples is covers a small time span in a video.
List<CencSampleAuxiliaryDataFormat>	getSampleEncryptionEntries()
Map<GroupEntry,long[]>	getSampleGroups()
List<Sample>	getSamples() The list of all samples.
SubSampleInformationBox	getSubsampleInformationBox()
long[]	getSyncSamples()
TrackMetaData	getTrackMetaData()
boolean	hasSubSampleEncryption()

Methods inherited from class java.lang.Object

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

Constructor Detail

CencEncryptingTrackImpl

public CencEncryptingTrackImpl(Track source,
                               UUID defaultKeyId,
                               SecretKey key,
                               boolean dummyIvs)

CencEncryptingTrackImpl

public CencEncryptingTrackImpl(Track source,
                               UUID defaultKeyId,
                               Map<UUID,SecretKey> keys,
                               Map<CencSampleEncryptionInformationGroupEntry,long[]> keyRotation,
                               String encryptionAlgo,
                               boolean dummyIvs)

CencEncryptingTrackImpl

public CencEncryptingTrackImpl(Track source,
                               UUID defaultKeyId,
                               Map<UUID,SecretKey> keys,
                               Map<CencSampleEncryptionInformationGroupEntry,long[]> keyRotation,
                               String encryptionAlgo,
                               boolean dummyIvs,
                               boolean encryptButAllClear)

Encrypts a given source track.

Parameters:

source - unencrypted source file

defaultKeyId - the default key ID - might be null if sample are not encrypted by default

keys - key ID to key map

keyRotation - assigns an encryption group to a number of samples

encryptionAlgo - cenc or cbc1 (don't use cbc1)

dummyIvs - disables RNG for IVs and use IVs starting with 0x00...000

encryptButAllClear - will cause sub sample encryption format to keep full sample in clear (clear/encrypted pair will be len(sample)/0

Method Detail

getDefaultKeyId

public UUID getDefaultKeyId()

Specified by:

getDefaultKeyId in interface CencEncryptedTrack

hasSubSampleEncryption

public boolean hasSubSampleEncryption()

Specified by:

hasSubSampleEncryption in interface CencEncryptedTrack

getSampleEncryptionEntries

public List<CencSampleAuxiliaryDataFormat> getSampleEncryptionEntries()

Specified by:

getSampleEncryptionEntries in interface CencEncryptedTrack

getSampleDescriptionBox

public SampleDescriptionBox getSampleDescriptionBox()

Specified by:

getSampleDescriptionBox in interface Track

getSampleDurations

public long[] getSampleDurations()

Description copied from interface: Track

Each samples is covers a small time span in a video. This method returns the duration for each sample in track timescale. The array must contain exactly as many samples as Track.getSamples() contains.

Specified by:

getSampleDurations in interface Track

Returns:

an array of ticks

getDuration

public long getDuration()

Description copied from interface: Track

The duration of the track in track timescale. It's the sum of all samples' duration and does NOT include any edits.

Specified by:

getDuration in interface Track

Returns:

the track's duration

getCompositionTimeEntries

public List<CompositionTimeToSample.Entry> getCompositionTimeEntries()

Specified by:

getCompositionTimeEntries in interface Track

getSyncSamples

public long[] getSyncSamples()

Specified by:

getSyncSamples in interface Track

getSampleDependencies

public List<SampleDependencyTypeBox.Entry> getSampleDependencies()

Specified by:

getSampleDependencies in interface Track

getTrackMetaData

public TrackMetaData getTrackMetaData()

Specified by:

getTrackMetaData in interface Track

getHandler

public String getHandler()

Specified by:

getHandler in interface Track

getSamples

public List<Sample> getSamples()

Description copied from interface: Track

The list of all samples.

Specified by:

getSamples in interface Track

Returns:

this track's samples

getSubsampleInformationBox

public SubSampleInformationBox getSubsampleInformationBox()

Specified by:

getSubsampleInformationBox in interface Track

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException

getName

public String getName()

Description copied from interface: Track

A name for identification purposes. Might return the underlying filename or network address or any other identifier. For informational/debug only. This is no metadata!

Specified by:

getName in interface Track

Returns:

the track's name

getEdits

public List<Edit> getEdits()

Specified by:

getEdits in interface Track

getSampleGroups

public Map<GroupEntry,long[]> getSampleGroups()

Specified by:

getSampleGroups in interface Track