com.intertrust.wasabi.media

Class PlaylistProxy

java.lang.Object

com.intertrust.wasabi.media.PlaylistProxy

public class PlaylistProxy
extends java.lang.Object

On iOS and Android, playback of Audio/Visual content is handled by the device's native media player. The ExpressPlay SDK interposes a Proxy (Playlist Proxy) between the raw protected media source and the native player. The Playlist Proxy reads from the protected media source, evaluates the license, and if the license allows it, decrypts the media and makes it available as an HLS stream to the native player.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	PlaylistProxy.Flags Proxy creation flags.
static class	PlaylistProxy.MediaSourceParams Playlist Proxy URL parameters.
static class	PlaylistProxy.MediaSourceType The media source type: a single Marlin file, or a Marlin HLS playlist.

Constructor Summary

Constructors

Constructor and Description
PlaylistProxy() PlaylistProxy constructor.
PlaylistProxy(java.util.EnumSet<PlaylistProxy.Flags> flags) PlaylistProxy constructor with flags.

Method Summary

Methods

Modifier and Type	Method and Description
void	getAndClearLastError() Check the Playlist Proxy execution status.
java.lang.String	getAuthToken() Obtain the current Playlist Proxy authentication token.
java.lang.String	makeUrl(java.lang.String mediaSource, PlaylistProxy.MediaSourceType mediaSourceType, PlaylistProxy.MediaSourceParams mediaSourceParams) Make a Playlist Proxy URL.
void	start() Start running playlist proxy.
void	stop() Stop running playlist proxy.

Methods inherited from class java.lang.Object

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

Constructor Detail

PlaylistProxy

public PlaylistProxy(java.util.EnumSet<PlaylistProxy.Flags> flags)
              throws ErrorCodeException

PlaylistProxy constructor with flags.

Throws:

ErrorCodeException

Since:

1.8

See Also:

PlaylistProxy.Flags

PlaylistProxy

public PlaylistProxy()
              throws ErrorCodeException

PlaylistProxy constructor.

Throws:

ErrorCodeException

Method Detail

start

public void start()
           throws ErrorCodeException

Start running playlist proxy. See stop()

Throws:

ErrorCodeException

stop

public void stop()
          throws ErrorCodeException

Stop running playlist proxy.

Throws:

ErrorCodeException

getAuthToken

public java.lang.String getAuthToken()
                              throws ErrorCodeException

Obtain the current Playlist Proxy authentication token. Depending on the flags at the creation time, the Playlist Proxy may require the authentication token in the URL, in the HTTP request headers. See AUTH_TOKEN_HEADER macro for additional information.

Throws:

ErrorCodeException

Since:

1.8

getAndClearLastError

public void getAndClearLastError()
                          throws ErrorCodeException

Check the Playlist Proxy execution status. Throw exception corresponding to the most recent error reported by Playlist Proxy, if any. Clears the most recent error code as a side effect.

Throws:

ErrorCodeException

makeUrl

public java.lang.String makeUrl(java.lang.String mediaSource,
                       PlaylistProxy.MediaSourceType mediaSourceType,
                       PlaylistProxy.MediaSourceParams mediaSourceParams)
                         throws ErrorCodeException

Make a Playlist Proxy URL.

Parameters:

mediaSource - path or URL to the Marlin media source

mediaSourceType - mime type of the original media

mediaSourceParams - url parameters, can be null. However, in the case of SINGLE_FILE MediaSourceType, the sourceContentType must be set to select between BBTS ("video/mp2t"), PDCF ("video/mp4") and DCF (application/vnd.oma.drm.dcf).

Returns:

0 on success and error code on failure

Throws:

ErrorCodeException