DRMManager  - AS3

A propriedade isSupported será definida como true se a classe DRMManager for suportada na plataforma atual; de outra maneira, ela será definida como false.

adiciona o dispositivo atualmente em execução a um grupo de dispositivos.

Parâmetros

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

Elementos da API relacionados

Retorna uma ocorrência do único objeto DRMManager.

Existe uma ocorrência de DRMManager para cada domínio de segurança.

Elementos da API relacionados

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

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

Remove o dispositivo em execução no momento de um grupo de dispositivos.

Parâmetros

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().

Elementos da API relacionados

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

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

Parâmetros

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().

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().

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.

Esse evento tem as seguintes propriedades:

O DRMManager despacha um objeto DRMStatusEvent quando um comprovante solicitado é obtido do servidor de direitos de mídia.

Esse evento tem as seguintes propriedades: