Pacchetto | flash.events |
Classe | public class DRMErrorEvent |
Ereditarietà | DRMErrorEvent ErrorEvent TextEvent Event Object |
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 10.1 |
Il runtime invia un oggetto DRMErrorEvent quando un oggetto NetStream che tenta di riprodurre un file crittografato DRM (Digital Rights Management) incontra un errore relativo a DRM. Ad esempio, un oggetto DRMErrorEvent viene inviato se il fornitore di contenuto non supporta l'applicazione di visualizzazione o se l'autorizzazione utente fallisce, forse perché l'utente non ha acquistato il contenuto.
Nel caso di credenziali utente non valide, l'oggetto DRMAuthenticateEvent gestisce l'errore inviandosi ripetutamente, fino a quando l'utente non immette credenziali valide o l'applicazione impedisce ulteriori tentativi. L'applicazione deve restare in ascolto di eventuali altri eventi di errore DRM per rilevare, identificare e gestire gli errori relativi a DRM.
Questa classe fornisce le proprietà che contengono l'oggetto che genera l'eccezione, il codice di errore e, dove applicabile, un codice di errore secondario e un messaggio di testo che contiene le informazioni relative all'errore. Per una descrizione dei codici di errore DRM, vedete Codici di errore runtime. I codici di errore DRM iniziano dall'errore 3300.
Altri esempi
Elementi API correlati
Proprietà | Definito da | ||
---|---|---|---|
bubbles : Boolean [sola lettura]
Indica se un evento è un evento di bubbling. | Event | ||
cancelable : Boolean [sola lettura]
Indica se il comportamento associato all'evento può essere impedito. | Event | ||
constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | ||
contentData : DRMContentData
La classe DRMContentData del file multimediale. | DRMErrorEvent | ||
currentTarget : Object [sola lettura]
L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. | Event | ||
drmUpdateNeeded : Boolean [sola lettura]
Indica se è necessario un aggiornamento DRM per riprodurre il contenuto con protezione DRM. | DRMErrorEvent | ||
errorID : int [sola lettura]
Contiene il numero di riferimento associato all'errore specifico. | ErrorEvent | ||
eventPhase : uint [sola lettura]
La fase attuale del flusso di eventi. | Event | ||
subErrorID : int [sola lettura]
Un ID di errore che indica informazioni più dettagliate sul problema verificatosi. | DRMErrorEvent | ||
systemUpdateNeeded : Boolean [sola lettura]
Indica se è necessario un aggiornamento del sistema per riprodurre il contenuto con protezione DRM. | DRMErrorEvent | ||
target : Object [sola lettura]
Il target dell'evento. | Event | ||
text : String
Per un evento textInput, il carattere o la sequenza di caratteri immessi dall'utente. | TextEvent | ||
type : String [sola lettura]
Il tipo di evento. | Event |
Metodo | Definito da | ||
---|---|---|---|
DRMErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, inErrorDetail:String = "", inErrorCode:int = 0, insubErrorID:int = 0, inMetadata:DRMContentData = null, inSystemUpdateNeeded:Boolean = false, inDrmUpdateNeeded:Boolean = false)
Crea un oggetto Event contenente informazioni specifiche sugli eventi di errore DRM. | DRMErrorEvent | ||
[override]
Crea una copia dell'oggetto DRMErrorEvent e imposta il valore di ogni proprietà in modo che corrisponda a quello dell'originale. | DRMErrorEvent | ||
Una funzione dell'utilità per l'implementazione del metodo toString() in classi Event ActionScript 3.0 personalizzate. | Event | ||
Indica se per un oggetto è definita una proprietà specifica. | Object | ||
Verifica se sull'evento è stato chiamato il metodo preventDefault(). | Event | ||
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | ||
Annulla il comportamento predefinito di un evento se tale comportamento può essere annullato. | Event | ||
Indica se la proprietà specificata esiste ed è enumerabile. | Object | ||
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | ||
Impedisce l'elaborazione di tutti i listener di eventi nel nodo corrente e in tutti i nodi successivi del flusso di eventi. | Event | ||
Impedisce l'elaborazione di tutti i listener di eventi nei nodi del flusso di eventi successivi a quello corrente. | Event | ||
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | ||
[override]
Restituisce una stringa che contiene tutte le proprietà dell'oggetto DRMErrorEvent. | DRMErrorEvent | ||
Restituisce il valore di base dell'oggetto specificato. | Object |
Costante | Definito da | ||
---|---|---|---|
DRM_ERROR : String = "drmError" [statico]
La costante DRMErrorEvent.DRM_ERROR definisce il valore della proprietà type di un oggetto evento drmError. | DRMErrorEvent | ||
DRM_LOAD_DEVICEID_ERROR : String = "drmLoadDeviceIdError" [statico] | DRMErrorEvent |
contentData | proprietà |
contentData:DRMContentData
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.5, Flash Player 10.1 |
La classe DRMContentData del file multimediale.
Potete utilizzare l'oggetto a cui fa riferimento la proprietà contentData
per recuperare il relativo voucher DRM dalla cache voucher di DRMManager. Le proprietà del voucher descrivono la licenza disponibile per l'utente e possono spiegare perché non è possibile visualizzare il contenuto con protezione DRM.
Implementazione
public function get contentData():DRMContentData
public function set contentData(value:DRMContentData):void
drmUpdateNeeded | proprietà |
subErrorID | proprietà |
systemUpdateNeeded | proprietà |
DRMErrorEvent | () | Funzione di costruzione |
public function DRMErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, inErrorDetail:String = "", inErrorCode:int = 0, insubErrorID:int = 0, inMetadata:DRMContentData = null, inSystemUpdateNeeded:Boolean = false, inDrmUpdateNeeded:Boolean = false)
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 10.1 |
Crea un oggetto Event contenente informazioni specifiche sugli eventi di errore DRM. Gli oggetti evento vengono passati ai listener di eventi come parametri.
Parametritype:String (default = NaN ) — Il tipo di evento. I listener di eventi possono accedere a queste informazioni tramite la proprietà ereditata type . Esiste un solo tipo di evento DRMAuthenticate: DRMAuthenticateEvent.DRM_AUTHENTICATE .
| |
bubbles:Boolean (default = false ) — Determina se l'oggetto Event partecipa alla fase di bubbling del flusso di eventi. I listener di eventi possono accedere a queste informazioni tramite la proprietà ereditata bubbles .
| |
cancelable:Boolean (default = false ) — Determina se l'oggetto Event può essere annullato. I listener di eventi possono accedere a queste informazioni tramite la proprietà ereditata cancelable .
| |
inErrorDetail:String (default = " ") — Se applicabili, i dettagli sintattici specifici dell'errore.
| |
inErrorCode:int (default = 0 ) — Il codice di errore principale.
| |
insubErrorID:int (default = 0 ) — L'ID errore secondario.
| |
inMetadata:DRMContentData (default = null )
| |
inSystemUpdateNeeded:Boolean (default = false )
| |
inDrmUpdateNeeded:Boolean (default = false )
|
clone | () | metodo |
override public function clone():Event
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 10.1 |
Crea una copia dell'oggetto DRMErrorEvent e imposta il valore di ogni proprietà in modo che corrisponda a quello dell'originale.
RestituisceEvent — Un nuovo oggetto DRMErrorEvent con proprietà dai valori identici a quelli dell'originale.
|
toString | () | metodo |
override public function toString():String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 10.1 |
Restituisce una stringa che contiene tutte le proprietà dell'oggetto DRMErrorEvent. La stringa ha il seguente formato:
[DRMErrorEvent type=valore bubbles=valore cancelable=valore eventPhase=valore errorID=valore subErrorID=valore text=valore]
String — Una stringa che contiene tutte le proprietà dell'oggetto DRMErrorEvent.
|
DRM_ERROR | Costante |
public static const DRM_ERROR:String = "drmError"
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 10.1 |
La costante 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. |
Elementi API correlati
DRM_LOAD_DEVICEID_ERROR | Costante |
public static const DRM_LOAD_DEVICEID_ERROR:String = "drmLoadDeviceIdError"
package { import flash.display.Sprite; import flash.events.AsyncErrorEvent; import flash.events.NetStatusEvent; import flash.events.DRMErrorEvent; import flash.media.Video; import flash.net.NetConnection; import flash.net.NetStream; public class DRMVideoExample extends Sprite { var videoURL:String = "Video.flv"; var videoConnection:NetConnection; var videoStream:NetStream; var video:Video = new Video(); public function DRMVideoExample() { videoConnection = new NetConnection(); videoConnection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); videoConnection.connect(null); } private function connectStream():void { videoStream = new NetStream(videoConnection); videoStream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); videoStream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler); videoStream.addEventListener(DRMErrorEvent.DRM_ERROR, drmErrorEventHandler); video.attachNetStream(videoStream); videoStream.play(videoURL); addChild(video); } private function netStatusHandler(event:NetStatusEvent):void { switch (event.info.code) { case "NetConnection.Connect.Success": connectStream(); break; case "NetStream.Play.StreamNotFound": trace("Unable to locate video: " + videoURL); break; } } private function asyncErrorHandler(event:AsyncErrorEvent):void { // ignore AsyncErrorEvent events. } private function drmErrorEventHandler(event:DRMErrorEvent):void { trace(event.toString()); } } }
Tue Jun 12 2018, 02:44 PM Z