DRMManager - Bron voor Adobe ActionScript® 3 (AS3 ) API

Pakket	flash.net.drm
Klasse	public class DRMManager
Overerving	DRMManager EventDispatcher Object

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.5, Flash Player 10.1

De DRMManager beheert het ophalen en opslaan van de vouchers die nodig zijn om met DRM beveiligde inhoud weer te geven. Met de statische methode DRMManager.getDRMManager() kunt u het bestaande DRMManager-object openen om de volgende DRM-beheertaken uit te voeren:

Laadt vouchers vooraf vanaf een mediarechtenserver, met een DRMContentData-object.
Vraag in de lokale cache een afzonderlijke voucher op met een DRMContentData-object.
Alle vouchers herstellen (alleen AIR).

Er is geen methode voor het inventariseren van alle vouchers in de lokale cache.

Maak geen instantie van de DRMManager-klasse. Gebruik de statische functie DRMManager.getDRMManager() om toegang te krijgen tot het bestaande object DRMManager.

AIR-profielondersteuning: Deze functie wordt ondersteund op alle desktopbesturingssystemen en op AIR for TV-apparaten, maar niet op mobiele apparaten. Met de eigenschap DRMManager.isSupported kunt u testen op ondersteuning tijdens runtime. Zie AIR-profielondersteuning voor meer informatie over API-ondersteuning voor meerdere profielen.

Verwante API-elementen

flash.net.NetStream
flash.net.drm.DRMVoucher
flash.net.drm.DRMContentData

Openbare eigenschappen

Overerfde openbare eigenschappen verbergen

Overerfde openbare eigenschappen weergeven

	Eigenschap		Gedefinieerd door
		constructor : Object Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie.	Object
		isSupported : Boolean [statisch] [alleen-lezen] De eigenschap isSupported wordt ingesteld op true als de DRMManager-klasse op het huidige platform wordt ondersteund. Als dit niet het geval is, wordt de eigenschap ingesteld op false.	DRMManager
		networkIdleTimeout : Number [statisch]	DRMManager

Openbare methoden

Overerfde openbare methoden verbergen

Overerfde openbare methoden weergeven

	Methode		Gedefinieerd door
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt.	EventDispatcher
		addToDeviceGroup(deviceGroup:DRMDeviceGroup, forceRefresh:Boolean = false):void voegt het apparaat dat momenteel wordt uitgevoerd, toe aan een apparaatgroep.	DRMManager
		authenticate(serverURL:String, domain:String, username:String, password:String):void Hiermee wordt een gebruiker geverifieerd.	DRMManager
		dispatchEvent(event:Event):Boolean Verzendt een gebeurtenis naar de gebeurtenisstroom.	EventDispatcher
		getDRMManager():DRMManager [statisch] Retourneert een instantie van het singleton object DRMManager.	DRMManager
		hasEventListener(type:String):Boolean Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis.	EventDispatcher
		hasOwnProperty(name:String):Boolean Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd.	Object
		isPrototypeOf(theClass:Object):Boolean Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven.	Object
		loadPreviewVoucher(contentData:DRMContentData):void Haalt een previewvoucher uit de licentieserver, die u kunt gebruiken, zodat de gebruiker kan controleren of ze content op een bepaalde computer kunnen afspelen.	DRMManager
		loadVoucher(contentData:DRMContentData, setting:String):void Laadt een voucher vanaf een mediarechtenserver of uit de lokale vouchercache.	DRMManager
		propertyIsEnumerable(name:String):Boolean Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Verwijdert een listener uit het object EventDispatcher.	EventDispatcher
		removeFromDeviceGroup(deviceGroup:DRMDeviceGroup):void Verwijdert het apparaat dat momenteel wordt uitgevoerd, uit een apparaatgroep.	DRMManager
		resetDRMVouchers():void In AIR-toepassingen worden hiermee alle lokaal in de cache geplaatste vouchergegevens voor Digital Rights Management (DRM) verwijderd.	DRMManager
		returnVoucher(inServerURL:String, immediateCommit:Boolean, licenseID:String, policyID:String):void Hiermee worden alle vouchers die overeenkomen met alle opgegeven criteria geretourneerd naar de licentieserver.	DRMManager
		setAuthenticationToken(serverUrl:String, domain:String, token:ByteArray):void Hiermee wordt het verificatietoken ingesteld dat wordt gebruikt voor de communicatie met de opgegeven server en domein.	DRMManager
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in.	Object
		storeVoucher(voucher:ByteArray):void	DRMManager
		toLocaleString():String Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies.	Object
		toString():String Retourneert een tekenreeksrepresentatie van het opgegeven object.	Object
		valueOf():Object Retourneert de primitieve waarde van het opgegeven object.	Object
		willTrigger(type:String):Boolean Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis.	EventDispatcher

