DRMTrait

Paket	org.osmf.traits
Klasse	public class DRMTrait
Vererbung	DRMTrait MediaTraitBase EventDispatcher Object

Sprachversion:

ActionScript 3.0

Produktversion:

OSMF 1.0

Laufzeitversionen:

Flash Player 10.1, AIR 1.5

DRMTrait definiert die Trait-Schnittstelle für ein Medium, das durch die DRM-Technologie (DRM - Digital Rights Management) geschützt werden kann. Es kann auch als Basisklasse für eine spezifischere DRMTrait-Unterklasse verwendet werden.

Es wird sowohl anonyme Authentifizierung als auch benutzerdatenbasierte Authentifizierung unterstützt.

Der Arbeitsablauf für ein Medium, das über DRMTrait verfügt, besteht darin, dass das Medium authentifiziert wird und danach für ein bestimmtes Zeitfenster gültig ist (d. h. abgespielt werden kann).

Mithilfe der MediaElement.hasTrait(MediaTraitType.DRM)-Methode fragen Sie ab, ob ein Medienelement über dieses Trait (Merkmal) verfügt. Wenn hasTrait(MediaTraitType.DRM) den Wert true zurückgibt, rufen Sie mithilfe der MediaElement.getTrait(MediaTraitType.DRM)-Methode ein Objekt dieses Typs ab.

Öffentliche Eigenschaften

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
		drmState : String [schreibgeschützt] Der aktuelle Status des DRM für dieses Medium.	DRMTrait
		endDate : Date [schreibgeschützt] Das Enddatum für das Wiedergabefenster.	DRMTrait
		period : Number [schreibgeschützt] Die Länge des Wiedergabefensters in Sekunden.	DRMTrait
		startDate : Date [schreibgeschützt] Das Startdatum für das Wiedergabefenster.	DRMTrait
		traitType : String [schreibgeschützt] Der MediaTraitType für dieses Merkmal.	MediaTraitBase

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		DRMTrait() Konstruktor.	DRMTrait
		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
		authenticate(username:String = null, password:String = null):void Authentifiziert die Medien.	DRMTrait
		authenticateWithToken(token:Object):void Authentifiziert die Medien mithilfe eines Objekts, das als Token dient.	DRMTrait
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		dispose():void Entfernt die von diesem Merkmal verwendeten Ressourcen.	MediaTraitBase
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	EventDispatcher

Geschützte Methoden

	Methode		Definiert von
		setDrmState(value:String):void Aktualisiert den drm-Status.	DRMTrait
		setEndDate(value:Date):void Aktualisiert das Enddatum.	DRMTrait
		setPeriod(value:Number):void Aktualisiert den Zeitraum.	DRMTrait
		setStartDate(value:Date):void Aktualisiert das Startdatum.	DRMTrait

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Übersicht	Definiert von
activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher
drmStateChange	Wird ausgelöst, wenn entweder eine anonyme oder benutzerdatenbasierte Authentifizierung für das Abspielen der Medien erforderlich ist.	DRMTrait

Eigenschaftendetails

drmState

Eigenschaft

