ApsaraVideo VOD:Reproduzir um vídeo criptografado

VOD (VidAuth)

Para reproduzir um vídeo com criptografia proprietária da Alibaba Cloud usando o método VidAuth do ApsaraVideo VOD, é obrigatório passar também o parâmetro encryptType: 1 para habilitar a criptografia proprietária. Isso não é necessário para reproduzir vídeos padrão.

// The player
let urlSource: UrlSource = new UrlSource()
// The playback URL of a live or on-demand stream with HLS standard encryption.
urlSource.setUri("The playback URL")
aliPlayer.setUrlDataSource(urlSource)

Live (LiveStsSource)

Para reproduzir uma transmissão ao vivo que utiliza criptografia proprietária com o método LiveStsSource, forneça a URL da transmissão e uma credencial temporária STS. Para obter informações sobre como gerar a credencial, consulte Obter um token STS.

// The player
let urlSource: UrlSource = new UrlSource()
// The playback URL of a live or on-demand stream with HLS standard encryption.
urlSource.setUri("The playback URL")
aliPlayer.setUrlDataSource(urlSource)

VOD (VidAuth)

Ao reproduzir um vídeo com criptografia padrão HLS usando o método VidAuth do ApsaraVideo VOD, caso o vídeo possua outros fluxos não criptografados com HLS padrão ou fluxos transcodificados padrão, defina o parâmetro EncryptType como HLSEncryption para filtrar e reproduzir apenas o fluxo com criptografia padrão HLS.

// The player
let urlSource: UrlSource = new UrlSource()
// The playback URL of a live or on-demand stream with HLS standard encryption.
urlSource.setUri("The playback URL")
aliPlayer.setUrlDataSource(urlSource)

VOD (VidSts)

Ao reproduzir um vídeo com criptografia padrão HLS usando o método VidSts do ApsaraVideo VOD, se o vídeo também tiver outros fluxos não criptografados com HLS padrão ou fluxos transcodificados padrão, defina o parâmetro EncryptType como HLSEncryption para filtrar e reproduzir apenas o fluxo com criptografia padrão HLS.

// The player
let urlSource: UrlSource = new UrlSource()
// The playback URL of a live or on-demand stream with HLS standard encryption.
urlSource.setUri("The playback URL")
aliPlayer.setUrlDataSource(urlSource)

UrlSource

Ao reproduzir um fluxo ao vivo ou sob demanda que utiliza criptografia padrão HLS com o método UrlSource, nenhum parâmetro adicional é necessário. A configuração é idêntica à reprodução de um vídeo padrão.

// The player
let urlSource: UrlSource = new UrlSource()
// The playback URL of a live or on-demand stream with HLS standard encryption.
urlSource.setUri("The playback URL")
aliPlayer.setUrlDataSource(urlSource)

VOD (VidSts)

Para reproduzir um vídeo criptografado com DRM usando o método VidSts do ApsaraVideo VOD, é obrigatório passar também o parâmetro isDrm: true .

// The player
let urlSource: UrlSource = new UrlSource()
// The playback URL of a live or on-demand stream with HLS standard encryption.
urlSource.setUri("The playback URL")
aliPlayer.setUrlDataSource(urlSource)

Live (LiveStsSource)

Para reproduzir uma transmissão ao vivo criptografada com DRM usando o método LiveStsSource, forneça a URL da transmissão e uma credencial temporária STS. Para obter informações sobre como gerar uma credencial temporária STS, consulte Obter um token STS.

// The player
let urlSource: UrlSource = new UrlSource()
// The playback URL of a live or on-demand stream with HLS standard encryption.
urlSource.setUri("The playback URL")
aliPlayer.setUrlDataSource(urlSource)

VidSts

Primeiro, configure a criptografia DRM conforme descrito em Configurar criptografia DRM para o ApsaraVideo VOD. Ao reproduzir um vídeo criptografado com DRM usando o VidSts do ApsaraVideo VOD, a configuração é idêntica à de um vídeo não criptografado. Nenhum parâmetro adicional é necessário.

