DRMManager - API-referens för Adobe ActionScript® 3 (AS3 )

Paket	flash.net.drm
Klass	public class DRMManager
Arv	DRMManager EventDispatcher Object

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.5, Flash Player 10.1

DRMManager hanterar hämtning och lagring av de vouchers som behövs för att visa DRM-skyddat innehåll. Med den statiska metoden DRMManager.getDRMManager() kan du komma åt det befintliga DRMManager-objektet för att utföra följande DRM-hanteringsåtgärder:

Förinläs vouchers från en medieserver med ett DRMContentData-objekt.
Sök i det lokala arkivet efter en enskild voucher med hjälp av ett DRMContentData-objekt.
Återställ alla vouchers (endast AIR)

Det finns ingen metod för att räkna upp alla vouchers i den lokala cachen.

Skapa inte en instans av klassen DRMManager. Använd den statiska DRMManager.getDRMManager() om du vill ha tillgång till det befintliga DRMManager-objektet.

Stöd för AIR-profiler: Den här funktionen stöds på alla operativsystem för datorer och enheter med AIR for TV, men inte på mobilenheter. Du kan testa stödet vid körning med egenskapen DRMManager.isSupported. På sidan om stöd för AIR-profiler hittar du mer information om API-stöd för flera profiler.

Relaterade API-element

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

Publika egenskaper

Dölj ärvda publika egenskaper

Visa ärvda publika egenskaper

	Egenskap		Definieras med
		constructor : Object En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans.	Object
		isSupported : Boolean [statisk] [skrivskyddad] Egenskapen isSupported är true om klassen DRMManager stöds på den aktuella plattformen, och i annat fall är värdet false.	DRMManager
		networkIdleTimeout : Number [statisk]	DRMManager

Publika metoder

Dölj ärvda publika metoder

Visa ärvda publika metoder

	Metod		Definieras med
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registrerar ett händelseavlyssnarobjekt för ett EventDispatcher-objekt så att avlyssnaren får meddelanden om händelser.	EventDispatcher
		addToDeviceGroup(deviceGroup:DRMDeviceGroup, forceRefresh:Boolean = false):void lägger till enheten som körs i en enhetsgrupp.	DRMManager
		authenticate(serverURL:String, domain:String, username:String, password:String):void Verifierar en användare.	DRMManager
		dispatchEvent(event:Event):Boolean Skickar en händelse till händelseflödet.	EventDispatcher
		getDRMManager():DRMManager [statisk] Returnerar en instans av DRMManager-singletonobjektet.	DRMManager
		hasEventListener(type:String):Boolean Kontrollerar om EventDispatcher-objektet har några avlyssnare registrerade för en viss typ av händelse.	EventDispatcher
		hasOwnProperty(name:String):Boolean Anger om det finns en egenskap angiven för ett objekt.	Object
		isPrototypeOf(theClass:Object):Boolean Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter.	Object
		loadPreviewVoucher(contentData:DRMContentData):void Hämtar en förhandsgranskningsvoucher från licensservern, som du kan använda för att låta en användare kontrollera att de kan spela upp innehållet på en viss dator.	DRMManager
		loadVoucher(contentData:DRMContentData, setting:String):void Läser in en verifikation från en mediarättighetsserver eller en lokal verifikationscache.	DRMManager
		propertyIsEnumerable(name:String):Boolean Anger om den angivna egenskapen finns och är uppräkningsbar.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Tar bort en avlyssnare från EventDispatcher-objektet.	EventDispatcher
		removeFromDeviceGroup(deviceGroup:DRMDeviceGroup):void Tar bort enheten som körs från en enhetsgrupp.	DRMManager
		resetDRMVouchers():void I AIR-program tar detta bort alla lokalt cachelagrade DRM-voucherdata (Digital Rights Management).	DRMManager
		returnVoucher(inServerURL:String, immediateCommit:Boolean, licenseID:String, policyID:String):void Returnerar alla vouchers som matchar alla angivna villkor till licensservern.	DRMManager
		setAuthenticationToken(serverUrl:String, domain:String, token:ByteArray):void Ställer in verifieringstoken att användas för kommunikation med den angivna servern och domänen.	DRMManager
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Anger tillgänglighet för en dynamisk egenskap för slingåtgärder.	Object
		storeVoucher(voucher:ByteArray):void	DRMManager
		toLocaleString():String Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner.	Object
		toString():String Returnerar det angivna objektets strängbeteckning.	Object
		valueOf():Object Returnerar det angivna objektets primitiva värde.	Object
		willTrigger(type:String):Boolean Kontrollerar om en händelseavlyssnare är registrerad för det här EventDispatcher-objektet eller något av dess överordnade objekt för den angivna händelsetypen.	EventDispatcher

