| 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):voiddrmUpdateNeeded | 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
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate