Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
Digitale Rechteverwaltung
Ausführlicher API-Arbeitsablauf
Flash Player 10.1 und höher, AIR 2.0 und höher
Im Folgenden wird der Arbeitsablauf für geschützte Inhalte ausführlicher beschrieben. Dabei werden auch die APIs
vorgestellt, die für die Wiedergabe von durch Flash Access geschützten Inhalten verwendet werden.
1 Verwenden Sie ein URLLoader-Objekt, um die Byte der Metadaten-Datei des geschützten Inhalts zu laden. Stellen
Sie dieses Objekt auf eine Variable ein, wie beispielsweise metadata_bytes.
Alle von Flash Access kontrollierten Inhalte verfügen über Flash 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 Flash Access.
2 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.
3 (Nur Flash Player) Die Laufzeit sucht das Flash 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 Flash 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“ auf Seite 577.
Hinweis: In AIR-Anwendungen ist das AIR-Installationsprogramm für die Aktualisierung des Flash Access-Moduls
und die erforderlichen Laufzeitaktualisierungen zuständig.
4 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“ auf Seite 569 und „Verwenden der DRMErrorEvent-Klasse“ auf Seite 574.
5 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.
6 Wenn das DRMVoucher-Objekt nicht null ist, ist der Gutschein gültig. Fahren Sie mit Schritt 13 fort.
Letzte Aktualisierung 27.6.2012
561