// The player
let urlSource: UrlSource = new UrlSource()
// The playback URL of a live or on-demand stream with HLS standard encryption.
urlSource.setUri("The playback URL")
aliPlayer.setUrlDataSource(urlSource)

LiveSts

Primeiro, configure a criptografia DRM conforme descrito em Configurar criptografia DRM para o ApsaraVideo Live. Para reproduzir um stream ao vivo criptografado com DRM usando o objeto LiveSts, é necessário fornecer a URL e uma credencial STS, além de definir o tipo de criptografia do vídeo como WideVine_FairPlay. O código abaixo serve de exemplo:

1. Crie uma fonte de dados.

   É obrigatório passar LiveSts como fonte de reprodução.

   // The player
   let urlSource: UrlSource = new UrlSource()
   // The playback URL of a live or on-demand stream with HLS standard encryption.
   urlSource.setUri("The playback URL")
   aliPlayer.setUrlDataSource(urlSource)

2. Monitore a invalidação do STS.

   Durante a reprodução de conteúdo ao vivo criptografado, a chave de criptografia pode ser rotacionada. Quando isso ocorre, o player utiliza a credencial STS para solicitar a nova chave. Monitore a validade da credencial STS, pois uma credencial inválida interrompe a reprodução.

   // The player
   let urlSource: UrlSource = new UrlSource()
   // The playback URL of a live or on-demand stream with HLS standard encryption.
   urlSource.setUri("The playback URL")
   aliPlayer.setUrlDataSource(urlSource)

   Nota

   Após obter uma nova credencial STS com sucesso, chame o método updateLiveStsInfo para atualizá-la. Se não for possível obter uma nova credencial, recomenda-se parar a reprodução. Sem a atualização da credencial STS, o player continuará usando a antiga para solicitar chaves mesmo após a expiração. Caso a credencial STS se torne inválida, isso pode causar falha na reprodução ou corrupção na saída de vídeo.

   // The player
   let urlSource: UrlSource = new UrlSource()
   // The playback URL of a live or on-demand stream with HLS standard encryption.
   urlSource.setUri("The playback URL")
   aliPlayer.setUrlDataSource(urlSource)

UrlSource

Primeiramente, consulte Empacotamento VOD para configurar a criptografia DRM. Ao reproduzir um vídeo criptografado com DRM usando o método UrlSource, além das configurações para um vídeo normal, implemente a interface DrmCallback para obter as informações de chave do vídeo.

// The player
let urlSource: UrlSource = new UrlSource()
// The playback URL of a live or on-demand stream with HLS standard encryption.
urlSource.setUri("The playback URL")
aliPlayer.setUrlDataSource(urlSource)

VidAuth for VOD

Ao reproduzir um vídeo HLS ou MP4 com criptografia privada usando o método VidAuth do ApsaraVideo VOD, caso o vídeo também possua streams não criptografados ou transcodificados padrão, defina o tipo de criptografia como AliyunVoDEncryption para reproduzir apenas o stream com criptografia privada.

// The player
let urlSource: UrlSource = new UrlSource()
// The playback URL of a live or on-demand stream with HLS standard encryption.
urlSource.setUri("The playback URL")
aliPlayer.setUrlDataSource(urlSource)

VidSts for VOD

Ao reproduzir um vídeo HLS ou MP4 com criptografia privada usando o método VidSts do ApsaraVideo VOD, caso o vídeo também possua streams não criptografados ou transcodificados padrão, defina o tipo de criptografia como AliyunVoDEncryption para reproduzir apenas o stream com criptografia privada.

// The player
let urlSource: UrlSource = new UrlSource()
// The playback URL of a live or on-demand stream with HLS standard encryption.
urlSource.setUri("The playback URL")
aliPlayer.setUrlDataSource(urlSource)

