ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
flash.net.drm 

DRMManager  - AS3

Paketflash.net.drm
Klassepublic class DRMManager
VererbungDRMManager Inheritance EventDispatcher Inheritance Object

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.5, Flash Player 10.1

DRMManager verwaltet Abruf und Speicherung der zum Anzeigen von DRM-geschützten Inhalten benötigten Gutscheine. Mit der statischen DRMManager.getDRMManager()-Methode haben Sie Zugriff auf das vorhandene DRMManager-Objekt, um die folgenden DRM-Management-Aufgaben auszuführen:
  • Vorausladen von Gutscheinen mithilfe eines DRMContentData-Objekts von einem Medienrechteserver.
  • Abfragen des lokalen Cache nach einem einzelnen Gutschein über ein DRMContentData-Objekt.
  • Zurücksetzen aller Gutscheine (nur AIR)

Für die Auflistung aller Gutscheine im lokalen Cache ist keine Methode zur Verfügung gestellt.

Erstellen Sie keine Instanz der DRMManager-Klasse. Verwenden Sie die statische DRMManager.getDRMManager()-Methode, um auf das vorhandene DRMManager-Objekt zuzugreifen.

Unterstützung von AIR-Profilen: Diese Funktion wird unter allen Desktopbetriebssystemen und auf Geräten mit AIR für TV unterstützt, jedoch nicht auf mobilen Geräten. Mit der DRMManager.isSupported-Eigenschaft können Sie testen, ob zur Laufzeit Unterstützung gegeben ist. Weitere Informationen zum AIR-Support über mehrere Profile finden Sie unter Unterstützung von AIR-Profilen.

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  isSupported : Boolean
[statisch] [schreibgeschützt] Die isSupported-Eigenschaft hat den Wert „true“, wenn die DRMManager-Klasse von der aktuellen Plattform unterstützt wird, andernfalls hat sie den Wert „false“.
DRMManager
  networkIdleTimeout : Number
[statisch]
DRMManager
Öffentliche Methoden
 MethodeDefiniert von
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.
EventDispatcher
  
addToDeviceGroup(deviceGroup:DRMDeviceGroup, forceRefresh:Boolean = false):void
fügt das zurzeit laufende Gerät einer Gerätegruppe hinzu.
DRMManager
  
authenticate(serverURL:String, domain:String, username:String, password:String):void
Authentifiziert einen Benutzer.
DRMManager
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
  
[statisch] Gibt eine Instanz des Singleton-DRMManager-Objekts zurück.
DRMManager
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
  
Ruft einen Vorschaugutschein vom Lizenzserver ab, damit ein Benutzer überprüfen kann, dass er den Inhalt auf einem bestimmten Computer anzeigen kann.
DRMManager
  
loadVoucher(contentData:DRMContentData, setting:String):void
Lädt einen Gutschein von einem Medienrechteserver oder aus dem lokalen Gutschein-Cache.
DRMManager
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
  
Entfernt das zurzeit laufende Gerät aus einer Gerätegruppe.
DRMManager
  
In AIR-Anwendungen werden dadurch alle lokal gespeicherten Digital Rights Management (DRM)-Gutscheindaten gelöscht.
DRMManager
  
returnVoucher(inServerURL:String, immediateCommit:Boolean, licenseID:String, policyID:String):void
Gibt dem Lizenzserver alle Gutscheine zurück, die bestimmten Kriterien entsprechen.
DRMManager
  
Legt das Authentifizierungstoken für die Kommunikation mit dem angegebenen Server und der angegebenen Domäne fest.
DRMManager
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
  