Händelser

Klicka för mer information om händelser

Dölj ärvda händelser

Visa ärvda händelser

	Sammanfattning	Definieras med
activate	[utsändningshändelse] Skickas när Flash Player eller AIR får operativsystemfokus och blir aktivt.	EventDispatcher
authenticationComplete	DRMManager skickar ett DRMAuthenticationCompleteEvent-objekt när användaren autentiseras av mediarättighetsservern efter ett anrop till metoden authenticate().	DRMManager
authenticationError	DRMManager skickar ett DRMAuthenticationErrorEvent-objekt när användaren inte autentiseras av mediarättighetsservern efter ett anrop till metoden authenticate().	DRMManager
deactivate	[utsändningshändelse] Skickas när Flash Player eller AIR förlorar operativsystemfokus och blir inaktivt.	EventDispatcher
drmError	DRMManager skickar ett DRMErrorEvent-objekt när en begärd verifikation inte kan hämtas från mediarättighetsservern.	DRMManager
drmStatus	DRMManager skickar ett DRMStatusEvent-objekt när en begärd verifikation hämtas från mediarättighetsservern.	DRMManager

Egenskapsdetaljer

isSupported

egenskap

isSupported:Boolean [skrivskyddad]

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10.1, AIR 2

Egenskapen isSupported är true om klassen DRMManager stöds på den aktuella plattformen, och i annat fall är värdet false.

Implementering
public static function get isSupported():Boolean

networkIdleTimeout

egenskap

networkIdleTimeout:Number

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

Metoddetaljer

addToDeviceGroup

()

metod

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

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 3.0, Flash Player 11.9

lägger till enheten som körs i en enhetsgrupp.

Parametrar

	`deviceGroup:DRMDeviceGroup`

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

authenticate

()

metod

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

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.5, Flash Player 10.1

Verifierar en användare.

Lyssna efter händelserna authenticationComplete och authenticationError om du vill ta reda på resultatet från verifieringsförsöket. Flera authenticate()-anrop ställs i kö. AuthenticationCompleteEvent-objektet skickas för authenticationComplete-händelsen som innehåller en verifieringstoken som programmet kan spara.

Du kan använda en sparad verifieringstoken, eller en token som hämtas på andra sätt, om du vill upprätta en verifierad session med mediarättighetsservern i framtiden. Du upprättar en session med hjälp av en token genom att anropa DRMManager-metoden setAuthenticationToken(). Egenskaperna för denna token, till exempel utgångsdatumet, fastställs från inställningarna på servern som genererar denna token.

Viktigt (endast AIR)! Metoden authenticate() lyckas inte om användarens Internet-anslutning skickas via en proxyserver som kräver autentisering. Sådana användare kan inte förhandsladda en DRM-voucher som kräver autentisering, men ditt program kan hämta vouchern genom att börja uppspelningen och använda NetStream-metoden setAuthenticationCredentials() för att logga in användaren på både proxy- och medieservern. När verifikationen har hämtats kan användaren visa innehållet offline (om licensen som representeras av verifikationen tillåter uppspelning offline).

Parametrar

	`serverURL:String` — URL:en för en mediarättighetsserver som kan tillhandahålla en verifikation för visning av skyddat innehåll

	`domain:String` — En domän på servern (inte ett nätverks- eller Internetdomännamn)

	`username:String` — Användarnamnet

	`password:String` — Användarens lösenord

Relaterade API-element

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

getDRMManager

()

metod

public static function getDRMManager():DRMManager

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.5, Flash Player 10.1

Returnerar en instans av DRMManager-singletonobjektet.

Det finns en DRMManager-instans för varje säkerhetsdomän.

Returnerar

DRMManager

Relaterade API-element

flash.system.SecurityDomain

loadPreviewVoucher

()

metod

public function loadPreviewVoucher(contentData:DRMContentData):void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 2, Flash Player 10.1

Hämtar en förhandsgranskningsvoucher från licensservern, som du kan använda för att låta en användare kontrollera att de kan spela upp innehållet på en viss dator. Med den här funktionen kan användare kontrollera att de kan spela upp innehållet på sina datorer innan de köper och hämtar det. Det är praktiskt när användarens dator inte har det utdataskydd som krävs eller den programvara som behövs för att spela upp innehåll.

Precis som loadVoucher() är den här metoden ett asynkront anrop och skickar en DRMStatusEvent vid slutförandet eller en DRMErrorEvent vid fel.

Parametrar

contentData:DRMContentData

loadVoucher

()

metod

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

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.5, Flash Player 10.1

Läser in en verifikation från en mediarättighetsserver eller en lokal verifikationscache.

Verifikationen läses in enligt parametern setting:

LoadVoucherSetting.FORCE_REFRESH: Vouchern hämtas alltid från medieservern.
LoadVoucherSetting.LOCAL_ONLY: Vouchern läses enbart in från det lokala arkivet.
LoadVoucherSetting.ALLOW_SERVER: Vouchern läses in från det lokala arkivet, om det är möjligt, men hämtas annars från servern.

Klassen LoadVoucherSetting definierar strängkonstanterna som ska användas som värden för parametern setting.

När verifikationen har lästs in, skickar DRMManager en DRM-statushändelse. Programmet kan börja spela upp så snart verifikationen har lästs in. Den inlästa verifikationen är tillgänglig i voucher-egenskapen för det skickade DRMStatusEvent-objektet. Du kan använda det här verifikationsobjektet om du vill visa den associerade mediarättighetsinformationen för användaren.

Om det inte går att läsa in en voucher från medieservern skickas en DRM-felhändelse. Egenskapen errorID för det skickade DRMErrorEvent-objektet anger orsaken till felet. Felet kan bland annat bero på ett försök att ansluta till medieservern när användaren är offline eller ett försök att läsa in en voucher när användaren inte är inloggad. Programmet kan svara på dessa fel och vidta åtgärder. Om det till exempel krävs inloggningsuppgifter för att hämta verifikationen, kan du uppmana användaren att ange användarnamn och lösenord, anropa DRMManager-metoden authenticate() och sedan försöka att läsa in verifikationen igen.

Om det inte går att hämta en voucher från det lokala arkivet, och inställningen localOnly används, skickas inte någon DRMErrorEvent. I stället skickas DRM-statushändelsen. Egenskapen detail för det här DRMStatusEvent-objektet är fortfarande DRM.voucherObtained, men voucher-egenskapen är null.

Parametrar

	`contentData:DRMContentData` — DRMContentData-objektet från en DRM-skyddad mediafil

	`setting:String` — Fastställer om verifikationen hämtas från den lokala cachen eller mediarättighetsservern

removeFromDeviceGroup

()

metod

public function removeFromDeviceGroup(deviceGroup:DRMDeviceGroup):void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 3.0, Flash Player 11.9

Tar bort enheten som körs från en enhetsgrupp.

Parametrar

deviceGroup:DRMDeviceGroup

resetDRMVouchers

()

metod

public function resetDRMVouchers():void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.5, Flash Player 11.8

I AIR-program tar detta bort alla lokalt cachelagrade DRM-voucherdata (Digital Rights Management). För webbläsarbaserade program är detta bara tillgängligt vid 3322, 3346, 3323, 3326-fel och fungerar likadant som panelen med inställningar för uppspelning av skyddat innehåll.

Programmet måste hämta de verifikationer som behövs på nytt för att användaren ska kunna komma åt det krypterade innehållet. Att anropa den här funktionen motsvarar att anropa Netstream.resetDRMVouchers().

Utlöser

IOError — Det går inte att ta bort voucherdata.

Relaterade API-element

flash.net.NetStream.resetDRMVouchers()

returnVoucher

()

metod

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

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 11.8, AIR 3.8

Returnerar alla vouchers som matchar alla angivna villkor till licensservern. När en voucher returneras tas den bort från hårddisken och från minnet. Detta avbryter inte Netstreams eller AVStreams som för tillfället använder returnerade vouchers för videouppspelning, men framtida uppspelning är inte möjlig. DRMManager skickar en DRMReturnVoucherCompleteEvent vid slutförande eller en DRMReturnVoucherErrorEvent vid fel. Genererar ett ArgumentError om inServerURL är null eller om licenseID och policyID båda är null.

Parametrar

	`inServerURL:String` — Licensserverns webbadresser från vilka de returnerade licenserna har laddats ned.

	`immediateCommit:Boolean` — Reserverad. Det enda värdet som stöds är sant.

	`licenseID:String` — (Valfritt) Vouchers som matchar detta licens-ID returneras. Om värdet är null används princip-ID:t i stället.

	`policyID:String` — (Valfritt) Vouchers som matchar detta princip-ID returneras. Om värdet är null används licens-ID:t i stället. Om både licens-ID:t och princip-ID:t har ett värde som inte är null returneras bara en voucher som matchar både licens-ID:t och princip-ID:t.

setAuthenticationToken

()

metod

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

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.5, Flash Player 10.1

Ställer in verifieringstoken att användas för kommunikation med den angivna servern och domänen.

Verifieringstokens är tillgängliga från token-egenskapen för DRMAuthenticationCompleteEvent-objeketet som skickas efter ett lyckat anrop till metoden authenticate(). Denna token cachelagras automatiskt för sessionen, men med metoden setAuthenticationToken() kan du hantera tokens direkt.

