com.adobe.flashaccess.sdk.rights
Class PlayRight

java.lang.Object
  com.adobe.flashaccess.sdk.rights.Right
      com.adobe.flashaccess.sdk.rights.PlayRight

All Implemented Interfaces:

java.lang.Cloneable

public class PlayRight
extends Right

Grants the right to play the content. Restrictions may be imposed to limit which systems may play protected content.

The following restrictions are supported (all are optional):

• Playback window: limits the amount of time content can be played on each machine.
• DRM/Runtime module restrictions: Limits playback to DRM/runtime modules that meet specified security levels or version requirements.
• Application restrictions: limits playback to specific AIR or SWF applications.
• Output protection requirements: only play content if the system supports the specified output protection mechanisms.

Field Summary

static long	MAX_PLAYBACK_WINDOW The maximum playback window, in seconds.
static long	PLAYBACK_WINDOW_UNLIMITED Unlimited playback window.

Constructor Summary

PlayRight()
Creates a Play right with no restrictions.

Method Summary

ApplicationRequirements	getApplicationRequirements() Retrieves a white-list of application versions that are permitted.
ModuleRequirements	getDRMModuleRequirements() Retrieves the DRM versions that are restricted.
OutputProtectionRequirements	getOutputProtectionRequirements() Retrieves the output protection requirements which must be enabled before the protected content can be rendered.
long	getPlaybackWindow() Retrieves the interval after the first Play action is initiated that the Play right remains valid.
ModuleRequirements	getRuntimeModuleRequirements() Retrieves the runtime versions that are restricted.
void	setApplicationRequirements(ApplicationRequirements requirements) Specifies a white-list of application versions that are permitted.
void	setDRMModuleRequirements(ModuleRequirements requirements) Sets the DRM versions that are restricted.
void	setOutputProtectionRequirements(OutputProtectionRequirements requirements) Sets the output protection requirements which must be enabled before the protected content can be rendered.
void	setPlaybackWindow(long seconds) Sets the interval after the first Play action is initiated that the Play right remains valid.
void	setRuntimeModuleRequirements(ModuleRequirements requirements) Sets the runtime versions that are restricted.

Methods inherited from class com.adobe.flashaccess.sdk.rights.Right

getName

Methods inherited from class java.lang.Object

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

Field Detail

MAX_PLAYBACK_WINDOW

public static final long MAX_PLAYBACK_WINDOW

The maximum playback window, in seconds.

See Also:

Constant Field Values

PLAYBACK_WINDOW_UNLIMITED

public static final long PLAYBACK_WINDOW_UNLIMITED

Unlimited playback window.

See Also:

Constant Field Values

Constructor Detail

PlayRight

public PlayRight()

Creates a Play right with no restrictions.

Method Detail

getPlaybackWindow

public long getPlaybackWindow()

Retrieves the interval after the first Play action is initiated that the Play right remains valid. Content may be played for this amount of time (defined in seconds), starting from the first play. A value of PlayRight.PLAYBACK_WINDOW_UNLIMITED indicates there is no Play interval restriction.

Returns:

the play Interval, or PLAYBACK_WINDOW_UNLIMITED if there is no play interval restriction

setPlaybackWindow

public void setPlaybackWindow(long seconds)

Sets the interval after the first Play action is initiated that the Play right remains valid. Content may be played for this amount of time (defined in seconds), starting from the first play. A value of PlayRight.PLAYBACK_WINDOW_UNLIMITED indicates there is no Play interval restriction. The value may not exceed PlayRight.MAX_PLAYBACK_WINDOW.

Parameters:

seconds - The play interval in seconds.

getDRMModuleRequirements

public ModuleRequirements getDRMModuleRequirements()

Retrieves the DRM versions that are restricted.

Returns:

The restricted DRM versions, or null if no restrictions set.

setDRMModuleRequirements

public void setDRMModuleRequirements(ModuleRequirements requirements)

Sets the DRM versions that are restricted. If DRM module requirements are set, the DRM module must meet the specified requirements. Otherwise, there are no restrictions on the DRM module.

Parameters:

requirements - The DRM module restrictions.

getRuntimeModuleRequirements

public ModuleRequirements getRuntimeModuleRequirements()

Retrieves the runtime versions that are restricted.

Returns:

The restricted runtime versions, or null if no restrictions set.

setRuntimeModuleRequirements

public void setRuntimeModuleRequirements(ModuleRequirements requirements)

Sets the runtime versions that are restricted. If the runtime module requirements are set, the runtime module must meet the specified requirements. Otherwise, there are no restrictions on the runtime module.

Parameters:

requirements - The runtime module restrictions.

getApplicationRequirements

public ApplicationRequirements getApplicationRequirements()

Retrieves a white-list of application versions that are permitted. If the application requirements are set, only those applications listed are allowed. Otherwise, there are no restrictions on the application.

Returns:

The restricted application versions, or null if no restrictions set.

setApplicationRequirements

public void setApplicationRequirements(ApplicationRequirements requirements)

Specifies a white-list of application versions that are permitted. If the application requirements are set, only those applications listed are allowed. Otherwise, there are no restrictions on the application.

Parameters:

requirements - The application restrictions.

getOutputProtectionRequirements

public OutputProtectionRequirements getOutputProtectionRequirements()

Retrieves the output protection requirements which must be enabled before the protected content can be rendered.

Returns:

The output protection requirements, or null if no restrictions set.

setOutputProtectionRequirements

public void setOutputProtectionRequirements(OutputProtectionRequirements requirements)

Sets the output protection requirements which must be enabled before the protected content can be rendered.

Parameters:

requirements - The output protection requirements.