ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Using digital rights management
}
}
trace( "Authenticated to: " + event.serverURL + ", domain: " + event.domain );
getVoucher();
}
private function onDRMStatus( event:DRMStatusEvent ):void
{
trace( "DRM Status: " + event.detail);
trace("--Voucher allows offline playback = " + event.isAvailableOffline );
trace("--Voucher already cached = " + event.isLocal );
trace("--Voucher required authentication = " + !event.isAnonymous );
}
private function onDRMError( event:DRMErrorEvent ):void
{
trace( "DRM error event: " + event.errorID + ", " + event.subErrorID + ", " + event.text );
}
public function onPlayStatus( info:Object ):void
{
preloadStream.close();
}
DRM-related members and events of the NetStream
class
Flash Player 10.1 and later, Adobe AIR 1.0 and later
The NetStream class provides a one-way streaming connection between Flash Player or an AIR application, and either
Flash Media Server or the local file system. (The NetStream class also supports progressive download.) A NetStream
object is a channel within a NetConnection object. The NetStream class dispatches four DRM-related events:
Event Description
drmAuthenticate
(AIR only)
Defined in the DRMAuthenticateEvent class. This event is dispatched when a NetStream object tries to play
protected content that requires a user credential for authentication before playback.
The properties of this event include header, usernamePrompt, passwordPrompt, and urlPrompt properties
that can be used in obtaining and setting the user’s credentials. This event occurs repeatedly until the
NetStream object receives valid user credentials.
drmError Defined in the DRMErrorEvent class and dispatched when a NetStream object tries to play protected content
and encounters a DRM-related error. For example, DRM error event object is dispatched when the user
authorization fails. This error could occur because the user has not purchased the rights to view the content.
It could also occur because the content provider does not support the viewing application.
drmStatus Defined in the DRMStatusEvent class. This event is dispatched when the protected content begins playing
(when the user is authenticated and authorized to play the content). The DRMStatusEvent object contains
information related to the voucher. Voucher information includes whether the content can be made available
offline or when the voucher expires and the content can no longer be viewed.
status Defined in events.StatusEvent and only dispatched when the application attempts to play protected content,
by invoking the NetStream.play() method. The value of the status code property is "DRM.encryptedFLV".
The NetStream class includes the following DRM-specific methods, for use in AIR only:
Last updated 6/6/2012
534