Om du ställer in en token skrivs alla befintliga cachelagrade tokens för servern och domänen över. Ställ in token-parametern på null om du vill radera den cachelagrade token.

Parametrar

	`serverUrl:String` — URL:en för mediarättighetsservern

	`domain:String` — DRMContentData

	`token:ByteArray` — Verifieringstoken

storeVoucher

()

metod

public function storeVoucher(voucher:ByteArray):void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 11.0, AIR 3.0

Parametrar

voucher:ByteArray

Händelsedetaljer

authenticationComplete

Händelse

Typ av händelseobjekt: flash.events.DRMAuthenticationCompleteEvent
egenskap DRMAuthenticationCompleteEvent.type = flash.events.DRMAuthenticationCompleteEvent.AUTHENTICATION_COMPLETE

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.5, Flash Player 10.1

DRMManager skickar ett DRMAuthenticationCompleteEvent-objekt när användaren autentiseras av mediarättighetsservern efter ett anrop till metoden authenticate().

Den strängkonstant som ska användas för verifiering klar-händelsen i typparametern när händelselyssnare läggs till och tas bort.

authenticationError

Händelse

Typ av händelseobjekt: flash.events.DRMAuthenticationErrorEvent
egenskap DRMAuthenticationErrorEvent.type = flash.events.DRMAuthenticationErrorEvent.AUTHENTICATION_ERROR

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.5, Flash Player 10.1

DRMManager skickar ett DRMAuthenticationErrorEvent-objekt när användaren inte autentiseras av mediarättighetsservern efter ett anrop till metoden authenticate().

Den strängkonstant som ska användas för verifieringsfel-händelsen i typparametern när händelselyssnare läggs till och tas bort.

drmError

Händelse

Typ av händelseobjekt: flash.events.DRMErrorEvent
egenskap DRMErrorEvent.type = flash.events.DRMErrorEvent.DRM_ERROR

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.5, Flash Player 10.1

DRMManager skickar ett DRMErrorEvent-objekt när en begärd verifikation inte kan hämtas från mediarättighetsservern.

Obs! När ett försök att läsa in en voucher från det lokala voucherarkivet (med localOnly som source-parameter) misslyckas skickas inte något DRMErrorEvent-objekt. I stället skickas ett DRMStatusEvent-objekt med en voucher-egenskap satt till null.

DRMErrorEvent.DRM_ERROR-konstanten definierar värdet på type-egenskapen i ett drmError-händelseobjekt.

Den här händelsen har följande egenskaper:

Egenskap	Värde
`bubbles`	`false`
`cancelable`	`false`; det finns inget standardbeteende att avbryta.
`errorID`	En numerisk felkod som tilldelats problemet.
`subErrorID`	En felkod som indikerar mer detaljerad information om det underliggande problemet.
`target`	NetStream-objektet.

drmStatus

Händelse

Typ av händelseobjekt: flash.events.DRMStatusEvent
egenskap DRMStatusEvent.type = flash.events.DRMStatusEvent.DRM_STATUS

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.5, Flash Player 10.1

DRMManager skickar ett DRMStatusEvent-objekt när en begärd verifikation hämtas från mediarättighetsservern.

DRMStatusEvent.DRM_STATUS-konstanten definierar värdet på type-egenskapen i ett drmStatus-händelseobjekt.

Den här händelsen har följande egenskaper:

Egenskap	Värde
`bubbles`	`false`
`cancelable`	`false`; det finns inget standardbeteende att avbryta.
`detalj`	En sträng förklarar innehållet i statushändelsen.
`isAnonymous`	Anger om innehållet som är skyddat med DRM-kryptering är tillgängligt utan att användaren måste ange sina inloggningsuppgifter.
`isAvailableOffline`	Anger om innehållet som är skyddat med DRM-kryptering finns tillgängligt off-line.
`offlineLeasePeriod`	Antal dagar kvar som innehållet kan visas off-line.
`policies`	Ett anpassat objekt i DRM-statushändelsen.
`target`	NetStream-objektet.
`voucherEndDate`	Datumet då vouchern förfaller och innehållet inte längre kan visas för användare
`contentData`	DRMContentData för innehållet
`voucher`	DRMVoucher-objektet för innehållet.
`isLocal`	Anger om innehållet lagras i det lokala filsystemet

Juridiska meddelanden | Onlinesekretesspolicy

DRMManager - AS3

Klasser x

isSupported

networkIdleTimeout

addToDeviceGroup

authenticate

getDRMManager

loadPreviewVoucher

loadVoucher

removeFromDeviceGroup

resetDRMVouchers

returnVoucher

setAuthenticationToken

storeVoucher

authenticationComplete

authenticationError

drmError

drmStatus