Pakket | flash.net.drm |
Klasse | public class DRMManager |
Overerving | DRMManager EventDispatcher Object |
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.5, Flash Player 10.1 |
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
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 |
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 | ||
voegt het apparaat dat momenteel wordt uitgevoerd, toe aan een apparaatgroep. | DRMManager | ||
Hiermee wordt een gebruiker geverifieerd. | DRMManager | ||
Verzendt een gebeurtenis naar de gebeurtenisstroom. | EventDispatcher | ||
[statisch]
Retourneert een instantie van het singleton object DRMManager. | DRMManager | ||
Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis. | EventDispatcher | ||
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | ||
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | ||
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 | ||
Laadt een voucher vanaf een mediarechtenserver of uit de lokale vouchercache. | DRMManager | ||
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | ||
Verwijdert een listener uit het object EventDispatcher. | EventDispatcher | ||
Verwijdert het apparaat dat momenteel wordt uitgevoerd, uit een apparaatgroep. | DRMManager | ||
In AIR-toepassingen worden hiermee alle lokaal in de cache geplaatste vouchergegevens voor Digital Rights Management (DRM) verwijderd. | DRMManager | ||
Hiermee worden alle vouchers die overeenkomen met alle opgegeven criteria geretourneerd naar de licentieserver. | DRMManager | ||
Hiermee wordt het verificatietoken ingesteld dat wordt gebruikt voor de communicatie met de opgegeven server en domein. | DRMManager | ||
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | ||
DRMManager | |||
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | ||
Retourneert een tekenreeksrepresentatie van het opgegeven object. | Object | ||
Retourneert de primitieve waarde van het opgegeven object. | Object | ||
Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis. | EventDispatcher |
Gebeurtenis | Overzicht | Gedefinieerd door | ||
---|---|---|---|---|
[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de besturingssysteemfocus krijgt en actief wordt. | EventDispatcher | |||
De DRMManager verzendt een DRMAuthenticationCompleteEvent-object wanneer de gebruiker door de server met mediarechten is gemachtigd na een aanroep van de methode authenticate(). | DRMManager | |||
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 | |||
[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de systeemfocus verliest en inactief wordt. | EventDispatcher | |||
De DRMManager verzendt een DRMErrorEvent-object wanneer een gevraagde voucher niet kan worden verkregen van de server met mediarechten. | DRMManager | |||
De DRMManager verzendt een DRMStatusEvent -object wanneer een gevraagde voucher is verkregen van de server met mediarechten. | DRMManager |
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 |
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
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 waardeDRMManager |
Verwante API-elementen
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
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 |
authenticationComplete | Gebeurtenis |
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()
.
authenticationError | Gebeurtenis |
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()
.
drmError | Gebeurtenis |
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
.
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 |
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 constanteDRMStatusEvent.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. |
Wed Jun 13 2018, 11:42 AM Z