com.intertrust.wasabi.media

Class MediaAdapter

java.lang.Object

com.intertrust.wasabi.media.MediaAdapter

public class MediaAdapter
extends java.lang.Object

Media Adapter adapts protected media source to the device for playback based on caller's preference on DRM, license type, and other adaptation parameters. Media Adapter instantiates and setup the Playlist Proxy for media adaptation.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MediaAdapter.Config Adapter configuration.
static class	MediaAdapter.DrmType Adapter usage of DRM type.
static class	MediaAdapter.LicenseType Adapter usage of license type.
static class	MediaAdapter.Params Adapter media source parameters.
static class	MediaAdapter.PlaybackInfo

Constructor Summary

Constructors

Constructor and Description
MediaAdapter(MediaAdapter.Config config) MediaAdapter constructor.

Method Summary

Methods

Modifier and Type	Method and Description
MediaAdapter.PlaybackInfo	adapt(MediaAdapter.Params params) Adapt the media source for content playback.
void	close() Close the Media Adapter.

Methods inherited from class java.lang.Object

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

Constructor Detail

MediaAdapter

public MediaAdapter(MediaAdapter.Config config)
             throws ErrorCodeException

MediaAdapter constructor.

Parameters:

config - Configuration set by caller. If it is null, the default configuration is used which give preference to using native DRM and streaming license.

Throws:

ErrorCodeException

Method Detail

adapt

public MediaAdapter.PlaybackInfo adapt(MediaAdapter.Params params)
                                throws ErrorCodeException,
                                       java.lang.NullPointerException

Adapt the media source for content playback. Upon successfully adaptation, the returned playback information contains all the parameters an application needs to play the content. A Playlist Proxy instance is returned among those parameters depending on the media adaptation. If a Playlist Proxy is returned, it will be configured and started already to adapting content for playback. Application should use the token URL returned in the playback information to request a native DRM license to playback the adapted content URL. During playback, application can call all the Playlist Proxy methods except makeUrl and stop. Media Adapter is responsible for managing the lifetime of Playlist Proxy object. When Media Adapter is closed, the Playlist Proxy is stop and destroyed. If no Playlist Proxy is returned, application can playback content with native DRM without Playlist Proxy's involvement. Application should use the token URL returned in the playback information to request a native DRM license to playback the adapted content URL.

Parameters:

params - parameters for media adaptation

Returns:

newly allocated playback info object

Throws:

ErrorCodeException

java.lang.NullPointerException

See Also:

close(), PlaylistProxy.makeUrl(String mediaSource, MediaSourceType mediaSourceType, MediaSourceParams mediaSourceParams), PlaylistProxy.stop()

close

public void close()
           throws ErrorCodeException

Close the Media Adapter. Release all the resources associated with the Media Adapter including the Playlist Proxy returned to the caller from the adapt method. The Playlist Proxy is stopped before getting destroy.

Throws:

ErrorCodeException

See Also:

adapt(Params params).