| Pacote | flash.net.drm |
| Classe | public class DRMManager |
| Herança | DRMManager  EventDispatcher Object |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.5, Flash Player 10.1 |
DRMManager.getDRMManager(), você pode acessar o objeto DRMManager existente para realizar as seguintes tarefas de gestão de DRM:
- Comprovantes de pré-carga de um servidor de direitos de mídia, usando um objeto DRMContentData.
- Você pode consultar o cache local para obter um comprovante individual usando um objeto DRMContentData.
- Reinicialize todos os comprovantes (somente AIR)
Não é fornecido nenhum método para enumerar todos os comprovantes no cache local.
Não crie uma instância da classe DRMManager. Use o DRMManager.getDRMManager() estático para acessar o objeto DRMManager existente.
Suporte para perfil AIR: este recurso conta com o suporte de dispositivos AIR for TV e de todos os sistemas operacionais para desktop, mas não é compatível com dispositivos móveis. Você pode testar o suporte que em tempo de execução utilizando a propriedadeDRMManager.isSupported. Consulte Suporte a perfil do AIR para obter mais informações sobre o suporte de API através de múltiplos perfis.
Elementos da API relacionados
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas| Propriedade | Definido por | ||
|---|---|---|---|
 | constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
| isSupported : Boolean [estático] [somente leitura]
A propriedade isSupported será definida como true se a classe DRMManager for suportada na plataforma atual; de outra maneira, ela será definida como false. | DRMManager | ||
| networkIdleTimeout : Number [estático] | DRMManager | ||
| Método | Definido por | ||
|---|---|---|---|
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento. | EventDispatcher | |
adiciona o dispositivo atualmente em execução a um grupo de dispositivos. | DRMManager | ||
Autentica um usuário. | DRMManager | ||
|
Envia um evento para o fluxo de eventos. | EventDispatcher | |
[estático]
Retorna uma ocorrência do único objeto DRMManager. | DRMManager | ||
|
Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento. | EventDispatcher | |
|
Indica se um objeto tem uma propriedade especificada definida. | Object | |
|
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | |
Adquire um comprovante de visualização do servidor de licença, que você pode usar para deixar um usuário verificar se eles podem reproduzir o conteúdo em um determinado computador. | DRMManager | ||
Carrega um comprovante de um servidor de direitos de mídia ou o cache do comprovante local. | DRMManager | ||
|
Indica se a propriedade especificada existe e é enumerável. | Object | |
|
Remove um ouvinte do objeto EventDispatcher. | EventDispatcher | |
Remove o dispositivo em execução no momento de um grupo de dispositivos. | DRMManager | ||
Em aplicativos AIR, isso exclui todos os dados do comprovante do gerenciamento de direitos digitais (DRM) armazenados localmente. | DRMManager | ||
Retorna ao servidor de licença todos os comprovantes que correspondem aos critérios especificados. | DRMManager | ||
Define o token de autenticação a ser usado para comunicação com o servidor e o domínio especificados. | DRMManager | ||
|
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | |
| DRMManager | |||
|
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | |
|
Retorna a representação de string do objeto especificado. | Object | |
|
Retorna o valor primitivo do objeto especificado. | Object | |
|
Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado. | EventDispatcher | |
| Evento | Resumo | Definido por | ||
|---|---|---|---|---|
| [transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR ganha o foco do sistema operacional e está se tornando inativo. | EventDispatcher | ||
| O DRMManager despacha um objeto DRMAuthenticationCompleteEvent quando o usuário não é autenticado pelo servidor de direitos de mídia depois de uma chamada para o método authenticate(). | DRMManager | |||
| O DRMManager despacha um objeto DRMAuthenticationErrorEvent quando o usuário não é autenticado pelo servidor de direitos de mídia depois de uma chamada para o método authenticate(). | DRMManager | |||
| [transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR perde o foco do sistema operacional e está se tornando inativo. | EventDispatcher | ||
| O DRMManager despacha um objeto DRMErrorEvent quando um comprovante solicitado não pode ser obtido do servidor de direitos de mídia. | DRMManager | |||
| O DRMManager despacha um objeto DRMStatusEvent quando um comprovante solicitado é obtido do servidor de direitos de mídia. | DRMManager | |||
isSupported | propriedade |
isSupported:Boolean [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.1, AIR 2 |
A propriedade isSupported será definida como true se a classe DRMManager for suportada na plataforma atual; de outra maneira, ela será definida como false.
Implementação
public static function get isSupported():BooleannetworkIdleTimeout | propriedade |
addToDeviceGroup | () | método |
public function addToDeviceGroup(deviceGroup:DRMDeviceGroup, forceRefresh:Boolean = false):void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3.0, Flash Player 11.9 |
adiciona o dispositivo atualmente em execução a um grupo de dispositivos.
Parâmetros
deviceGroup:DRMDeviceGroup | |
forceRefresh:Boolean (default = false) |
authenticate | () | método |
public function authenticate(serverURL:String, domain:String, username:String, password:String):void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.5, Flash Player 10.1 |
Autentica um usuário.
Ouça os eventos authenticationComplete e authenticationError para determinar o resultado da tentativa de autenticação. Várias chamadas authenticate() são enfileiradas. O objeto AuthenticationCompleteEvent despachado para o evento authenticationComplete contém um token de autenticação que o aplicativo pode salvar.
Você pode usar um token de autenticação salvo, ou um token baixado por outro meio, para estabelecer uma sessão autenticada com o servidor de direitos de mídia no futuro. Para estabelecer uma sessão usando um token, chame o método DRMManager setAuthenticationToken(). As propriedades do token, como a data de expiração, são determinadas pelas configurações do servidor que geram o token.
Importante (AIR somente): O método authenticate() não será bem-sucedido quando a conexão com a Internet de um usuário passar por um servidor proxy que exija autenticação. Embora esses usuários não possam pré-carregar um comprovante do DRM que exija autenticação, o aplicativo pode obter o comprovante iniciando a reprodução e usando o método setAuthenticationCredentials() de NetStream para registrar o usuário nos servidores proxy e de direitos de mídia. Depois que o comprovante for obtido, o usuário poderá exibir o conteúdo offline (desde que a licença representada pelo comprovante permita reprodução offline).
Parâmetros
serverURL:String — A URL de um servidor de direitos de mídia que pode fornecer um comprovante para exibição de conteúdo protegido
| |
domain:String — Um domínio no servidor (não é nome de rede ou de domínio da Internet)
| |
username:String — O nome de usuário
| |
password:String — A senha do usuário
|
Elementos da API relacionados
getDRMManager | () | método |
public static function getDRMManager():DRMManager| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.5, Flash Player 10.1 |
Retorna uma ocorrência do único objeto DRMManager.
Existe uma ocorrência de DRMManager para cada domínio de segurança.
RetornaDRMManager |
Elementos da API relacionados
loadPreviewVoucher | () | método |
public function loadPreviewVoucher(contentData:DRMContentData):void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2, Flash Player 10.1 |
Adquire um comprovante de visualização do servidor de licença, que você pode usar para deixar um usuário verificar se eles podem reproduzir o conteúdo em um determinado computador. Esta capacidade permite que os usuários verifiquem se eles podem reproduzir o conteúdo no seu computador antes de comprar e carregar do conteúdo. É útil quando o computador do usuário não tem os recursos de proteção de saída necessários ou software necessário para reproduzir o conteúdo.
Como loadVoucher(), este método é uma chamada assíncrona e emite um DRMStatusEvent na conclusão ou um DRMErrorEvent em caso de erros.
Parâmetros
contentData:DRMContentData |
loadVoucher | () | método |
public function loadVoucher(contentData:DRMContentData, setting:String):void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.5, Flash Player 10.1 |
Carrega um comprovante de um servidor de direitos de mídia ou o cache do comprovante local.
O comprovante é carregado de acordo com o parâmetro setting:
- LoadVoucherSetting.FORCE_REFRESH: O comprovante sempre é baixado do servidor de direitos de mídia.
- LoadVoucherSetting.LOCAL_ONLY: O comprovante só é carregado do cache local.
- LoadVoucherSetting.ALLOW_SERVER: O comprovante é carregado do cache local, se possível, se não, é baixado do servidor.
A classe LoadVoucherSetting define constantes de strings a serem usadas como valores para o parâmetro setting.
Quando o comprovante é carregado com êxito, o DRMManager despacha um evento de status do DRM. O aplicativo pode começar a reprodução assim que o comprovante é carregado. O comprovante carregado está disponível na propriedade voucher do objeto DRMStatusEvent despachado. Você pode usar esse objeto de comprovante para exibir as informações de direitos de mídia associadas ao usuário.
Caso um comprovante não possa ser carregado do servidor de direitos de mídia, um evento de erro do DRM é despachado. A propriedade errorID do objeto DRMErrorEvent despachado indica o motivo da falha. Entre as causas comuns de falha estão a tentativa de conexão com o servidor de direitos de mídia quando o usuário está offline e a tentativa de carregamento de um comprovante quando o usuário não está registrado. O aplicativo pode responder a esses erros e realizar uma ação corretiva. Por exemplo, caso as credenciais de autenticação sejam obrigatórias para baixar o comprovante, você pode solicitar ao usuário o nome e a senha de usuário da conta, chamar o método authenticate() do DRMManager e, em seguida, tentar carregar novamente o comprovante.
Caso um comprovante não possa ser obtido do cache local e a configuração localOnly seja usada, DRMErrorEvent não é despachado. Em vez disso, um evento de status do DRM é despachado. A propriedade detail desse objeto DRMStatusEvent continua sendo DRM.voucherObtained, mas a propriedade voucher é null.
Parâmetros
contentData:DRMContentData — O objeto DRMContentData de um arquivo de mídia protegido por DRM
| |
setting:String — Determina se o comprovante é recuperado do cache local ou do servidor de direitos de mídia
|
removeFromDeviceGroup | () | método |
public function removeFromDeviceGroup(deviceGroup:DRMDeviceGroup):void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3.0, Flash Player 11.9 |
Remove o dispositivo em execução no momento de um grupo de dispositivos.
Parâmetros
deviceGroup:DRMDeviceGroup |
resetDRMVouchers | () | método |
public function resetDRMVouchers():void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.5, Flash Player 11.8 |
Em aplicativos AIR, isso exclui todos os dados do comprovante do gerenciamento de direitos digitais (DRM) armazenados localmente. Em aplicativos baseados no navegador, isso só está disponível nos erros 3322, 3346, 3323, 3326 e se comporta conforme o painel Configurações de reprodução do conteúdo protegido.
O aplicativo deve baixar o comprovante obrigatório novamente para que o usuário possa acessar o conteúdo criptografado. Chamar essa função equivale a chamar Netstream.resetDRMVouchers().
Lança
IOError — O comprovante não pode ser excluído.
|
Elementos da API relacionados
returnVoucher | () | método |
public function returnVoucher(inServerURL:String, immediateCommit:Boolean, licenseID:String, policyID:String):void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 11.8, AIR 3.8 |
Retorna ao servidor de licença todos os comprovantes que correspondem aos critérios especificados. Quando o comprovante é retornado, ele é removido do armazenamento em disco e da memória. Isso não interromperá Netstreams e AVStreams que atualmente usam os comprovantes retornados para reprodução de vídeo, mas proibirá uma reprodução futura. O DRMManager emitirá um DRMReturnVoucherCompleteEvent com êxito ou um DRMReturnVoucherErrorEvent com erro. Jogará um ArgumentError se o inServerURL for nulo ou se a licenseID e a policyID forem nulas.
Parâmetros
inServerURL:String — As URLs do servidor de licença das quais as licenças retornadas foram baixadas.
| |
immediateCommit:Boolean — Reservada. O único valor suportado é verdadeiro.
| |
licenseID:String — Os comprovantes correspondentes (opcional) a essa licenseID serão retornados. Se nulo, a policyID será utilizada.
| |
policyID:String — Os comprovantes correspondentes (opcional) a essa policyID serão retornados. Se nulo, a licenseID será utilizada. Se a licenseID e a policyID não são nulas, somente um comprovante que corresponda à licenseID e à policyID será retornado.
|
setAuthenticationToken | () | método |
public function setAuthenticationToken(serverUrl:String, domain:String, token:ByteArray):void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.5, Flash Player 10.1 |
Define o token de autenticação a ser usado para comunicação com o servidor e o domínio especificados.
Os tokens de autenticação estão disponíveis na propriedade token do objeto DRMAuthenticationCompleteEvent despachado após uma chamada bem-sucedida para o método authenticate(). O token é automaticamente armazenado em cache para a sessão, mas você pode usar o método setAuthenticationToken() para gerenciar tokens diretamente.
Configurar um token substitui todos os tokens em cache existentes para o servidor e o domínio. Defina o parâmetro token como null para limpar o token em cache.
Parâmetros
serverUrl:String — A URL do servidor de direitos de mídia
| |
domain:String — O DRMContentData
| |
token:ByteArray — O token de autenticação
|
storeVoucher | () | método |
authenticationComplete | Evento |
flash.events.DRMAuthenticationCompleteEventpropriedade DRMAuthenticationCompleteEvent.type =
flash.events.DRMAuthenticationCompleteEvent.AUTHENTICATION_COMPLETE| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.5, Flash Player 10.1 |
O DRMManager despacha um objeto DRMAuthenticationCompleteEvent quando o usuário não é autenticado pelo servidor de direitos de mídia depois de uma chamada para o método authenticate().
authenticationError | Evento |
flash.events.DRMAuthenticationErrorEventpropriedade DRMAuthenticationErrorEvent.type =
flash.events.DRMAuthenticationErrorEvent.AUTHENTICATION_ERROR| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.5, Flash Player 10.1 |
O DRMManager despacha um objeto DRMAuthenticationErrorEvent quando o usuário não é autenticado pelo servidor de direitos de mídia depois de uma chamada para o método authenticate().
drmError | Evento |
flash.events.DRMErrorEventpropriedade DRMErrorEvent.type =
flash.events.DRMErrorEvent.DRM_ERROR| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.5, Flash Player 10.1 |
O DRMManager despacha um objeto DRMErrorEvent quando um comprovante solicitado não pode ser obtido do servidor de direitos de mídia.
Observação: Quando uma tentativa de carregar um comprovante do cache de comprovante local (usando o localOnly como o parâmetro source) falha, o objeto DRMErrorEvent não é despachado. Em vez disso, um objeto DRMStatusEvent com uma propriedade voucher definida como null é despachado.
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. |
drmStatus | Evento |
flash.events.DRMStatusEventpropriedade DRMStatusEvent.type =
flash.events.DRMStatusEvent.DRM_STATUS| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.5, Flash Player 10.1 |
O DRMManager despacha um objeto DRMStatusEvent quando um comprovante solicitado é obtido do servidor de direitos de mídia.
A constanteDRMStatusEvent.DRM_STATUS define o valor propriedade type de um objeto de evento drmStatus.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
detail | A string que explica o contexto do evento de status. |
isAnonymous | Indica se o conteúdo, protegido pela criptografia do DRM, está disponível sem precisar que o usuário forneça as credenciais de autenticação. |
isAvailableOffline | Indica se o conteúdo, protegido pela criptografia do DRM, está disponível offline. |
offlineLeasePeriod | O número de dias remanescentes em que o conteúdo pode ser exibido offline. |
diretrizes | Um objeto personalizado do evento de status DRM. |
target | O objeto NetStream. |
voucherEndDate | A data absoluta em que o voucher vence e o conteúdo não pode mais ser exibido pelos usuários |
contentData | DRMContentData de conteúdo |
comprovante | O objeto DRMVoucher do conteúdo. |
isLocal | Indica se o conteúdo é armazenado no sistema de arquivos local |
Wed Jun 13 2018, 11:10 AM Z