Förstå arbetsflödet för skyddat innehåll

Följande steg beskriver hur du läser in vouchern för en skyddad mediefil i förväg med ett DRMContentData-objekt.

1. Hämta binära metadata för det packade innehållet. Om du använder referenspaketeraren för Java i Flash Access genereras denna metadatafil automatiskt med filtillägget .metadata. Du skulle till exempel kunna hämta dessa metadata med klassen URLLoader.

2. Skapa ett DRMContentData-objekt och skicka metadata till konstruktorfunktionen:

   var drmData:DRMContentData = new DRMContentData( metadata );

3. Resten av stegen är identiska med arbetsflödet som beskrivs i Förstå arbetsflödet för skyddat innehåll.

Följande steg beskriver hur du läser in vouchern för en DRM-skyddad mediefil i förväg med preloadEmbeddedMetadata():

1. Hämta och lagra mediefilen. (DRM-metadata kan bara läsas in i förväg från filer som är lagrade på den lokala datorn.)

2. Skapa objekten NetConnection och NetStream, och ange implementeringar för callback-funktionerna onDRMContentData() och onPlayStatus() för NetStream client-objektet.

3. Skapa ett NetStreamPlayOptions-objekt och associera egenskapen stream med den lokala mediefilens URL.

4. Anropa preloadEmbeddedMetadata()-metoden i NetStream-klassen och ange NetStreamPlayOptions-objektet som identifierar den mediefil som ska tolkas.

5. Om mediefilen innehåller DRM-metadata anropas callback-funktionen onDRMContentData(). Metadata skickas till den här funktionen som ett DRMContentData-objekt.

6. Använd objektet DRMContentData för att erhålla vouchern med hjälp av loadVoucher()-metoden för DRMManager-objektet.

   Om egenskapen authenticationMethod för objektet DRMContentData har värdet userNameAndPassword autentiserar du användaren på mediarättighetsservern innan vouchern läses in. Egenskaperna serverURL och domain i DRMContentData-objektet kan överföras till authenticate()-metoden i DRMManager, tillsammans med användarens autentiseringsuppgifter.

7. Callback-funktionen onPlayStatus() anropas när filtolkningen är slutförd. Om onDRMContentData()-funktionen inte har anropats innehåller filen inte de metadata som krävs för att få en voucher. Det saknade anropet kan också medföra att Flash Access inte skyddar den här filen.

Följande kodexempel för AIR illustrerar hur du läser in en voucher för en lokal mediefil i förväg:

package 
{ 
import flash.display.Sprite; 
import flash.events.DRMAuthenticationCompleteEvent; 
import flash.events.DRMAuthenticationErrorEvent; 
import flash.events.DRMErrorEvent;   
import flash.ev ents.DRMStatusEvent; 
import flash.events.NetStatusEvent; 
import flash.net.NetConnection; 
import flash.net.NetStream; 
import flash.net.NetStreamPlayOptions; 
import flash.net.drm.AuthenticationMethod; 
import flash.net.drm.DRMContentData; 
import flash.net.drm.DRMManager; 
import flash.net.drm.LoadVoucherSetting;   
public class DRMPreloader extends Sprite  
{ 
     private var videoURL:String = "app-storage:/video.flv"; 
    private var userName:String = "user"; 
    private var password:String = "password";  
    private var preloadConnection:NetConnection; 
    private var preloadStream:NetStream; 
    private var drmManager:DRMManager = DRMManager.getDRMManager(); 
    private var drmContentData:DRMContentData; 
    public function DRMPreloader():void { 
        drmManager.addEventListener( 
            DRMAuthenticationCompleteEvent.AUTHENTICATION_COMPLETE, 
            onAuthenticationComplete); 
        drmManager.addEventListener(DRMAuthenticationErrorEvent.AUTHENTICATION_ERROR, 
            onAuthenticationError);             
        drmManager.addEventListener(DRMStatusEvent.DRM_STATUS, onDRMStatus); 
        drmManager.addEventListener(DRMErrorEvent.DRM_ERROR, onDRMError); 
        preloadConnection = new NetConnection(); 
        preloadConnection.addEventListener(NetStatusEvent.NET_STATUS, onConnect); 
        preloadConnection.connect(null);            
    } 
 
    private function onConnect( event:NetStatusEvent ):void 
    { 
        preloadMetadata(); 
    } 
    private function preloadMetadata():void 
    { 
        preloadStream = new NetStream( preloadConnection ); 
        preloadStream.client = this; 
        var options:NetStreamPlayOptions = new NetStreamPlayOptions(); 
        options.streamName = videoURL; 
        preloadStream.preloadEmbeddedData( options );                         
    }     
    public function onDRMContentData( drmMetadata:DRMContentData ):void 
    { 
        drmContentData = drmMetadata; 
        if ( drmMetadata.authenticationMethod == AuthenticationMethod.USERNAME_AND_PASSWORD ) 
        { 
            authenticateUser(); 
        } 
        else 
            { 
                getVoucher(); 
            } 
    } 
    private function getVoucher():void 
    { 
        drmManager.loadVoucher( drmContentData, LoadVoucherSetting.ALLOW_SERVER ); 
    } 
 
    private function authenticateUser():void 
    { 
        drmManager.authenticate( drmContentData.serverURL, drmContentData.domain, userName, password ); 
    } 
    private function onAuthenticationError( event:DRMAuthenticationErrorEvent ):void 
    { 
        trace( "Authentication error: " + event.errorID + ", " + event.subErrorID ); 
    } 
 
    private function onAuthenticationComplete( event:DRMAuthenticationCompleteEvent ):void 
    { 
        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(); 
    } 
} 
}