LiveStsSource for live

Para reproduzir um stream ao vivo com criptografia privada nos formatos HLS ou FLV usando o método LiveStsSource, forneça a URL do stream e uma credencial STS, e defina o tipo de criptografia de vídeo como ENCRYPTION_TYPE_ALIVODENCRYPTION. O código abaixo serve como exemplo:

1. Crie uma fonte de dados.

   É necessário passar AVPLiveStsSource como fonte de reprodução.

   // The player
   let urlSource: UrlSource = new UrlSource()
   // The playback URL of a live or on-demand stream with HLS standard encryption.
   urlSource.setUri("The playback URL")
   aliPlayer.setUrlDataSource(urlSource)

2. Monitore a invalidação da credencial STS.

   Durante a reprodução ao vivo criptografada, a chave de criptografia pode ser rotacionada. Quando isso ocorre, o player utiliza a credencial STS para solicitar a nova chave. Monitore a validade da credencial, pois uma credencial inválida interrompe a reprodução.

   // The player
   let urlSource: UrlSource = new UrlSource()
   // The playback URL of a live or on-demand stream with HLS standard encryption.
   urlSource.setUri("The playback URL")
   aliPlayer.setUrlDataSource(urlSource)

   Nota

   Após obter uma nova credencial STS, chame o método updateLiveStsInfo para atualizá-la. Se a tentativa de obter uma nova credencial falhar, recomenda-se parar a reprodução. Caso a credencial STS não seja atualizada, o player tentará usar a credencial expirada para solicitar a chave, o que pode causar artefatos na tela ou falha na reprodução.

   // The player
   let urlSource: UrlSource = new UrlSource()
   // The playback URL of a live or on-demand stream with HLS standard encryption.
   urlSource.setUri("The playback URL")
   aliPlayer.setUrlDataSource(urlSource)

UrlSource for VOD

Para reproduzir um vídeo HLS ou MP4 com criptografia privada baseada em licença usando o método UrlSource, chame a operação GetPlayInfo para obter a URL de reprodução do vídeo. Após obter a URL do vídeo, anexe o parâmetro etavirp_nuyila=1 à URL antes de passá-la ao player. Esse parâmetro pode ser colocado em qualquer parte da query string. Ele é obrigatório apenas para vídeos MP4. Para vídeos HLS, utilize a URL original do vídeo. A configuração do player é idêntica à de um vídeo padrão, sem necessidade de parâmetros adicionais.

Exemplo de URL de reprodução 1: https://example.aliyundoc.com/test.mp4?etavirp_nuyila=1

Exemplo de URL de reprodução 2: https://example.aliyundoc.com/test.mp4?auth_key=xxxxx&etavirp_nuyila=1

// The player
let urlSource: UrlSource = new UrlSource()
// The playback URL of a live or on-demand stream with HLS standard encryption.
urlSource.setUri("The playback URL")
aliPlayer.setUrlDataSource(urlSource)

VidAuth for VOD

Ao reproduzir um vídeo criptografado com a criptografia padrão HLS usando o método VidAuth do ApsaraVideo VOD, caso o vídeo também possua streams não criptografados ou transcodificados padrão, defina o tipo de criptografia como HLSEncryption para reproduzir apenas o stream com criptografia padrão HLS. O código abaixo serve como exemplo:

// The player
let urlSource: UrlSource = new UrlSource()
// The playback URL of a live or on-demand stream with HLS standard encryption.
urlSource.setUri("The playback URL")
aliPlayer.setUrlDataSource(urlSource)

VidSts for VOD

Ao reproduzir um vídeo criptografado com a criptografia padrão HLS usando o método VidSts do ApsaraVideo VOD, caso o vídeo também possua streams não criptografados ou transcodificados padrão, defina o tipo de criptografia como HLSEncryption para reproduzir apenas o stream com criptografia padrão HLS. O código abaixo serve como exemplo:

// The player
let urlSource: UrlSource = new UrlSource()
// The playback URL of a live or on-demand stream with HLS standard encryption.
urlSource.setUri("The playback URL")
aliPlayer.setUrlDataSource(urlSource)

UrlSource

Ao utilizar o método UrlSource para reproduzir um stream com criptografia padrão HLS, a configuração do player é idêntica à de um vídeo padrão, sem necessidade de parâmetros adicionais.

Recomenda-se o uso do ApsaraVideo VOD. Chame a operação GetPlayInfo para obter a URL de reprodução do vídeo e passe-a ao player.

// The player
let urlSource: UrlSource = new UrlSource()
// The playback URL of a live or on-demand stream with HLS standard encryption.
urlSource.setUri("The playback URL")
aliPlayer.setUrlDataSource(urlSource)

VidSts for VOD

Primeiro, consulte Configure DRM Encryption for VOD para configurar a criptografia DRM. Ao reproduzir um vídeo criptografado com DRM usando o método VidSts do ApsaraVideo VOD, a configuração é idêntica à de um vídeo padrão. Nenhum parâmetro adicional é necessário.

// The player
let urlSource: UrlSource = new UrlSource()
// The playback URL of a live or on-demand stream with HLS standard encryption.
urlSource.setUri("The playback URL")
aliPlayer.setUrlDataSource(urlSource)

LiveStsSource for live

Primeiro, consulte Configure DRM Encryption for Live Streaming para configurar a criptografia DRM. Para reproduzir um stream ao vivo criptografado com DRM usando o método LiveStsSource, forneça a URL do stream e uma credencial STS, e defina o tipo de criptografia de vídeo como ENCRYPTION_TYPE_FAIRPLAY。 O código abaixo serve como exemplo:

1. Crie uma fonte de dados.

   É necessário passar AVPLiveStsSource como fonte de reprodução.

   // The player
   let urlSource: UrlSource = new UrlSource()
   // The playback URL of a live or on-demand stream with HLS standard encryption.
   urlSource.setUri("The playback URL")
   aliPlayer.setUrlDataSource(urlSource)

2. Monitore a invalidação da credencial STS.

   Durante a reprodução ao vivo criptografada, a chave de criptografia pode ser rotacionada. Quando isso ocorre, o player utiliza a credencial STS para solicitar a nova chave. Monitore a validade da credencial, pois uma credencial inválida interrompe a reprodução.

   // The player
   let urlSource: UrlSource = new UrlSource()
   // The playback URL of a live or on-demand stream with HLS standard encryption.
   urlSource.setUri("The playback URL")
   aliPlayer.setUrlDataSource(urlSource)

   Nota

   Após obter uma nova credencial STS, chame o método updateLiveStsInfo para atualizá-la. Se a tentativa de obter uma nova credencial falhar, recomenda-se parar a reprodução. Caso a credencial STS não seja atualizada, o player tentará usar a credencial expirada para solicitar a chave, o que pode causar artefatos na tela ou falha na reprodução.

   // The player
   let urlSource: UrlSource = new UrlSource()
   // The playback URL of a live or on-demand stream with HLS standard encryption.
   urlSource.setUri("The playback URL")
   aliPlayer.setUrlDataSource(urlSource)

UrlSource for FairPlay

Primeiro, consulte Live Packaging para configurar a criptografia DRM. Ao reproduzir um vídeo criptografado com DRM usando o método UrlSource, além de utilizar a mesma configuração de um vídeo comum, implemente a interface AVPDrmDelegate para obter o certificado FairPlay e a chave do vídeo.

// The player
let urlSource: UrlSource = new UrlSource()
// The playback URL of a live or on-demand stream with HLS standard encryption.
urlSource.setUri("The playback URL")
aliPlayer.setUrlDataSource(urlSource)

VidAuth

