Arbeitsablauf für geschützte Inhalte

Verwenden Sie ein URLLoader-Objekt, um die Bytes der Metadaten-Datei des geschützten Inhalts zu laden. Stellen Sie dieses Objekt auf eine Variable ein, wie beispielsweise metadata_bytes .

Alle von Adobe Access kontrollierten Inhalte verfügen über Adobe Access-Metadaten. Wenn der Inhalt verpackt wird, können diese Metadaten als separate Datei (.metadata) mit dem Inhalt gespeichert werden. Weitere Informationen finden Sie in der Dokumentation zu Adobe Access.

Erstellen Sie eine DRMContentData-Instanz. Fügen Sie diesen Code in einen try-catch-Block ein:

new DRMContentData( metadata_bytes )

Dabei ist metadata_bytes das URLLoader-Objekt aus Schritt 1.

(Nur Flash Player) Die Laufzeit sucht das Adobe Access-Modul. Falls es nicht gefunden wird, wird ein IllegalOperationError mit DRMErrorEvent-Fehlercode 3344 oder DRMErrorEvent-Fehlercode 3343 ausgegeben.

Zur Verarbeitung dieses Fehlers laden Sie das Adobe Access-Modul über die SystemUpdater-API herunter. Nachdem dieses Modul heruntergeladen wurde, löst das SystemUpdater-Objekt ein COMPLETE-Ereignis aus. Fügen Sie einen Ereignis-Listener für dieses Ereignis ein, mit dem der Arbeitsablauf zu Schritt 2 zurückkehrt, wenn dieses Ereignis ausgelöst wird. Diese Schritte werden im folgenden Codebeispiel gezeigt:

flash.system.SystemUpdater.addEventListener(Event.COMPLETE, updateCompleteHandler); 
flash.system.SystemUpdater.update(flash.system.SystemUpdaterType.DRM)

private function updateCompleteHandler (event:Event):void { 
    /*redo step 2*/ 
    drmContentData = new DRMContentData(metadata_bytes); 
} 

Wenn der Player selbst aktualisiert werden muss, wird ein Statusereignis ausgelöst. Weitere Informationen zur Verarbeitung dieses Ereignisses finden Sie unter Warten auf ein Aktualisierungsereignis .

Erstellen Sie Listener, die auf die vom DRMManager-Objekt ausgelösten DRMStatusEvent- und DRMErrorEvent-Ereignisse warten:

DRMManager.addEventListener(DRMStatusEvent.DRM_STATUS, onDRMStatus); 
DRMManager.addEventListener(DRMErrorEvent.DRM_ERROR, onDRMError);

Stellen Sie im DRMStatusEvent-Listener sicher, dass der Gutschein gültig (nicht null) ist. Verarbeiten Sie im DRMErrorEvent-Listener die DRMErrorEvents-Ereignisse. Einzelheiten finden Sie unter Verwenden der DRMStatusEvent-Klasse und Verwenden der DRMErrorEvent-Klasse .

Laden Sie den Gutschein (Lizenz) zum Abspielen des Inhalts.

Versuchen Sie zunächst, eine lokal gespeicherte Lizenz zu laden:

DRMManager.loadvoucher(drmContentData, LoadVoucherSetting.LOCAL_ONLY)

Nach abgeschlossenem Ladevorgang löst das DRMManager-Objekt ein DRMStatusEvent.DRM_Status -Ereignis aus.

Wenn das DRMVoucher-Objekt nicht null ist, ist der Gutschein gültig. Fahren Sie mit Schritt 13 fort.

Wenn das DRMVoucher-Objekt null ist, überprüfen Sie die Authentifizierungsmethode, die die Richtlinie für diesen Inhalt vorgibt. Verwenden Sie die DRMContentData.authenticationMethod -Eigenschaft.

Wenn die Authentifizierungsmethode ANONYMOUS ist, fahren Sie mit Schritt 13 fort.