Gebeurtenissen

Klik voor meer informatie over gebeurtenissen.

Overerfde gebeurtenissen verbergen

Overerfde gebeurtenissen weergeven

	Overzicht	Gedefinieerd door
activate	[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de besturingssysteemfocus krijgt en actief wordt.	EventDispatcher
authenticationComplete	De DRMManager verzendt een DRMAuthenticationCompleteEvent-object wanneer de gebruiker door de server met mediarechten is gemachtigd na een aanroep van de methode authenticate().	DRMManager
authenticationError	De DRMManager verzendt een DRMAuthenticationErrorEvent-object wanneer de gebruiker niet door de server met mediarechten is gemachtigd na een aanroep van de methode authenticate().	DRMManager
deactivate	[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de systeemfocus verliest en inactief wordt.	EventDispatcher
drmError	De DRMManager verzendt een DRMErrorEvent-object wanneer een gevraagde voucher niet kan worden verkregen van de server met mediarechten.	DRMManager
drmStatus	De DRMManager verzendt een DRMStatusEvent -object wanneer een gevraagde voucher is verkregen van de server met mediarechten.	DRMManager

Eigenschapdetails

isSupported

eigenschap

isSupported:Boolean [alleen-lezen]

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10.1, AIR 2

De eigenschap isSupported wordt ingesteld op true als de DRMManager-klasse op het huidige platform wordt ondersteund. Als dit niet het geval is, wordt de eigenschap ingesteld op false.

Implementatie
public static function get isSupported():Boolean

networkIdleTimeout

eigenschap

networkIdleTimeout:Number

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

Methodedetails

addToDeviceGroup

()

methode

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

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 3.0, Flash Player 11.9

voegt het apparaat dat momenteel wordt uitgevoerd, toe aan een apparaatgroep.

Parameters

	`deviceGroup:DRMDeviceGroup`

	`forceRefresh:Boolean` (default = `false`)

authenticate

()

methode

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

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.5, Flash Player 10.1

Hiermee wordt een gebruiker geverifieerd.

Luister naar de gebeurtenissen authenticationComplete en authenticationError om het resultaat van de verificatiepoging te bepalen. Meerdere aanroepen van authenticate() worden in een wachtrij geplaatst. Het object AuthenticationCompleteEvent dat voor de gebeurtenis authenticationComplete is verzonden, bevat een verificatietoken dat uw toepassing kan opslaan.

U kunt een opgeslagen verificatietoken, of een token dat u op een andere manier hebt gedownload, gebruiken om in de toekomst een geverifieerde sessie tot stand te brengen met de mediarechtenserver. Als u een sessie tot stand wilt brengen met een token, roept u de DRMManager-methode setAuthenticationToken() aan. De eigenschappen van het token, zoals de vervaldatum, worden bepaald door de instellingen van de server die het token genereert.

Belangrijk (alleen AIR): De authenticate() slaagt niet als de internetverbinding van een gebruiker via een proxyserver loopt die verificatie vereist. Hoewel dergelijke gebruikers een DRM-voucher waarvoor verificatie is vereist niet vooraf kunnen laden, kan uw toepassing de voucher verkrijgen door het afspelen te starten en met de NetStream-methode setAuthenticationCredentials() de gebruiker aan te melden bij de proxyserver en de mediarechtenserver. Wanneer de voucher is verkregen, kan de gebruiker de inhoud offline bekijken (zolang de licentie die door de voucher wordt aangegeven, offline afspelen toestaat).

Parameters

	`serverURL:String` — De URL van een mediarechtenserver die een voucher kan leveren voor het weergeven van beveiligde inhoud

	`domain:String` — Een domein op de server (geen netwerk- of internetdomeinnaam)

	`username:String` — De gebruikersnaam

	`password:String` — Het gebruikerswachtwoord

Verwante API-elementen

flash.net.NetStream.setAuthenticationCredentials()
setAuthenticationToken()

getDRMManager

()

methode

public static function getDRMManager():DRMManager

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.5, Flash Player 10.1

Retourneert een instantie van het singleton object DRMManager.

Er bestaat één DRMManager-instantie voor elk beveiligingsdomein.

Geretourneerde waarde

DRMManager

Verwante API-elementen

flash.system.SecurityDomain

loadPreviewVoucher

()

methode

public function loadPreviewVoucher(contentData:DRMContentData):void

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 2, Flash Player 10.1

Haalt een previewvoucher uit de licentieserver, die u kunt gebruiken, zodat de gebruiker kan controleren of ze content op een bepaalde computer kunnen afspelen. Met deze functie kunnen gebruikers controleren of ze de content op hun computer kunnen afspelen, voordat ze de content kopen en downloaden. Dit is nuttig wanneer de computer van de gebruiker niet de benodigde exportbeveiligingsfuncties of software heeft om de content af te spelen.

Net als loadVoucher() is deze methode een asynchrone oproep en geeft deze na voltooiing een DRMStatusEvent of een DRMErrorEvent bij fouten uit.

Parameters

contentData:DRMContentData

loadVoucher

()

methode

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

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.5, Flash Player 10.1

Laadt een voucher vanaf een mediarechtenserver of uit de lokale vouchercache.

De voucher wordt geladen volgens de parameter setting:

LoadVoucherSetting.FORCE_REFRESH: De voucher wordt altijd gedownload vanaf de mediarechtenserver.
LoadVoucherSetting.LOCAL_ONLY: De voucher wordt alleen uit de lokale cache geladen.
LoadVoucherSetting.ALLOW_SERVER: De voucher wordt geladen uit de lokale cache, indien mogelijk, en anders wordt de voucher gedownload vanaf de server.

De klasse LoadVoucherSetting definieert tekenreeksconstanten die als waarden voor de parameter setting gebruikt moeten worden.

Wanneer het laden van de voucher is geslaagd, verzendt de DRMManager een DRM-statusgebeurtenis. Uw toepassing kan beginnen met afspelen zodra de voucher is geladen. De geladen voucher is beschikbaar in de eigenschap voucher van het verzonden object DRMStatusEvent. U kunt dit voucherobject gebruiken om de bijbehorende mediarechteninformatie weer te geven aan de gebruiker.

Als een voucher niet kan worden geladen vanaf de mediarechtenserver, wordt een DRM-foutgebeurtenis verzonden. De eigenschap errorID van het verzonden object DRMErrorEvent geeft de reden voor deze fout aan. Fouten treden vaak op doordat wordt geprobeerd verbinding te maken met de mediarechtenserver wanneer de gebruiker offline is of doordat wordt geprobeerd een voucher te laden wanneer de gebruiker niet is aangemeld. Uw toepassing kan op deze fouten reageren en deze corrigeren. Als er bijvoorbeeld verificatiereferenties zijn vereist voor het downloaden van de voucher, kunt u de gebruiker vragen om de naam en het wachtwoord van zijn gebruikersaccount, de DRMManager-methode authenticate() aanroepen en vervolgens opnieuw proberen de voucher te laden.

Als een voucher niet kan worden opgehaald uit de lokale cache en de instelling localOnly wordt gebruikt, wordt geen DRMErrorEvent verzonden. In plaats daarvan wordt een DRM-statusgebeurtenis verzonden. De eigenschap detail van dit object DRMStatusEvent is nog steeds DRM.voucherObtained, maar de eigenschap voucher is null.

Parameters

	`contentData:DRMContentData` — Het object DRMContentData uit een met DRM beveiligd mediabestand

	`setting:String` — Bepaalt of de voucher is opgehaald uit de lokale cache of vanaf de mediarechtenserver

removeFromDeviceGroup

()

methode

public function removeFromDeviceGroup(deviceGroup:DRMDeviceGroup):void

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 3.0, Flash Player 11.9

Verwijdert het apparaat dat momenteel wordt uitgevoerd, uit een apparaatgroep.

Parameters

deviceGroup:DRMDeviceGroup

resetDRMVouchers

()

methode

public function resetDRMVouchers():void

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.5, Flash Player 11.8

In AIR-toepassingen worden hiermee alle lokaal in de cache geplaatste vouchergegevens voor Digital Rights Management (DRM) verwijderd. Voor browsergebaseerde toepassingen is dit alleen beschikbaar bij de fouten 3322, 3346, 3323 en 3326 en gedraagt dit zich zoals het deelvenster Instellingen voor het afspelen van beveiligde inhoud.

De toepassing moet de vereiste vouchers opnieuw downloaden, anders kan de gebruiker geen gecodeerde inhoud openen. Het aanroepen van deze functie is equivalent aan het aanroepen van Netstream.resetDRMVouchers().

Gegenereerde uitzondering

IOError — De vouchergegevens kunnen niet worden verwijderd.

Verwante API-elementen

flash.net.NetStream.resetDRMVouchers()

returnVoucher

()

methode

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

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 11.8, AIR 3.8

Hiermee worden alle vouchers die overeenkomen met alle opgegeven criteria geretourneerd naar de licentieserver. Als een voucher wordt geretourneerd, wordt deze verwijderd uit de schijfopslag en uit het geheugen. Hierdoor worden geen Netstreams en AVStreams onderbroken die momenteel de geretourneerde vouchers gebruiken om video af te spelen, maar toekomstig afspelen zal worden verhinderd. DRMManager geeft een DRMReturnVoucherCompleteEvent uit indien geslaagd of een DRMReturnVoucherErrorEvent indien mislukt. Een ArgumentError wordt gegenereerd als inServerURL null is of als zowel de licentie-id als de beleids-id null zijn.

Parameters

	`inServerURL:String` — De licentieserver-URL's vanwaar de geretourneerde licenties zijn gedownload.

	`immediateCommit:Boolean` — Gereserveerd. De enige ondersteunde waarde is true.

	`licenseID:String` — (optioneel) Vouchers die overeenkomen met deze licentie-id, worden geretourneerd. Als deze null is, wordt in plaats daarvan de beleids-id gebruikt.

	`policyID:String` — (optioneel) Vouchers die overeenkomen met deze beleids-id, worden geretourneerd. Als deze null is, wordt in plaats daarvan de licentie-id gebruikt. Als zowel de licentie-id als de beleids-id niet null zijn, wordt alleen een voucher die overeenkomt met zowel de licentie-id als de beleids-id geretourneerd.

setAuthenticationToken

()

methode

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

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.5, Flash Player 10.1

Hiermee wordt het verificatietoken ingesteld dat wordt gebruikt voor de communicatie met de opgegeven server en domein.

Verificatietokens zijn beschikbaar in de eigenschap token van het object DRMAuthenticationCompleteEvent dat wordt verzonden nadat een aanroep van de methode authenticate() is geslaagd. Het token wordt automatisch in de cache geplaatst voor de sessie, maar u kunt tokens rechtstreeks beheren met de methode setAuthenticationToken().

Als u een token instelt, wordt elk bestaand token in de cache overschreven voor de server en het domein. Stel de parameter token in op null om het token in de cache te wissen.

Parameters

	`serverUrl:String` — De URL van de mediarechtenserver

	`domain:String` — De DRMContentData

	`token:ByteArray` — Het verificatietoken

storeVoucher

()

methode

public function storeVoucher(voucher:ByteArray):void

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 11.0, AIR 3.0

Parameters

voucher:ByteArray

Gebeurtenisdetails

authenticationComplete

Gebeurtenis

Type gebeurtenisobject: flash.events.DRMAuthenticationCompleteEvent
eigenschap DRMAuthenticationCompleteEvent.type = flash.events.DRMAuthenticationCompleteEvent.AUTHENTICATION_COMPLETE

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.5, Flash Player 10.1

De DRMManager verzendt een DRMAuthenticationCompleteEvent-object wanneer de gebruiker door de server met mediarechten is gemachtigd na een aanroep van de methode authenticate().

De constante tekenreeks die wordt gebruikt voor de gebeurtenis 'verificatie voltooid' in de parameter type bij het toevoegen en verwijderen van gebeurtenislisteners.

authenticationError

Gebeurtenis

Type gebeurtenisobject: flash.events.DRMAuthenticationErrorEvent
eigenschap DRMAuthenticationErrorEvent.type = flash.events.DRMAuthenticationErrorEvent.AUTHENTICATION_ERROR

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.5, Flash Player 10.1

De DRMManager verzendt een DRMAuthenticationErrorEvent-object wanneer de gebruiker niet door de server met mediarechten is gemachtigd na een aanroep van de methode authenticate().

De constante tekenreeks die wordt gebruikt voor de gebeurtenis 'verificatiefout' in de parameter type bij het toevoegen en verwijderen van gebeurtenislisteners.

drmError

Gebeurtenis

Type gebeurtenisobject: flash.events.DRMErrorEvent
eigenschap DRMErrorEvent.type = flash.events.DRMErrorEvent.DRM_ERROR

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.5, Flash Player 10.1

De DRMManager verzendt een DRMErrorEvent-object wanneer een gevraagde voucher niet kan worden verkregen van de server met mediarechten.

Opmerking: Wanneer een poging om een voucher te laden uit de lokale vouchercache (met localOnly als enige source-parameter) mislukt, wordt GEEN DRMErrorEvent-object verzonden. In plaats daarvan wordt een DRMStatusEvent-object verzonden waarvoor de eigenschap voucher is ingesteld op null.

De constante DRMErrorEvent.DRM_ERROR definieert de waarde van de eigenschap type van een drmError-gebeurtenisobject.

Deze gebeurtenis heeft de volgende eigenschappen:

Eigenschap	Waarde
`bubbles`	`false`
`cancelable`	`false`; er is geen standaardgedrag om te annuleren.
`errorID`	Een numerieke foutcode die aan het probleem is toegewezen.
`subErrorID`	Een foutcode die gedetailleerdere informatie geeft over het onderliggende probleem.
`target`	Het NetStream-object.

drmStatus

Gebeurtenis

Type gebeurtenisobject: flash.events.DRMStatusEvent
eigenschap DRMStatusEvent.type = flash.events.DRMStatusEvent.DRM_STATUS

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.5, Flash Player 10.1

De DRMManager verzendt een DRMStatusEvent -object wanneer een gevraagde voucher is verkregen van de server met mediarechten.

De constante DRMStatusEvent.DRM_STATUS definieert de waarde van de eigenschap type van een gebeurtenisobject drmStatus.

Deze gebeurtenis heeft de volgende eigenschappen:

Eigenschap	Waarde
`bubbles`	`false`
`cancelable`	`false`; er is geen standaardgedrag om te annuleren.
`detail`	Een tekenreeks waarin de context van een statusgebeurtenis wordt uitgelegd.
`isAnonymous`	Geeft aan of de met DRM-codering beveiligde inhoud beschikbaar is zonder dat een gebruiker verificatiereferenties moet opgeven.
`isAvailableOffline`	Geeft aan of de met DRM-codering beveiligde inhoud offline beschikbaar is.
`offlineLeasePeriod`	Het aantal dagen dat de inhoud nog offline kan worden bekeken.
`policies`	Een aangepast object van de DRM-statusgebeurtenis.
`target`	Het NetStream-object.
`voucherEndDate`	De absolute datum waarop de voucher verloopt en de inhoud niet meer door gebruikers kan worden bekeken.
`contentData`	De DRMContentData voor de inhoud
`voucher`	Het object DRMVoucher voor de inhoud.
`isLocal`	Geeft aan of de inhoud is opgeslagen in het lokale bestandssysteem.

Juridische kennisgeving | Online privacybeleid

DRMManager - AS3

Pakkettenx

Taalelementen

Bijlagen

Pakket flash.net.drm

isSupported

networkIdleTimeout

addToDeviceGroup

authenticate

getDRMManager

loadPreviewVoucher

loadVoucher

removeFromDeviceGroup

resetDRMVouchers

returnVoucher

setAuthenticationToken

storeVoucher

authenticationComplete

authenticationError

drmError

drmStatus