Ao reproduzir um vídeo HLS ou MP4 com criptografia privada usando o método VidAuth do ApsaraVideo for VOD, caso o vídeo também contenha streams não criptografados ou transcodificados padrão, defina o tipo de criptografia como AliyunVoDEncryption para reproduzir apenas o stream com criptografia privada.

// The player
let urlSource: UrlSource = new UrlSource()
// The playback URL of a live or on-demand stream with HLS standard encryption.
urlSource.setUri("The playback URL")
aliPlayer.setUrlDataSource(urlSource)

VidSts

Ao reproduzir um vídeo HLS ou MP4 com criptografia privada usando o método VidSts do ApsaraVideo for VOD, caso o vídeo também contenha streams não criptografados ou transcodificados padrão, defina o tipo de criptografia como AliyunVoDEncryption para reproduzir apenas o stream com criptografia privada.

// The player
let urlSource: UrlSource = new UrlSource()
// The playback URL of a live or on-demand stream with HLS standard encryption.
urlSource.setUri("The playback URL")
aliPlayer.setUrlDataSource(urlSource)

UrlSource

Ao reproduzir um vídeo nos formatos HLS ou MP4 criptografado com criptografia privada baseada em licença usando reprodução via UrlSource, chame a operação Obtain audio or video playback URL para obter a URL de reprodução. Anexe etavirp_nuyila=1 à URL obtida antes de passá-la ao player. (Esse parâmetro é obrigatório apenas para arquivos MP4. Para arquivos HLS, utilize diretamente a URL original do vídeo.) A configuração do Player SDK é idêntica à de um vídeo padrão, sem necessidade de parâmetros adicionais.

Exemplo de URL de reprodução 1: https://example.aliyundoc.com/test.mp4?etavirp_nuyila=1

Exemplo de URL de reprodução 2: https://example.aliyundoc.com/test.mp4?auth_key=xxxxx&etavirp_nuyila=1

// The player
let urlSource: UrlSource = new UrlSource()
// The playback URL of a live or on-demand stream with HLS standard encryption.
urlSource.setUri("The playback URL")
aliPlayer.setUrlDataSource(urlSource)

VidAuth

Ao reproduzir um vídeo com criptografia padrão HLS usando o método VidAuth do ApsaraVideo for VOD, caso o vídeo também contenha streams com outros tipos de criptografia ou streams transcodificados não criptografados, defina o tipo de criptografia como HLSEncryption para reproduzir apenas o stream com criptografia padrão HLS. O código abaixo serve como exemplo:

// The player
let urlSource: UrlSource = new UrlSource()
// The playback URL of a live or on-demand stream with HLS standard encryption.
urlSource.setUri("The playback URL")
aliPlayer.setUrlDataSource(urlSource)

VidSts

Ao reproduzir um vídeo com criptografia padrão HLS usando o método VidSts do ApsaraVideo for VOD, caso o vídeo também contenha streams com outros tipos de criptografia ou streams transcodificados não criptografados, defina o tipo de criptografia como HLSEncryption para reproduzir apenas o stream com criptografia padrão HLS. O código abaixo serve como exemplo:

// The player
let urlSource: UrlSource = new UrlSource()
// The playback URL of a live or on-demand stream with HLS standard encryption.
urlSource.setUri("The playback URL")
aliPlayer.setUrlDataSource(urlSource)

UrlSource

Ao utilizar o método UrlSource para reproduzir um stream ao vivo ou sob demanda com criptografia padrão HLS, a configuração do Player SDK é idêntica à de um vídeo padrão.

Para obter a URL de reprodução, recomenda-se chamar a operação GetPlayInfo no ApsaraVideo for VOD.

// The player
let urlSource: UrlSource = new UrlSource()
// The playback URL of a live or on-demand stream with HLS standard encryption.
urlSource.setUri("The playback URL")
aliPlayer.setUrlDataSource(urlSource)