ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Using digital rights management
Method Description
resetDRMVouchers() Deletes all the locally cached digital rights management (DRM) voucher data. The application
must download the vouchers again for the user to be able to access the encrypted content.
For example, the following code removes all vouchers from the cache:
NetStream.resetDRMVouchers();
setDRMAuthenticationCredentials() Passes a set of authentication credentials, namely user name, password, and authentication type,
to the NetStream object for authentication. Valid authentication types are "drm" and "proxy".
With "drm" authentication type, the credentials provided are authenticated against Flash
Access. With "proxy" authentication type, the credentials authenticate against the proxy server
and must match the credentials required by the proxy server. For example, an enterprise can
require the application to authenticate against a proxy server before the user can access the
Internet. The proxy option allows this type of authentication. 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.
preloadEmbeddedMetadata() Parses a local media file for embedded metadata. When DRM-related metadata is found, AIR calls
the onDRMContentData() callback function.
In addition, in AIR, a NetStream object calls the onDRMContentData() and onPlayStatus() callback functions as a
result of a call to the preloadEmbeddedMetaData() method. The onDRMContentData() function is called when
DRM metadata is encountered in a media file. The onPlayStatus() function is called when the file has been parsed.
The onDRMContentData() and onPlayStatus() functions must be defined on the client object assigned to the
NetStream instance. If you use the same NetStream object to preload vouchers and play content, wait for the
onPlayStatus() call generated by preloadEmbeddedMetaData() before starting playback.
In the following code for AIR, user name (“administrator”), password (“password”) and the “drm” authentication type
are set for authenticating the user. The setDRMAuthenticationCredentials() method must provide credentials that
match credentials known and accepted by the content provider. These credentials are the same user credentials that
permit the user to view the content. The code for playing the video and making sure that a successful connection to
the video stream has been made is not included here.
var connection:NetConnection = new NetConnection();
connection.connect(null);
var videoStream:NetStream = new NetStream(connection);
videoStream.addEventListener(DRMAuthenticateEvent.DRM_AUTHENTICATE,
drmAuthenticateEventHandler)
private function drmAuthenticateEventHandler(event:DRMAuthenticateEvent):void
{
videoStream.setDRMAuthenticationCredentials("administrator", "password", "drm");
}
Last updated 6/6/2012
535