com.intertrust.wasabi.media

Class MediaStream

java.lang.Object

com.intertrust.wasabi.media.MediaStream

All Implemented Interfaces:

MediaStreamInterface

public final class MediaStream
extends java.lang.Object
implements MediaStreamInterface

General Marlin protected data access. MediaStream supports decryption of file based encrypted data other than the typical Marlin-protected audio/video media

Since:

1.6

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MediaStream.FormatInfo The base class for the additional format information that may be SourceType specific.
static class	MediaStream.FormatInfoGeneric Additional format information that may be needed when constructing a Media Stream object.
static class	MediaStream.SourceType The source type.

Field Summary

Fields inherited from interface com.intertrust.wasabi.media.MediaStreamInterface

CONTENT_TYPE_AES128CBC, CONTENT_TYPE_DCF

Constructor Summary

Constructors

Constructor and Description
MediaStream(MediaStreamInterface sourceInput, MediaStream.FormatInfo format_info) Access an encrypted source through an input object that implements the MediaStreamInterface.
MediaStream(java.lang.String sourceName, MediaStream.SourceType sourceType, MediaStream.FormatInfo format_info) Access an encrypted source through a URL.

Method Summary

Methods

Modifier and Type	Method and Description
void	close() Release the Media Stream resources.
java.lang.String	getContentType() Get Media Stream content type.
java.lang.Object	getKey() Access the crypto context for sharing with another Media Stream object to avoid re-evaluation of the same license.
long	getSize() Get Media Stream size.
int	read(byte[] buffer) Read data from a media stream object.
int	read(byte[] buffer, int offset, int length) Read data from a media stream object.
void	seek(long position) Change the current read position.
long	tell() Get the current read position.

Methods inherited from class java.lang.Object

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

Constructor Detail

MediaStream

public MediaStream(java.lang.String sourceName,
           MediaStream.SourceType sourceType,
           MediaStream.FormatInfo format_info)
            throws ErrorCodeException,
                   java.lang.NullPointerException

Access an encrypted source through a URL. NOTE: the BB license or MS3 SAS used with MediaStream must relax the default Marlin output controls or the content will not be decrypted. This requires the SAS to carry an MS3 extension (of type 'wudo') or a the Marlin Broadband license to indicate a Marlin Broadband output control override (type 'urn:marlin:organization:intertrust:wudo'). Create a MediaStream object that allows random access to the source data in cleartext. The returned object must be destroyed through mediaStream.close().

Parameters:

sourceName - either an ms3:// URL or directly a source file URL (http:// or file://) for BB.

sourceType - the type of the source data.

format_info - additional format information about the source data that. Ignored if sourceType is DCF. Can be null.

Throws:

ErrorCodeException

java.lang.NullPointerException

MediaStream

public MediaStream(MediaStreamInterface sourceInput,
           MediaStream.FormatInfo format_info)
            throws ErrorCodeException,
                   java.lang.NullPointerException

Access an encrypted source through an input object that implements the MediaStreamInterface. NOTE: the BB license or MS3 SAS used with MediaStream must relax the default Marlin output controls or the content will not be decrypted. This requires the SAS to carry an MS3 extension (of type 'wudo') or a the Marlin Broadband license to indicate a Marlin Broadband output control override (type 'urn:marlin:organization:intertrust:wudo').

Parameters:

sourceInput - source data random access object.

format_info - additional format information about the source data that. Can be null.

Throws:

ErrorCodeException

java.lang.NullPointerException

Method Detail

read

public int read(byte[] buffer)
         throws ErrorCodeException

Read data from a media stream object. This call is identical to read(buffer, 0, buffer.length).

Specified by:

read in interface MediaStreamInterface

Parameters:

buffer - the data buffer to read into.

Returns:

the number of bytes read, or -1 at the end of the stream.

Throws:

ErrorCodeException

read

public int read(byte[] buffer,
       int offset,
       int length)
         throws ErrorCodeException

Read data from a media stream object. The number of bytes actually read is never more than the smaller of 'length' and the size of the buffer starting from 'offset', i.e. at most MIN(length, buffer.length-offset).

Specified by:

read in interface MediaStreamInterface

Parameters:

buffer - the data buffer to read into.

offset - the number of buffer locations to skip

length - the number of bytes to read

Returns:

the number of bytes read, or -1 at the end of the stream.

Throws:

ErrorCodeException

seek

public void seek(long position)
          throws ErrorCodeException

Change the current read position.

Specified by:

seek in interface MediaStreamInterface

Parameters:

position - the number of bytes from the start of the media stream.

Throws:

ErrorCodeException

tell

public long tell()
          throws ErrorCodeException

Get the current read position.

Specified by:

tell in interface MediaStreamInterface

Returns:

the current media stream position as the number of bytes from the start of the media stream.

Throws:

ErrorCodeException

getSize

public long getSize()
             throws ErrorCodeException

Get Media Stream size.

Specified by:

getSize in interface MediaStreamInterface

Returns:

the size of the media stream in bytes.

Throws:

ErrorCodeException

getContentType

public java.lang.String getContentType()
                                throws ErrorCodeException

Get Media Stream content type.

Specified by:

getContentType in interface MediaStreamInterface

Returns:

the content type of the data in the media stream.

Throws:

ErrorCodeException

getKey

public java.lang.Object getKey()
                        throws ErrorCodeException

Access the crypto context for sharing with another Media Stream object to avoid re-evaluation of the same license.

Returns:

the crypto context

Throws:

ErrorCodeException

Since:

1.8

close

public void close()

Release the Media Stream resources.

Specified by:

close in interface MediaStreamInterface