com.intertrust.wasabi

Class Runtime

java.lang.Object

com.intertrust.wasabi.Runtime

public final class Runtime
extends java.lang.Object

A static class for initializing and shutting down the Wasabi Runtime.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Runtime.Property Runtime property identifiers.

Constructor Summary

Constructors

Constructor and Description
Runtime()

Method Summary

Methods

Modifier and Type	Method and Description
static void	checkLicense(java.lang.String content_id) Check for a valid license for 'content_id'.
static java.lang.Object	getProperty(Runtime.Property property_id) Get Runtime property selected.
static void	initialize() Initialize Wasabi runtime.
static void	initialize(java.lang.String storagePath) Initialize Wasabi runtime.
static void	initializeEx(java.lang.String storagePath, java.lang.String dbNameParam) Initialize Wasabi runtime.
static boolean	isPersonalized() Check whether the runtime has been personalized.
static void	personalize() Perform runtime personalization with the default personalization token.
static void	personalize(java.lang.String token) Perform runtime personalization.
static void	processServiceToken(java.lang.String token) Process service token.
static void	setProperty(Runtime.Property property_id, java.lang.Object value) Set Runtime property selected.
static void	shutdown() Shutdown Wasabi library.
static java.lang.String	volatileStore(java.lang.String content_type, byte[] data) Store a data object into Volatile Store returning a new special URL string that can be passed as media URL to Playlist Proxy.

Methods inherited from class java.lang.Object

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

Constructor Detail

Runtime

public Runtime()

Method Detail

initializeEx

public static void initializeEx(java.lang.String storagePath,
                java.lang.String dbNameParam)
                         throws ErrorCodeException,
                                java.lang.NullPointerException

Initialize Wasabi runtime. Load and initialize the native Wasabi code.

Parameters:

storagePath - the storage directory to be used by Wasabi runtime. The storagePath is set as the new value of the STORAGE_DIRECTORY Runtime property, unless null in which case the current value of the STORAGE_DIRECTORY Runtime property is assumed for the DRM storage directory.

Throws:

ErrorCodeException

java.lang.NullPointerException

initialize

public static void initialize(java.lang.String storagePath)
                       throws ErrorCodeException,
                              java.lang.NullPointerException

Initialize Wasabi runtime. Equivalent to calling initializeEx(storagePath, null). See initializeEx(String storagePath, String dbNameParam)

Throws:

ErrorCodeException

java.lang.NullPointerException

initialize

public static void initialize()
                       throws ErrorCodeException

Initialize Wasabi runtime. Load and initialize the native Wasabi code. This call initializes Wasabi runtime. The DRM storage directory is the currently selected STORAGE_DIRECTORY Runtime property value. This may not be acceptable on some OS platforms. Some platforms must have the path configured at run-time by the application selecting the appropriate path (e.g. Android application.) In such case, use Runtime::initialize(String) or Runtime::initializeEx(String,String) with non-null storagePath argument or use Runtime::setProperty to select specific storage directory other than the default. See initializeEx(String storagePath, String dbNameParam)

Throws:

ErrorCodeException

isPersonalized

public static boolean isPersonalized()

Check whether the runtime has been personalized. This is a utility function simplifying the personalization sequence.

Since:

1.6

See Also:

Engine

personalize

public static void personalize(java.lang.String token)
                        throws ErrorCodeException

Perform runtime personalization. This is a utility function simplifying the personalization sequence.

Parameters:

token - perform personalization using the XML document 'token'

Throws:

ErrorCodeException

Since:

1.6

See Also:

Engine

personalize

public static void personalize()
                        throws ErrorCodeException

Perform runtime personalization with the default personalization token. This is a utility function simplifying the personalization sequence.

Throws:

ErrorCodeException

Since:

1.6

See Also:

Engine

processServiceToken

public static void processServiceToken(java.lang.String token)
                                throws ErrorCodeException

Process service token. If the token is a license acquisition token, the license gets stored in the License Store automatically. This is a utility function simplifying the service token processing.

Parameters:

token - the service token XML string to process

Throws:

ErrorCodeException

Since:

1.7

See Also:

Engine, LicenseStore

checkLicense

public static void checkLicense(java.lang.String content_id)
                         throws ErrorCodeException

Check for a valid license for 'content_id'. License Store is searched for licenses that match 'content_id' and then checked whether they are valid for the Play action. The license is only checked and not performed. If a valid license is found, no exception is raised, if no valid license is found, an appropriate ErrorCodeException is raised.

Parameters:

content_id - the content ID.

Throws:

ErrorCodeException

Since:

1.10

See Also:

LicenseStore, processServiceToken(java.lang.String)

getProperty

public static java.lang.Object getProperty(Runtime.Property property_id)
                                    throws ErrorCodeException

Get Runtime property selected.

Parameters:

property_id - Runtime property identifier.

Throws:

ErrorCodeException

Since:

1.8

See Also:

Runtime.Property

setProperty

public static void setProperty(Runtime.Property property_id,
               java.lang.Object value)
                        throws ErrorCodeException

Set Runtime property selected.

Parameters:

property_id - Runtime property identifier.

value - the new property value. Must match the expected property value as listed in the property identifier documentation.

Throws:

ErrorCodeException

Since:

1.8

See Also:

Runtime.Property

volatileStore

public static java.lang.String volatileStore(java.lang.String content_type,
                             byte[] data)
                                      throws ErrorCodeException

Store a data object into Volatile Store returning a new special URL string that can be passed as media URL to Playlist Proxy. The returned URL has a special scheme understood only by Playlist Proxy. Volatile Store accommodates only one object at any time. The storage can be freed by calling the function with the data argument set to null. The storage is also released on Runtime.shutdown().

Parameters:

content_type - content type (mime type, e.g. application/vnd.apple.mpegurl) of the object being stored.

data - buffer containing data to be stored. Can be null to remove any previously stored data.

Throws:

ErrorCodeException

Since:

1.19

shutdown

public static void shutdown()
                     throws ErrorCodeException

Shutdown Wasabi library. Shutdown Wasabi native code. No com.intertrust.wasabi code can be invoked subsequently, until initialize is invoked again.

Throws:

ErrorCodeException