Bei der Authentifizierungsmethode USERNAME_AND_PASSWORD muss die Anwendung einen Mechanismus bereitstellen, über den der Benutzer seine Anmeldedaten eingeben kann. Übergeben Sie diese Anmeldedaten an den Lizenzserver, um den Benutzer zu authentifizieren:

DRMManager.authenticate(metadata.serverURL, metadata.domain, username, password)

Das DRMManager-Objekt löst ein DRMAuthenticationErrorEvent -Ereignis aus, wenn die Authentifizierung fehlschlägt, bzw. ein DRMAuthenticationCompleteEvent -Ereignis, wenn die Authentifizierung erfolgreich ist. Erstellen Sie Listener für diese Ereignisse.

Wenn die Authentifizierungsmethode UNKNOWN ist, muss eine benutzerdefinierte Authentifizierungsmethode verwendet werden. In diesem Fall hat der Content-Provider vorgesehen, dass die Authentifizierung auf eine Out-of-Band-Weise erfolgt, indem die ActionScript 3.0-APIs nicht verwendet werden. Das benutzerdefinierte Authentifizierungsverfahren muss ein Authentifizierungstoken erzeugen, das an die DRMManager.setAuthenticationToken() -Methode übergeben werden kann.

Wenn die Authentifizierung fehlschlägt, muss die Anwendung zu Schritt 9 zurückkehren. Ihre Anwendung sollte einen Mechanismus enthalten, der wiederholte Authentifizierungsfehler verarbeitet und einschränkt. Beispielsweise kann nach drei Versuchen eine Meldung eingeblendet werden, die dem Benutzer mitteilt, dass die Authentifizierung erfolglos war und der Inhalt deshalb nicht abgespielt werden kann.

Wenn Sie das gespeicherte Token verwenden möchten, anstatt den Benutzer zur Eingabe seiner Anmeldedaten aufzufordern, geben Sie das Token mit der DRMManager.setAuthenticationToken() -Methode an. Dann laden Sie die Lizenz vom Lizenzserver herunter und spielen den Inhalt ab, wie in Schritt 8.

(Optional) Wenn die Authentifizierung erfolgreich ist, können Sie das Authentifizierungstoken erfassen. Dies ist ein im Arbeitsspeicher zwischengespeichertes Byte-Array. Rufen Sie dieses Token mit der DRMAuthenticationCompleteEvent.token -Eigenschaft ab. Sie können das Authentifizierungstoken speichern, damit der Benutzer seine Anmeldedaten für diesen Inhalt nicht mehrfach eingeben muss. Der Lizenzserver bestimmt den Gültigkeitszeitraum des Authentifizierungstokens.

Bei erfolgreicher Authentifizierung laden Sie die Lizenz vom Lizenzserver herunter.

DRMManager.loadvoucher(drmContentData, LoadVoucherSetting.FORCE_REFRESH)

Nach abgeschlossenem Ladevorgang löst das DRMManager-Objekt ein DRMStatusEvent.DRM_STATUS-Ereignis aus. Warten Sie auf dieses Ereignis. Wenn es ausgelöst wird, kann der Inhalt wiedergegeben werden.

Spielen Sie das Video ab, indem Sie ein NetStream-Objekt erstellen und dann seine play() -Methode aufrufen:

stream = new NetStream(connection); 
stream.addEventListener(DRMStatusEvent.DRM _STATUS, drmStatusHandler); 
stream.addEventListener(DRMErrorEvent.DRM_ERROR, drmErrorHandler); 
stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); 
stream.client = new CustomClient(); 
video.attachNetStream(stream); 
stream.play(videoURL); 

authenticate()

setAuthenticationToken()

Die Anwendung erstellt ein DRMContentData -Objekt, contentData1 , das AdobeCP1 als DRM-Modul verwendet.

Die Anwendung ruft die DRMManager.authenticate(contentData1.serverURL,...) -Methode auf.

Die Anwendung ruft die DRMManager.loadVoucher(contentData1, ...) -Methode auf.