ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Using digital rights management
function drmStatusEventHandler(event:DRMStatusEvent):void
{
trace(event);
}
function drmStatusEventHandler(event:DRMStatusEvent):void
{
trace(event);
}
Using the DRMAuthenticateEvent class
Adobe AIR 1.0 and later
The DRMAuthenticateEvent object is dispatched when a NetStream object tries to play protected content that requires
a user credential for authentication before playback.
The DRMAuthenticateEvent handler is responsible for gathering the required credentials (user name, password, and
type) and passing the values to the NetStream.setDRMAuthenticationCredentials() method for validation. Each
AIR application must provide some mechanism for obtaining user credentials. For example, the application could
provide a user with a simple user interface to enter the user name and password values. Also, provide a mechanism for
handling and limiting repeated authentication attempts.
DRMAuthenticateEvent properties
Adobe AIR 1.0 and later
The DRMAuthenticateEvent class includes the following properties:
Property Description
authenticationType Indicates whether the supplied credentials are for authenticating against Flash Access (“drm”) or a proxy
server (“proxy”). For example, the "proxy" option allows the application to authenticate against a proxy server
if necessary before the user can access the Internet. Unless anonymous authentication is used, after the proxy
authentication, the user must still authenticate against Flash Access to obtain the voucher and play the
content. You can use setDRMAuthenticationcredentials() a second time, with "drm" option, to authenticate
against Flash Access.
header The encrypted content file header provided by the server. It contains information about the context of the
encrypted content.
This header string can be passed on to the Flash application to enable the application to construct a user
name-password dialog box. The header string can be used as the dialog box’s instructions. For example, the
header can be "Please type in your user name and password".
netstream The NetStream object that initiated this event.
passwordPrompt A prompt for a password credential, provided by the server. The string can include instruction for the type of
password required.
urlPrompt A prompt for a URL string, provided by the server. The string can provide the location where the user name
and password are sent.
usernamePrompt A prompt for a user name credential, provided by the server. The string can include instruction for the type of
user name required. For example, a content provider can require an e-mail address as the user name.
The previously mentioned strings are supplied by the FMRMS server only. Flash Access Server does not use these
strings.
Last updated 6/6/2012
537