Nozioni fondamentali sul flusso di contenuto protetto

I passaggi seguenti descrivono il flusso di lavoro di precaricamento del voucher per un file multimediale protetto utilizzando un oggetto DRMContentData.

1. Recuperate i metadati binari per il contenuto inserito in un pacchetto. Se utilizzate Java Reference Packager di Flash Access, questo file di metadati viene automaticamente generato con un'estensione .metadata. Potete, ad esempio, scaricare questi metadati utilizzando la classe URLLoader.

2. Create un oggetto DRMContentData, passando i metadati alla funzione di costruzione:

   var drmData:DRMContentData = new DRMContentData( metadata );

3. I passaggi rimanenti sono identici al flusso di lavoro descritto in Nozioni fondamentali sul flusso di contenuto protetto.

Di seguito viene descritto il flusso di lavoro per precaricare il voucher per un file multimediale protetto da DRM utilizzando preloadEmbeddedMetadata().

1. Scaricate e archiviate il file multimediale. (I metadati DRM possono essere precaricati solo da file archiviati localmente).

2. Create gli oggetti NetConnection e NetStream, fornendo le implementazioni per le funzioni di callback onDRMContentData() e onPlayStatus() dell'oggetto client NetStream.

3. Create un oggetto NetStreamPlayOptions e impostate la proprietà stream sull'URL del file multimediale locale.

4. Chiamate il metodo preloadEmbeddedMetadata()della classe NetStream, passando l'oggetto NetStreamPlayOptions che identifica il file multimediale da analizzare.

5. Se il file multimediale contiene metadati DRM, viene richiamata la funzione di callback onDRMContentData(). I metadati vengono passati a questa funzione come un oggetto DRMContentData.

6. Utilizzate l'oggetto DRMContentData per ottenere il voucher, utilizzando il metodo loadVoucher() della classe DRMManager.

   Se il valore della proprietà authenticationMethod dell'oggetto DRMContentData è userNameAndPassword, autenticate l'utente sul server di gestione dei diritti multimediali prima di caricare il voucher. Le proprietà serverURL e domain dell'oggetto DRMContentData possono essere passate al metodo DRMManager authenticate() della classe DRMManager insieme alle credenziali dell'utente.

7. La funzione di callback onPlayStatus() viene richiamata al termine dell'analisi del file. Se la funzione onDRMContentData() non è stata chiamata, il file non contiene i metadati richiesti per ottenere un voucher. La chiamata mancante può anche significare che Flash Access non protegge questo file.

L'esempio di codice per AIR riportato di seguito illustra come precaricare un voucher per un file multimediale locale:

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(); 
    } 
} 
}