| Pacchetto | flash.net.drm |
| Classe | public class DRMManager |
| Ereditarietà | DRMManager  EventDispatcher Object |
| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5, Flash Player 10.1 |
DRMManager.getDRMManager(), potete accedere all'oggetto DRMManager esistente per eseguire le seguenti attività di gestione DRM:
- Precarica i voucher da un server di gestione dei diritti multimediali, utilizzando un oggetto DRMContentData.
- Potete interrogare la cache locale per la ricerca di un singolo voucher mediante un oggetto DRMContentData.
- Reimpostate tutti i voucher (solo AIR)
Non viene fornito alcun metodo per enumerare tutti i voucher nella cache locale.
Non create un'istanza della classe DRMManager. Utilizzate il metodo statico DRMManager.getDRMManager() per accedere all'oggetto DRMManager esistente.
Supporto profili AIR: questa funzionalità è supportata in tutti i sistemi operativi desktop e nei dispositivi AIR per TV, ma non nei dispositivi mobili. È possibile verificare se la funzionalità è supportata in fase runtime utilizzando la proprietà DRMManager.isSupported. Per ulteriori informazioni sul supporto delle API tra più profili, vedete Supporto dei profili AIR.
Altre informazioni
Elementi API correlati
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Proprietà | Definito da | ||
|---|---|---|---|
 | constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | |
| isSupported : Boolean [statico] [sola lettura]
La proprietà isSupported è impostata su true se la classe DRMManager è supportata nella piattaforma corrente, altrimenti è impostata su false. | DRMManager | ||
| networkIdleTimeout : Number [statico] | DRMManager | ||
| Metodo | Definito da | ||
|---|---|---|---|
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento. | EventDispatcher | |
Aggiunge il dispositivo attualmente in esecuzione al gruppo dispositivi. | DRMManager | ||
Effettua l'autenticazione di un utente. | DRMManager | ||
|
Invia un evento nel flusso di eventi. | EventDispatcher | |
[statico]
Restituisce un'istanza dell'oggetto DRMManager Singleton. | DRMManager | ||
|
Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento. | EventDispatcher | |
|
Indica se per un oggetto è definita una proprietà specifica. | Object | |
|
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | |
Ottiene un voucher di visualizzazione in anteprima dal server delle licenze, che potete utilizzare per consentire a un utente di verificare se può riprodurre il contenuto su un computer specifico. | DRMManager | ||
Carica un voucher da un server di gestione dei diritti multimediali o dalla cache dei voucher locale. | DRMManager | ||
|
Indica se la proprietà specificata esiste ed è enumerabile. | Object | |
|
Rimuove un listener dall'oggetto EventDispatcher. | EventDispatcher | |
Rimuove il dispositivo attualmente in esecuzione dal gruppo dispositivi. | DRMManager | ||
Nelle applicazioni AIR, elimina tutti i dati del voucher DRM (Digital Rights Management) memorizzati nella cache locale. | DRMManager | ||
Restituisce al server delle licenze tutti i voucher che corrispondono ai criteri specificati. | DRMManager | ||
Imposta il token di autenticazione da utilizzare per la comunicazione con il server e il dominio specificati. | DRMManager | ||
|
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | |
| DRMManager | |||
|
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | |
|
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | |
|
Restituisce il valore di base dell'oggetto specificato. | Object | |
|
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato. | EventDispatcher | |
| Evento | Riepilogo | Definito da | ||
|---|---|---|---|---|
| [evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo. | EventDispatcher | ||
| DRMManager invia un oggetto DRMAuthenticationCompleteEvent se l'utente viene autenticato dal server di gestione dei diritti multimediali dopo una chiamata al metodo authenticate(). | DRMManager | |||
| DRMManager invia un oggetto DRMAuthenticationErrorEvent se l'utente non viene autenticato dal server di gestione dei diritti multimediali dopo una chiamata al metodo authenticate(). | DRMManager | |||
| [evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo. | EventDispatcher | ||
| DRMManager invia un oggetto DRMErrorEvent se un voucher richiesto non può essere ottenuto dal server di gestione dei diritti multimediali. | DRMManager | |||
| DRMManager invia un oggetto DRMStatusEvent se un voucher richiesto viene ottenuto dal server di gestione dei diritti multimediali. | DRMManager | |||
isSupported | proprietà |
isSupported:Boolean [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10.1, AIR 2 |
La proprietà isSupported è impostata su true se la classe DRMManager è supportata nella piattaforma corrente, altrimenti è impostata su false.
Implementazione
public static function get isSupported():BooleannetworkIdleTimeout | proprietà |
addToDeviceGroup | () | metodo |
public function addToDeviceGroup(deviceGroup:DRMDeviceGroup, forceRefresh:Boolean = false):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3.0, Flash Player 11.9 |
Aggiunge il dispositivo attualmente in esecuzione al gruppo dispositivi.
Parametri
deviceGroup:DRMDeviceGroup | |
forceRefresh:Boolean (default = false) |
authenticate | () | metodo |
public function authenticate(serverURL:String, domain:String, username:String, password:String):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5, Flash Player 10.1 |
Effettua l'autenticazione di un utente.
Ascolta gli eventi authenticationComplete e authenticationError per determinare l'esito del tentativo di autenticazione. Vengono messe in coda diverse chiamate ad authenticate(). L'oggetto AuthenticationCompleteEvent inviato per l'evento authenticationComplete contiene un token di autenticazione che può essere salvato dall'applicazione.
Potete utilizzare un token di autenticazione salvato o un token scaricato in altro modo per stabilire in futuro una sessione autenticata con il server di gestione dei diritti multimediali. Per stabilire una sessione mediante un token, chiamate il metodo setAuthenticationToken() di DRMManager. Le proprietà del token (ad esempio, la data di scadenza) vengono determinate dalle impostazioni del server che genera il token.
Importante (solo AIR): il metodo authenticate() dà esito negativo quando la connessione Internet di un utente passa attraverso un server proxy che richiede l'autenticazione. Benché tali utenti non possano precaricare un voucher DRM che richiede l'autenticazione, l'applicazione può ottenere il voucher iniziando la riproduzione e utilizzando il metodo NetStream setAuthenticationCredentials() per far accedere l'utente sia al server proxy che ai server di gestione dei diritti multimediali. In seguito all'ottenimento del voucher, l'utente può visualizzare il contenuto non in linea (se la licenza rappresentata dal voucher consente la riproduzione non in linea).
Parametri
serverURL:String — L'URL di un server di gestione dei diritti multimediali che può fornire un voucher per la visualizzazione di contenuti protetti
| |
domain:String — Un dominio sul server (non un nome di dominio di rete o Internet)
| |
username:String — Il nome dell'utente
| |
password:String — La password dell'utente
|
Elementi API correlati
getDRMManager | () | metodo |
public static function getDRMManager():DRMManager| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5, Flash Player 10.1 |
Restituisce un'istanza dell'oggetto DRMManager Singleton.
Per ogni dominio di sicurezza esiste una sola istanza DRMManager.
RestituisceDRMManager |
Elementi API correlati
loadPreviewVoucher | () | metodo |
public function loadPreviewVoucher(contentData:DRMContentData):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2, Flash Player 10.1 |
Ottiene un voucher di visualizzazione in anteprima dal server delle licenze, che potete utilizzare per consentire a un utente di verificare se può riprodurre il contenuto su un computer specifico. Grazie a questa funzionalità, gli utenti possono verificare di poter riprodurre il contenuto sul proprio computer, prima di acquistare e scaricare tale contenuto. È utile quando il computer dell'utente non dispone delle necessarie funzioni di protezione dell'output o del software necessario per riprodurre il contenuto.
In modo analogo a loadVoucher(), questo metodo costituisce una chiamata asincrona e utilizza un oggetto DRMStatusEvent al completamento dell'operazione oppure un oggetto DRMErrorEvent in caso di errori.
Parametri
contentData:DRMContentData |
loadVoucher | () | metodo |
public function loadVoucher(contentData:DRMContentData, setting:String):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5, Flash Player 10.1 |
Carica un voucher da un server di gestione dei diritti multimediali o dalla cache dei voucher locale.
Il voucher viene caricato in base al parametro setting:
- LoadVoucherSetting.FORCE_REFRESH: il voucher viene sempre scaricato dal server di gestione dei diritti multimediali.
- LoadVoucherSetting.LOCAL_ONLY: il voucher viene caricato solo dalla cache locale.
- LoadVoucherSetting.ALLOW_SERVER: il voucher viene caricato dalla cache locale, se possibile; altrimenti viene scaricato dal server.
La classe LoadVoucherSetting definisce le costanti stringa da utilizzare come valori per il parametro setting.
Quando il voucher viene caricato correttamente, DRMManager invia un evento di stato DRM. L'applicazione può iniziare la riproduzione non appena il voucher viene caricato. Il voucher caricato è disponibile nella proprietà voucher dell'oggetto DRMStatusEvent inviato. Potete utilizzare questo oggetto voucher per visualizzare all'utente le informazioni media rights associate.
Se non è possibile caricare un voucher dal server di gestione dei diritti multimediali, viene inviato un evento di errore DRM. La proprietà errorID dell'oggetto DRMErrorEvent inviato indica il motivo dell'esito negativo. Tra le cause più comuni dell'errore vi sono il tentativo di connettersi al server di gestione dei diritti multimediali quando l'utente non è in linea e il tentativo di caricare un voucher quando l'utente non ha effettuato il login. L'applicazione può rispondere a questi errori ed effettuare azioni correttive. Se, ad esempio, per scaricare il voucher sono richieste le credenziali di autenticazione, potete richiedere all'utente il nome utente e la password dell'account, chiamare il metodo authenticate() di DRMManager e successivamente tentare di caricare nuovamente il voucher.
Se non è possibile ottenere un voucher dalla cache locale e si sta utilizzando l'impostazione localOnly, DRMErrorEvent non viene inviato. Al contrario, viene inviato un evento di stato DRM. La proprietà detail di questo oggetto DRMStatusEvent è sempre DRM.voucherObtained, ma la proprietà voucher è null.
Parametri
contentData:DRMContentData — L'oggetto DRMContentData di un file multimediale protetto con DRM
| |
setting:String — Determina se il voucher viene recuperato dalla cache locale o dal server di gestione dei diritti multimediali.
|
removeFromDeviceGroup | () | metodo |
public function removeFromDeviceGroup(deviceGroup:DRMDeviceGroup):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3.0, Flash Player 11.9 |
Rimuove il dispositivo attualmente in esecuzione dal gruppo dispositivi.
Parametri
deviceGroup:DRMDeviceGroup |
resetDRMVouchers | () | metodo |
public function resetDRMVouchers():void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5, Flash Player 11.8 |
Nelle applicazioni AIR, elimina tutti i dati del voucher DRM (Digital Rights Management) memorizzati nella cache locale. Per le applicazioni basate su browser, è disponibile solo durante gli errori 3322, 3346, 3323, 3326 e si comporta come il riquadro Impostazioni di riproduzione del contenuto protetto.
L'applicazione deve scaricare di nuovo il voucher richiesto affinché l'utente possa accedere al contenuto crittografato. La chiamata a questa funzione equivale a una chiamata a Netstream.resetDRMVouchers().
Genera
IOError — I dati del voucher non possono essere eliminati.
|
Elementi API correlati
returnVoucher | () | metodo |
public function returnVoucher(inServerURL:String, immediateCommit:Boolean, licenseID:String, policyID:String):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 11.8, AIR 3.8 |
Restituisce al server delle licenze tutti i voucher che corrispondono ai criteri specificati. Quando un voucher viene restituito, viene rimosso dal disco e dalla memoria. Ciò non interrompe Netstreams e AVStreams che attualmente utilizzano i voucher restituiti per la riproduzione video, ma impedirà riproduzioni future. DRMManager emetterà DRMReturnVoucherCompleteEvent a operazione completata o DRMReturnVoucherErrorEvent se si verifica un errore. Genera ArgumentError se inServerURL è null o se licenseID e policyID sono entrambi null.
Parametri
inServerURL:String — L’URL del server delle licenze dal quale sono state scaricate le licenze restituite.
| |
immediateCommit:Boolean — Riservato. L’unico valore supportato è true.
| |
licenseID:String — (Facoltativo) Vengono restituiti i voucher che corrispondono a questo licenseID. Se è null, viene invece utilizzato policyID.
| |
policyID:String — (Facoltativo) Vengono restituiti i voucher che corrispondono a questo policyID. Se è null, viene invece utilizzato licenseID. Se sia licenseID che policyID non sono null, vengono restituiti solo i voucher che corrispondono a entrambi.
|
setAuthenticationToken | () | metodo |
public function setAuthenticationToken(serverUrl:String, domain:String, token:ByteArray):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5, Flash Player 10.1 |
Imposta il token di autenticazione da utilizzare per la comunicazione con il server e il dominio specificati.
I token di autenticazione sono disponibili nella proprietà token dell'oggetto DRMAuthenticationCompleteEvent inviato dopo una chiamata riuscita al metodo authenticate(). Il token viene memorizzato automaticamente nella cache per la sessione, ma potete utilizzare il metodo setAuthenticationToken() per gestire direttamente i token.
L'impostazione di un token sovrascrive qualunque token memorizzato nella cache per il server e il dominio. Impostate il parametro token su null per cancellare il token memorizzato nella cache.
Parametri
serverUrl:String — L'URL del server di gestione dei diritti multimediali
| |
domain:String — La classe DRMContentData
| |
token:ByteArray — Il token di autenticazione
|
storeVoucher | () | metodo |
authenticationComplete | Evento |
flash.events.DRMAuthenticationCompleteEventproprietà DRMAuthenticationCompleteEvent.type =
flash.events.DRMAuthenticationCompleteEvent.AUTHENTICATION_COMPLETE| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5, Flash Player 10.1 |
DRMManager invia un oggetto DRMAuthenticationCompleteEvent se l'utente viene autenticato dal server di gestione dei diritti multimediali dopo una chiamata al metodo authenticate().
authenticationError | Evento |
flash.events.DRMAuthenticationErrorEventproprietà DRMAuthenticationErrorEvent.type =
flash.events.DRMAuthenticationErrorEvent.AUTHENTICATION_ERROR| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5, Flash Player 10.1 |
DRMManager invia un oggetto DRMAuthenticationErrorEvent se l'utente non viene autenticato dal server di gestione dei diritti multimediali dopo una chiamata al metodo authenticate().
drmError | Evento |
flash.events.DRMErrorEventproprietà DRMErrorEvent.type =
flash.events.DRMErrorEvent.DRM_ERROR| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5, Flash Player 10.1 |
DRMManager invia un oggetto DRMErrorEvent se un voucher richiesto non può essere ottenuto dal server di gestione dei diritti multimediali.
Nota: se un tentativo di caricare un voucher dalla cache dei voucher locali non riesce (utilizzando localOnly come parametro source), NON viene inviato un oggetto DRMErrorEvent, ma viene inviato un oggetto DRMStatusEvent con una proprietà voucher impostata su null.
DRMErrorEvent.DRM_ERROR definisce il valore della proprietà type di un oggetto evento drmError.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
errorID | Un codice di errore numerico assegnato al problema. |
subErrorID | Un codice di errore che indica informazioni più dettagliate sul problema verificatosi. |
target | L'oggetto NetStream. |
drmStatus | Evento |
flash.events.DRMStatusEventproprietà DRMStatusEvent.type =
flash.events.DRMStatusEvent.DRM_STATUS| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.5, Flash Player 10.1 |
DRMManager invia un oggetto DRMStatusEvent se un voucher richiesto viene ottenuto dal server di gestione dei diritti multimediali.
La costanteDRMStatusEvent.DRM_STATUS definisce il valore della proprietà type di un oggetto evento drmStatus.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
detail | Una stringa che descrive il contesto dell'evento di stato |
isAnonymous | Indica se il contenuto, protetto dalla crittografia DRM è disponibile senza che l'utente debba fornire credenziali di autenticazione. |
isAvailableOffline | Indica se il contenuto, protetto dalla crittografia DRM è disponibile non in linea. |
offlineLeasePeriod | Il numero rimanente di giorni in cui il contenuto può essere visualizzato non in linea. |
policies | Oggetto personalizzato dell'evento di stato DRM. |
target | L'oggetto NetStream. |
voucherEndDate | La data assoluta in cui il voucher scade e il contenuto non è più visibile per gli utenti. |
contentData | La classe DRMContentData per il contenuto |
voucher | L'oggetto DRMVoucher per il contenuto. |
isLocal | Indica se il contenuto è memorizzato nel file system locale |
Tue Jun 12 2018, 02:44 PM Z