| Paket | flash.net.drm |
| Klasse | public class DRMManager |
| Vererbung | DRMManager  EventDispatcher Object |
| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5, Flash Player 10.1 |
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
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
 | constructor : 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 | ||
| Methode | Definiert von | ||
|---|---|---|---|
| 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 | |
fügt das zurzeit laufende Gerät einer Gerätegruppe hinzu. | DRMManager | ||
Authentifiziert einen Benutzer. | DRMManager | ||
|
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | |
[statisch]
Gibt eine Instanz des Singleton-DRMManager-Objekts zurück. | DRMManager | ||
|
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | |
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
|
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 | ||
Lädt einen Gutschein von einem Medienrechteserver oder aus dem lokalen Gutschein-Cache. | DRMManager | ||
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
|
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 | ||
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 | ||
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
| DRMManager | |||
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
|
Gibt das angegebene Objekt als String zurück. | Object | |
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
|
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher | |
| Ereignis | Übersicht | Definiert von | ||
|---|---|---|---|---|
| [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 | |||
| [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 | |||
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():BooleannetworkIdleTimeout | Eigenschaft |
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ückgabewerteDRMManager |
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 |
authenticationComplete | Ereignis |
flash.events.DRMAuthenticationCompleteEventEigenschaft 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.
authenticationError | Ereignis |
flash.events.DRMAuthenticationErrorEventEigenschaft 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.
drmError | Ereignis |
flash.events.DRMErrorEventEigenschaft 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.
DRMErrorEvent.DRM_ERROR definiert den Wert der type-Eigenschaft eines drmError-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
errorID | Ein dem Problem zugewiesener Fehlercode im Zahlenformat. |
subErrorID | Ein Fehlercode, der ausführlichere Informationen zum zugrundeliegenden Problem angibt. |
target | Das NetStream-Objekt. |
drmStatus | Ereignis |
flash.events.DRMStatusEventEigenschaft 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.
DieDRMStatusEvent.DRM_STATUS-Konstante definiert den Wert der type-Eigenschaft eines drmStatus-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
detail | Ein String, der den Kontext des Statusereignisses erläutert. |
isAnonymous | Gibt an, ob der mit DRM-Verschlüsselung geschützte Inhalt verfügbar ist, ohne dass der Benutzer Authentifizierungsdaten eingeben muss. |
isAvailableOffline | Gibt an, ob der mit DRM-Verschlüsselung geschützte Inhalt offline verfügbar ist. |
offlineLeasePeriod | Die verbleibende Anzahl der Tage, an denen der Inhalt offline angezeigt werden kann. |
Richtlinien | Ein benutzerdefiniertes Objekt des DRM-Statusereignisses. |
target | Das NetStream-Objekt. |
voucherEndDate | Das absolute Datum, an dem der Gutschein abläuft und der Inhalt nicht mehr von Benutzern angezeigt werden kann. |
contentData | Die DRMContentData für den Inhalt. |
voucher | Das DRMVoucher-Objekt für den Inhalt. |
isLocal | Gibt an, ob der Inhalt im lokalen Dateisystem gespeichert ist. |
Tue Jun 12 2018, 10:04 AM Z