drmState:String [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

OSMF 1.0

Laufzeitversionen:

Flash Player 10.1, AIR 1.5

Der aktuelle Status des DRM für dieses Medium. Die Status werden in der DRMState-Aufzählung beschrieben.

Implementierung
public function get drmState():String

Verwandte API-Elemente

DRMState

endDate

Eigenschaft

endDate:Date [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

OSMF 1.0

Laufzeitversionen:

Flash Player 10.1, AIR 1.5

Das Enddatum für das Wiedergabefenster. Gibt „null“ zurück, wenn die Authentifizierung noch nicht erfolgt ist.

Implementierung
public function get endDate():Date

period

Eigenschaft

period:Number [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

OSMF 1.0

Laufzeitversionen:

Flash Player 10.1, AIR 1.5

Die Länge des Wiedergabefensters in Sekunden. Gibt NaN zurück, wenn keine Authentifizierung stattgefunden hat

Diese Eigenschaft ist im Allgemeinen die Differenz zwischen startDate und endDate. Sie wurde als Eigenschaft aufgenommen, weil es Fälle geben kann, in denen die Dauer von vorneherein feststeht, aber Anfangs- und Enddatum unbekannt sind (z. B. bei einer einwöchigen Leihfrist).

Implementierung
public function get period():Number

startDate

Eigenschaft

startDate:Date [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

OSMF 1.0

Laufzeitversionen:

Flash Player 10.1, AIR 1.5

Das Startdatum für das Wiedergabefenster. Gibt „null“ zurück, wenn die Authentifizierung noch nicht erfolgt ist.

Implementierung
public function get startDate():Date

Konstruktordetails

()

Konstruktor

public function DRMTrait()

Sprachversion:

ActionScript 3.0

Produktversion:

OSMF 1.0

Laufzeitversionen:

Flash Player 10.1, AIR 1.5

Konstruktor.

Methodendetails

authenticate

()

Methode

public function authenticate(username:String = null, password:String = null):void

Sprachversion:

ActionScript 3.0

Produktversion:

OSMF 1.0

Laufzeitversionen:

Flash Player 10.1, AIR 1.5

Authentifiziert die Medien. Kann sowohl für anonyme als auch benutzerdatenbasierte Authentifizierung verwendet werden. Wenn die Medienauthentifizierung bereits erfolgt ist, ist dies ein Leerbefehl.

Parameter

	`username:String` (default = `null`) — Der Benutzername. Für anonyme Authentifizierung muss dies null sein.

	`password:String` (default = `null`) — Das Kennwort. Für anonyme Authentifizierung muss dies null sein.

Auslöser

IllegalOperationError — Wenn das Medium noch nicht initialisiert wurde.

authenticateWithToken

()

Methode

public function authenticateWithToken(token:Object):void

Sprachversion:

ActionScript 3.0

Produktversion:

OSMF 1.0

Laufzeitversionen:

Flash Player 10.1, AIR 1.5

Authentifiziert die Medien mithilfe eines Objekts, das als Token dient. Kann sowohl für anonyme als auch benutzerdatenbasierte Authentifizierung verwendet werden. Wenn die Medienauthentifizierung bereits erfolgt ist, ist dies ein Leerbefehl.

Parameter

token:Object — Das für die Authentifizierung zu verwendende Token.

setDrmState

()

Methode

protected final function setDrmState(value:String):void

Sprachversion:

ActionScript 3.0

Produktversion:

OSMF 1.0

Laufzeitversionen:

Flash Player 10.1, AIR 1.5

Aktualisiert den drm-Status.

Beachten Sie, dass diese Methode das drmStateChange-Ereignis nicht auslöst.

Parameter

value:String — Der neue Wert für drmState.

setEndDate

()

Methode

protected final function setEndDate(value:Date):void

Sprachversion:

ActionScript 3.0

Produktversion:

OSMF 1.0

Laufzeitversionen:

Flash Player 10.1, AIR 1.5

Aktualisiert das Enddatum.

Parameter

value:Date — Der neue Wert für endDate.

setPeriod

()

Methode

protected final function setPeriod(value:Number):void

Sprachversion:

ActionScript 3.0

Produktversion:

OSMF 1.0

Laufzeitversionen:

Flash Player 10.1, AIR 1.5

Aktualisiert den Zeitraum.

Parameter

value:Number — Der neue Wert für den Zeitraum.

setStartDate

()

Methode

protected final function setStartDate(value:Date):void

Sprachversion:

ActionScript 3.0

Produktversion:

OSMF 1.0

Laufzeitversionen:

Flash Player 10.1, AIR 1.5

Aktualisiert das Startdatum.

Parameter

value:Date — Der neue Wert für startDate.

Ereignisdetails

drmStateChange

Ereignis

Ereignisobjekttyp: org.osmf.events.DRMEvent
Eigenschaft DRMEvent.type = org.osmf.events.DRMEvent.DRM_STATE_CHANGE

Sprachversion:

ActionScript 3.0

Produktversion:

OSMF 1.0

Laufzeitversionen:

Flash Player 10.1, AIR 1.5

Wird ausgelöst, wenn entweder eine anonyme oder benutzerdatenbasierte Authentifizierung für das Abspielen der Medien erforderlich ist.

Die DRMEvent.DRM_STATE_CHANGE-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für eine Änderung des drmState eines DRMTrait.

Rechtliche Hinweise | Onlinedatenschutzerklärung

DRMTrait - AS3 OSMF

Klassen x

drmState

endDate

period

startDate

DRMTrait

authenticate

authenticateWithToken

setDrmState

setEndDate

setPeriod

setStartDate

drmStateChange