DRMManager
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
EventDispatcher
Ereignisse
 Ereignis Übersicht Definiert von
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
  DRMManager löst ein DRMAuthenticationCompleteEvent-Objekt aus, wenn der Benutzer nach einem Aufruf der authenticate()-Methode nicht beim Medienrechteserver authentifiziert wurde.DRMManager
  DRMManager löst ein DRMAuthenticationErrorEvent-Objekt aus, wenn der Benutzer nach einem Aufruf der authenticate()-Methode nicht beim Medienrechteserver authentifiziert wurde.DRMManager
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.EventDispatcher
  DRMManager löst ein DRMErrorEvent-Objekt aus, wenn ein angeforderter Gutschein nicht vom Medienrechteserver bezogen werden kann.DRMManager
  DRMManager löst ein DRMStatusEvent-Objekt aus, wenn ein angeforderter Gutschein vom Medienrechteserver bezogen wird.DRMManager
Eigenschaftendetails

isSupported

Eigenschaft
isSupported:Boolean  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10.1, AIR 2

Die isSupported-Eigenschaft hat den Wert true, wenn die DRMManager-Klasse von der aktuellen Plattform unterstützt wird, andernfalls hat sie den Wert false.



Implementierung
    public static function get isSupported():Boolean

networkIdleTimeout

Eigenschaft 
networkIdleTimeout:Number



Implementierung
    public static function get networkIdleTimeout():Number
    public static function set networkIdleTimeout(value:Number):void
Methodendetails

addToDeviceGroup

()Methode
public function addToDeviceGroup(deviceGroup:DRMDeviceGroup, forceRefresh:Boolean = false):void

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 3.0, Flash Player 11.9

fügt das zurzeit laufende Gerät einer Gerätegruppe hinzu.

Parameter

deviceGroup:DRMDeviceGroup
 
forceRefresh:Boolean (default = false)

authenticate

()Methode 
public function authenticate(serverURL:String, domain:String, username:String, password:String):void

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.5, Flash Player 10.1

Authentifiziert einen Benutzer.

Hört das authenticationComplete- und authenticationError-Ereignis ab, um das Ergebnis des Authentifizierungsversuchs zu ermitteln. Mehrere authenticate()-Aufrufe werden in eine Warteschlange gestellt. Das AuthenticationCompleteEvent-Objekt, das für das authenticationComplete-Ereignis ausgelöst wird, enthält einen Anwendungstoken, den Ihre Anwendung speichern kann.

Sie können einen gespeicherten Authentifizierungstoken oder einen auf eine andere Weise heruntergeladenen Token verwenden, um in Zukunft eine authentifizierte Sitzung mit dem Medienrechteserver herzustellen. Um eine Sitzung mit einem Token herzustellen, rufen Sie die DRMManager setAuthenticationToken()-Methode auf. Die Eigenschaften des Tokens wie z. B. das Ablaufdatum werden über die Einstellungen des Servers bestimmt, der das Token generiert.

Wichtig (nur AIR): Die authenticate()-Methode schlägt fehl, wenn der Internetanschluss eines Benutzers über einen Proxyserver erfolgt, der eine Authentifizierung erfordert. Diese Benutzer können zwar keinen DRM-Gutschein, der eine Authentifizierung erfordert, vorausladen, aber Ihre Anwendung kann den Gutschein beziehen, indem mit der Wiedergabe begonnen und die NetStream setAuthenticationCredentials()-Methode verwendet wird, um den Benutzer sowohl beim Proxy- als auch beim Medienrechteserver anzumelden. Sobald der Gutschein bezogen wurde, kann der Benutzer den Inhalt offline anzeigen (solange die durch den Gutschein repräsentierte Lizenz eine Offline-Wiedergabe erlaubt).

Parameter

serverURL:String — Die URL eines Medienrechteservers, die einen Gutschein zum Anzeigen von geschütztem Inhalt liefern kann
 
domain:String — Eine Domäne auf dem Server (kein Netzwerk-/Internetdomänenname)
 
username:String — Der Benutzername
 
password:String — Das Benutzerkennwort

Verwandte API-Elemente

getDRMManager

()Methode 
public static function getDRMManager():DRMManager

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.5, Flash Player 10.1

Gibt eine Instanz des Singleton-DRMManager-Objekts zurück.

Für jede Sicherheitsdomäne gibt es eine DRMManager-Instanz.

Rückgabewerte
DRMManager

Verwandte API-Elemente

