Pacote | flash.events |
Classe | public class DRMErrorEvent |
Herança | DRMErrorEvent ErrorEvent TextEvent Event Object |
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 10.1 |
O tempo de execução envia um objeto DRMErrorEvent quando um objeto NetStream, ao tentar executar um arquivo criptografado do gerenciamento digital dos direitos (DRM), encontra um erro relacionado ao DRM. Por exemplo, um objeto a DRMErrorEvent é despachado quando o provedor de conteúdo não dá suporte ao aplicativo de exibição ou quando a autorização de usuário falhar, possivelmente devido ao fato do usuário não ter adquirido o conteúdo.
No caso de credenciais de usuário inválidos, o objeto DRMAuthenticateEvent trata o erro enviando repetidamente até que o usuário digite credenciais válidas ou o aplicativo negar tentativas adicionais. O aplicativo deve ouvir demais eventos de erro DRM para poder detectar, identificar e tratar de erros relacionados ao DRM.
Esta classe fornece propriedades que contêm o objeto que lança a exceção, o código de erro e, quando aplicável, um código de suberro e a mensagem de texto que contém informações relacionadas ao erro. Para uma descrição de códigos de erro relacionados ao GERENCIAMENTO DIGITAL DOS DIREITOS, consulte o o Erro de tempo de execução codifica. Os códigos de erro relacionados ao DRM iniciam no erro 3300.
Elementos da API relacionados
Propriedade | Definido por | ||
---|---|---|---|
bubbles : Boolean [somente leitura]
Indica se um evento é do tipo bubbling. | Event | ||
cancelable : Boolean [somente leitura]
Indica se o comportamento associado ao evento pode ser impedido. | Event | ||
constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | ||
contentData : DRMContentData
DRMContentData do arquivo de mídia. | DRMErrorEvent | ||
currentTarget : Object [somente leitura]
O objeto que está processando ativamente o objeto Event com um ouvinte de evento. | Event | ||
drmUpdateNeeded : Boolean [somente leitura]
Indica se uma atualização de DRM é necessária para reproduzir o conteúdo protegido do DRM. | DRMErrorEvent | ||
errorID : int [somente leitura]
Contém o número de referência associado ao erro específico. | ErrorEvent | ||
eventPhase : uint [somente leitura]
A fase atual no fluxo de eventos. | Event | ||
subErrorID : int [somente leitura]
Um erro de ID que indica informações mais detalhadas a respeito do problema subjacente. | DRMErrorEvent | ||
systemUpdateNeeded : Boolean [somente leitura]
Indica se uma atualização do sistema é necessária para reproduzir conteúdo com proteção de DRM. | DRMErrorEvent | ||
target : Object [somente leitura]
O destino de evento. | Event | ||
text : String
Para um evento textInput, o caractere ou string inserida pelo usuário. | TextEvent | ||
type : String [somente leitura]
O tipo de evento. | Event |
Método | Definido por | ||
---|---|---|---|
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)
Cria um objeto Event que contém informações específicas sobre eventos de erros DRM. | DRMErrorEvent | ||
[substituir]
Cria uma cópia do objeto DRMErrorEvent e define o valor de cada propriedade para corresponder ao do original. | DRMErrorEvent | ||
Uma função de utilitário para implementar o método toString() em classes ActionScript 3.0 Event personalizadas. | Event | ||
Indica se um objeto tem uma propriedade especificada definida. | Object | ||
Verifica se o método preventDefault() foi chamado no evento. | Event | ||
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | ||
Cancela um comportamento padrão de evento se esse comportamento puder ser cancelado. | Event | ||
Indica se a propriedade especificada existe e é enumerável. | Object | ||
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | ||
Impede o processamento de qualquer ouvinte de evento no nó atual e qualquer nó subsequente no fluxo de eventos. | Event | ||
Impede o processamento de algum ouvinte de evento em nós subsequentes ao nó atual no fluxo de eventos. | Event | ||
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | ||
[substituir]
Retorna uma string que contém todas as propriedades do objeto DRMErrorEvent. | DRMErrorEvent | ||
Retorna o valor primitivo do objeto especificado. | Object |
Constante | Definido por | ||
---|---|---|---|
DRM_ERROR : String = "drmError" [estático]
A constante DRMErrorEvent.DRM_ERROR define o valor da propriedade type de um objeto de evento drmError. | DRMErrorEvent | ||
DRM_LOAD_DEVICEID_ERROR : String = "drmLoadDeviceIdError" [estático] | DRMErrorEvent |
contentData | propriedade |
contentData:DRMContentData
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.5, Flash Player 10.1 |
DRMContentData do arquivo de mídia.
Você pode usar o objeto referenciado pela propriedade contentData
para recuperar o comprovante do DRM relacionado do cache do comprovante do DRMManager. As propriedades do comprovante descrevem a licença disponível para o usuário e podem explicar por que o conteúdo protegido por DRM não pode ser exibido.
Implementação
public function get contentData():DRMContentData
public function set contentData(value:DRMContentData):void
drmUpdateNeeded | propriedade |
subErrorID | propriedade |
systemUpdateNeeded | propriedade |
DRMErrorEvent | () | Construtor |
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)
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 10.1 |
Cria um objeto Event que contém informações específicas sobre eventos de erros DRM. Objetos Event são transmitidos como parâmetros para ouvintes de eventos.
Parâmetrostype:String (default = NaN ) — O tipo de evento. Ouvintes de eventos podem acessar essas informações por meio da propriedade type herdada. Só existe um tipo de evento DRMAuthenticate: DRMAuthenticateEvent.DRM_AUTHENTICATE .
| |
bubbles:Boolean (default = false ) — Determina se o objeto Event participa do estágio de bubbling do fluxo de eventos. Ouvintes de eventos podem acessar essas informações por meio da propriedade bubbles herdada.
| |
cancelable:Boolean (default = false ) — Determina se o objeto Event pode ser cancelado. Ouvintes de eventos podem acessar essas informações por meio da propriedade cancelable herdada.
| |
inErrorDetail:String (default = " ") — Onde aplicável, os detalhes sintáticos específicos do erro.
| |
inErrorCode:int (default = 0 ) — O código do erro principal.
| |
insubErrorID:int (default = 0 ) — ID do erro secundário.
| |
inMetadata:DRMContentData (default = null )
| |
inSystemUpdateNeeded:Boolean (default = false )
| |
inDrmUpdateNeeded:Boolean (default = false )
|
clone | () | método |
override public function clone():Event
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 10.1 |
Cria uma cópia do objeto DRMErrorEvent e define o valor de cada propriedade para corresponder ao do original.
RetornaEvent — Um novo objeto DRMErrorEvent com valores de propriedade que correspondem aos do original.
|
toString | () | método |
override public function toString():String
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 10.1 |
Retorna uma string que contém todas as propriedades do objeto DRMErrorEvent. A string está no seguinte formato:
[DRMErrorEvent type=value bubbles=value cancelable=value eventPhase=value errroID=value subErrorID=value text=value
String — Uma string que contém todas as propriedades do objeto DRMErrorEvent.
|
DRM_ERROR | Constante |
public static const DRM_ERROR:String = "drmError"
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 10.1 |
A constante DRMErrorEvent.DRM_ERROR
define o valor da propriedade type
de um objeto de evento drmError
.
Esse evento tem as seguintes propriedades:
Propriedade | Valor |
---|---|
bubbles | false |
cancelable | false ; não há comportamento padrão a ser cancelado. |
errorID | Um código de erro numérico atribuído ao problema. |
subErrorID | Um código de erro que indica informações mais detalhadas sobre o problema subjacente. |
target | O objeto NetStream. |
Elementos da API relacionados
DRM_LOAD_DEVICEID_ERROR | Constante |
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()); } } }
Wed Jun 13 2018, 11:10 AM Z