loadPreviewVoucher

()Methode 
public function loadPreviewVoucher(contentData:DRMContentData):void

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 2, Flash Player 10.1

Ruft einen Vorschaugutschein vom Lizenzserver ab, damit ein Benutzer überprüfen kann, dass er den Inhalt auf einem bestimmten Computer anzeigen kann. Mit dieser Fähigkeit können Benutzer überprüfen, ob sie Inhalt auf ihrem Computer abspielen können, bevor sie den Inhalt kaufen und herunterladen. Dies ist nützlich, wenn der Computer des Benutzers nicht über die erforderlichen Ausgabeschutzfähigkeiten oder die erforderliche Software verfügt, um den Inhalt abzuspielen.

Wie loadVoucher() ist diese Methode ein asynchroner Aufruf und gibt ein DRMStatusEvent bei erfolgreichem Abschluss oder ein DRMErrorEvent bei einem Fehlschlagen aus.

Parameter

contentData:DRMContentData

loadVoucher

()Methode 
public function loadVoucher(contentData:DRMContentData, setting:String):void

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.5, Flash Player 10.1

Lädt einen Gutschein von einem Medienrechteserver oder aus dem lokalen Gutschein-Cache.

Der Gutschein wird entsprechend dem setting-Parameter geladen:

  • LoadVoucherSetting.FORCE_REFRESH: Der Gutschein wird immer vom Medienrechteserver heruntergeladen.
  • LoadVoucherSetting.LOCAL_ONLY: Der Gutschein wird nur aus dem lokalen Cache geladen.
  • LoadVoucherSetting.ALLOW_SERVER: Der Gutschein wird nach Möglichkeit aus dem lokalen Cache geladen, andernfalls wird er vom Server heruntergeladen.

Die LoadVoucherSetting-Klasse definiert Stringkonstanten für die Verwendung als Werte für den setting-Parameter.

Wenn der Gutschein erfolgreich geladen ist, löst DRMManager ein DRM-Statusereignis aus. Ihre Anwendung kann mit der Wiedergabe beginnen, sobald der Gutschein geladen ist. Der geladene Gutschein ist in der voucher-Eigenschaft des ausgelösten DRMStatusEvent-Objekts verfügbar. Sie können dieses Voucher-Objekt verwenden, um Informationen zu den Medienrechten für den Benutzer anzuzeigen.

Wenn ein Gutschein nicht vom Medienrechteserver geladen werden kann, wird ein DRM-Fehlerereignis ausgelöst. Die errorID-Eigenschaft des ausgelösten DRMErrorEvent-Objekts zeigt den Grund für den Fehler an. Häufige Ursachen für Fehler sind der Versuch, eine Verbindung zum Medienrechteserver herzustellen, wenn der Benutzer offline ist, und der Versuch, einen Gutschein zu laden, wenn der Benutzer nicht angemeldet ist. Ihre Anwendung kann auf diese Fehler reagieren und entsprechende Korrekturmaßnahmen ergreifen. Wenn beispielsweise Authentifizierungsdaten zum Herunterladen des Gutscheins erforderlich sind, können Sie den Benutzer zur Eingabe seines Benutzernamens und Kennworts auffordern, die DRMManager authenticate()-Methode aufrufen und dann versuchen, den Gutschein erneut zu laden.

Wenn ein Gutschein nicht aus dem lokalen Cache bezogen werden kann und die localOnly-Einstellung verwendet wird, wird kein DRMErrorEvent ausgelöst. Stattdessen wird ein DRM-Statusereignis ausgelöst. Die detail-Eigenschaft dieses DRMStatusEvent-Objekts ist weiterhin DRM.voucherObtained, aber die voucher-Eigenschaft ist null.

Parameter

contentData:DRMContentData — Das DRMContentData-Objekt aus einer DRM-geschützten Mediendatei
 
setting:String — Bestimmt, ob der Gutschein aus dem lokalen Cache oder vom Medienrechteserver abgerufen werden soll

removeFromDeviceGroup

()Methode 
public function removeFromDeviceGroup(deviceGroup:DRMDeviceGroup):void

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 3.0, Flash Player 11.9

Entfernt das zurzeit laufende Gerät aus einer Gerätegruppe.

Parameter

deviceGroup:DRMDeviceGroup

resetDRMVouchers

()Methode 
public function resetDRMVouchers():void

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.5, Flash Player 11.8

In AIR-Anwendungen werden dadurch alle lokal gespeicherten Digital Rights Management (DRM)-Gutscheindaten gelöscht. Für browserbasierte Anwendungen ist dies nur während 3322, 3346, 3323, 3326-Fehlern verfügbar und funktioniert wie das Einstellungsbedienfeld von Protected Content Playback.

Die Anwendung muss die erforderlichen Gutscheine erneut herunterladen, damit der Benutzer auf verschlüsselten Inhalt zugreifen kann. Das Aufrufen dieser Funktion entspricht dem Aufrufen von Netstream.resetDRMVouchers().


Auslöser
IOError — Die Gutscheindaten können nicht gelöscht werden.

Verwandte API-Elemente

returnVoucher

()Methode 
public function returnVoucher(inServerURL:String, immediateCommit:Boolean, licenseID:String, policyID:String):void

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 11.8, AIR 3.8

Gibt dem Lizenzserver alle Gutscheine zurück, die bestimmten Kriterien entsprechen. Wenn ein Gutschein zurückgegeben wird, wird er vom Festplattenspeicher und aus dem Arbeitsspeicher entfernt. Dies unterbricht nicht Netstreams und AVStreams, die gerade die zurückgegebenen Gutscheine für eine Videowiedergabe verwenden, aber verhindert eine zukünftige Wiedergabe. DRMManager gibt ein DRMReturnVoucherCompleteEvent bei Erfolg oder ein DRMReturnVoucherErrorEvent bei einem Fehler aus. Wird einen ArgumentError ausgegeben, wenn inServerURL null ist, oder wenn licenseID und policyID beide null sind.

Parameter

inServerURL:String — Die Lizenzserver-URL, aus denen die zurückgegebenen Lizenzen heruntergeladen wurden.
 
immediateCommit:Boolean — Reserviert. Der einzige unterstützte Wert ist true.
 
licenseID:String — (optional) Gutscheine, die dieser licenseID entsprechen, werden zurückgegeben. Wenn Null, wird policyID stattdessen verwendet.
 
policyID:String — (optional) Gutscheine, die dieser policyID entsprechen, werden zurückgegeben. Wenn Null, wird licenseID stattdessen verwendet. Wenn sowohl licenseID als auch policyID nicht null sind, werden nur Gutscheine, die sowohl licenseID als auch policyID entsprechen, zurückgegeben.

setAuthenticationToken

()Methode 
public function setAuthenticationToken(serverUrl:String, domain:String, token:ByteArray):void

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.5, Flash Player 10.1

Legt das Authentifizierungstoken für die Kommunikation mit dem angegebenen Server und der angegebenen Domäne fest.

Authentifizierungstoken sind von der token-Eigenschaft des DRMAuthenticationCompleteEvent-Objekts verfügbar, das nach einem erfolgreichen Aufruf der authenticate()-Methode ausgelöst wird. Das Token wird automatisch für die Sitzung im Cache abgelegt, aber Sie können die setAuthenticationToken()-Methode verwenden, um Token direkt zu verwalten.

Wenn Sie ein Token setzen, werden hierdurch alle im Cache abgelegten Token für den Server und die Domäne überschrieben. Setzen Sie den token-Parameter auf null, um das im Cache abgelegte Token zu löschen.

Parameter

serverUrl:String — Die URL des Medienrechteservers
 
domain:String — Die DRMContentData
 
token:ByteArray — Das Authentifizierungstoken

storeVoucher

()Methode 
public function storeVoucher(voucher:ByteArray):void

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 11.0, AIR 3.0

Parameter

voucher:ByteArray

Ereignisdetails

authenticationComplete

Ereignis
Ereignisobjekttyp: flash.events.DRMAuthenticationCompleteEvent
Eigenschaft DRMAuthenticationCompleteEvent.type = flash.events.DRMAuthenticationCompleteEvent.AUTHENTICATION_COMPLETE

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.5, Flash Player 10.1

DRMManager löst ein DRMAuthenticationCompleteEvent-Objekt aus, wenn der Benutzer nach einem Aufruf der authenticate()-Methode nicht beim Medienrechteserver authentifiziert wurde.

Die Stringkonstante im Typparameter beim Hinzufügen und Entfernen von Ereignis-Listenern für das Ereignis bei abgeschlossener Authentifizierung.

authenticationError

Ereignis  
Ereignisobjekttyp: flash.events.DRMAuthenticationErrorEvent
Eigenschaft DRMAuthenticationErrorEvent.type = flash.events.DRMAuthenticationErrorEvent.AUTHENTICATION_ERROR

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.5, Flash Player 10.1

DRMManager löst ein DRMAuthenticationErrorEvent-Objekt aus, wenn der Benutzer nach einem Aufruf der authenticate()-Methode nicht beim Medienrechteserver authentifiziert wurde.

Die im type-Parameter zu verwendende Stringkonstante für das Authentifizierungsfehlerereignis beim Hinzufügen und Entfernen von Ereignis-Listenern.

drmError

Ereignis  
Ereignisobjekttyp: flash.events.DRMErrorEvent
Eigenschaft DRMErrorEvent.type = flash.events.DRMErrorEvent.DRM_ERROR

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.5, Flash Player 10.1

DRMManager löst ein DRMErrorEvent-Objekt aus, wenn ein angeforderter Gutschein nicht vom Medienrechteserver bezogen werden kann.

Hinweis: Wenn ein Versuch, einen Gutschein aus dem lokalen Gutschein-Cache (mit localOnly als source-Parameter) zu laden, fehlschlägt, wird KEIN DRMErrorEvent-Objekt ausgelöst. Stattdessen wird ein DRMStatusEvent-Objekt mit der voucher-Eigenschaft null ausgelöst.

Die Konstante DRMErrorEvent.DRM_ERROR definiert den Wert der type-Eigenschaft eines drmError-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
errorIDEin dem Problem zugewiesener Fehlercode im Zahlenformat.
subErrorIDEin Fehlercode, der ausführlichere Informationen zum zugrundeliegenden Problem angibt.
targetDas NetStream-Objekt.

drmStatus

Ereignis  
Ereignisobjekttyp: flash.events.DRMStatusEvent
Eigenschaft DRMStatusEvent.type = flash.events.DRMStatusEvent.DRM_STATUS

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.5, Flash Player 10.1

DRMManager löst ein DRMStatusEvent-Objekt aus, wenn ein angeforderter Gutschein vom Medienrechteserver bezogen wird.

Die DRMStatusEvent.DRM_STATUS-Konstante definiert den Wert der type-Eigenschaft eines drmStatus-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
detailEin String, der den Kontext des Statusereignisses erläutert.
isAnonymousGibt an, ob der mit DRM-Verschlüsselung geschützte Inhalt verfügbar ist, ohne dass der Benutzer Authentifizierungsdaten eingeben muss.
isAvailableOfflineGibt an, ob der mit DRM-Verschlüsselung geschützte Inhalt offline verfügbar ist.
offlineLeasePeriodDie verbleibende Anzahl der Tage, an denen der Inhalt offline angezeigt werden kann.
RichtlinienEin benutzerdefiniertes Objekt des DRM-Statusereignisses.
targetDas NetStream-Objekt.
voucherEndDateDas absolute Datum, an dem der Gutschein abläuft und der Inhalt nicht mehr von Benutzern angezeigt werden kann.
contentDataDie DRMContentData für den Inhalt.
voucherDas DRMVoucher-Objekt für den Inhalt.
isLocalGibt an, ob der Inhalt im lokalen Dateisystem gespeichert ist.




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.