Todos os produtos
Search
Central de documentação

ApsaraVideo VOD:Baixe offline

Última atualização: Jun 27, 2026

O ApsaraVideo VOD oferece um recurso de baixe offline para cenários móveis. Ative esse recurso para permitir que os usuários finais armazenem vídeos em cache nos dispositivos locais e os assistam sem conexão com a internet.

Modos de baixe

O ApsaraVideo VOD disponibiliza um recurso de baixe de vídeo para cenários móveis. Escolha entre dois modos: baixe seguro e baixe padrão. As diferenças estão descritas abaixo:

  • Baixe seguro (Recomendado): Permite que os usuários finais armazenem vídeos em cache nos dispositivos locais para visualização com o ApsaraVideo Player para mobile. Os arquivos de vídeo baixados são criptografados com um arquivo de chave gerado. Apenas o ApsaraVideo Player consegue descriptografar e reproduzir esses arquivos. Não é possível visualizar os vídeos com players de terceiros ou sem descriptografia.

  • Baixe padrão: Permite que os usuários finais armazenem vídeos em cache nos dispositivos locais para visualização com o ApsaraVideo Player para mobile. Os arquivos de vídeo baixados não são criptografados. É possível copiá-los e reproduzi-los em qualquer player. Use este modo com cautela.

O baixe seguro garante que os vídeos baixados permaneçam criptografados e que apenas um aplicativo específico possa reproduzi-los. Especifique um aplicativo fornecendo seu id exclusivo ao gerar um arquivo de chave no console do ApsaraVideo VOD. Este modo é mais seguro e confiável que o baixe padrão, sendo ideal para cenários que exigem proteção de direitos autorais de vídeo. Recomendamos o uso do baixe seguro na maioria dos casos.

Limites

O recurso de baixe offline está integrado ao sdk do ApsaraVideo Player. Para utilizar esse recurso, integre o sdk do ApsaraVideo Player e conclua as configurações de código. Todos os sdks do ApsaraVideo Player suportam baixe offline, exceto o sdk do ApsaraVideo Player para web. Para obter mais informações sobre os métodos de configuração, consulte os seguintes tópicos:

Ative o baixe offline

Ative o baixe padrão

Após ativar o baixe padrão, os usuários finais poderão usar o ApsaraVideo Player para mobile e armazenar vídeos em cache nos dispositivos locais para visualização offline. Os arquivos de vídeo baixados não são criptografados. É possível copiá-los e reproduzi-los em qualquer player. Use este modo com cautela.

  1. Faça login no console do ApsaraVideo VOD.

  2. No painel de navegação à esquerda, escolha Configuration Management > CDN Configuration > Download Settings.

  3. Ative a chave do recurso de baixe. Se o recurso já estiver ativado, clique em Modify. Defina Download Mode como Normal Download e clique em OK.

Ative o baixe seguro

Ao ativar o baixe seguro, os usuários finais podem usar o ApsaraVideo Player para mobile e armazenar vídeos em cache nos dispositivos locais para visualização offline. Um arquivo de chave gerado criptografa os arquivos de vídeo baixados. Apenas o ApsaraVideo Player consegue descriptografá-los e reproduzi-los, sendo impossível visualizá-los em players de terceiros.

  1. Faça login no console do ApsaraVideo VOD.

  2. No painel de navegação à esquerda, escolha Configuration Management > CDN Configuration > Download Settings.

  3. Ative a chave do recurso de baixe. Se o recurso já estiver ativado, clique em Modify. Defina Download Mode como Secure Download e clique em OK.

  4. Na área Get the key, insira o id exclusivo do aplicativo e a chave privada de descriptografia offline e clique em Generate and Download Key.

    Após configurar o baixe seguro, é necessário descriptografar os vídeos offline com uma chave antes da reprodução.

    A chave privada de criptografia de vídeo offline é um arquivo binário gerado com base no id exclusivo do aplicativo e na chave privada de descriptografia offline inseridos. A geração da chave utiliza um algoritmo privado e ela fica disponível para baixe. Após baixar a chave, armazene-a com segurança no aplicativo cliente. O sdk do ApsaraVideo Player usa essa chave durante o processo de baixe e reprodução de vídeo offline.

    Nota

    É possível gerar várias chaves para diferentes clientes.

    Nome do parâmetro

    Descrição

    id exclusivo do aplicativo

    • Android: Valor SHA-1 do arquivo keystore. O valor SHA-1 obtido deve ser uma string com dois-pontos.

    • iOS: App Bundle ID.

    • Windows: Número de série do certificado de assinatura digital.

    Para obter mais informações sobre como conseguir o id exclusivo do aplicativo, consulte Obter o id exclusivo do aplicativo.

    Chave privada de descriptografia offline

    String de chave privada personalizada. A string deve ter entre 16 e 32 caracteres e conter uma combinação de letras e dígitos. É obrigatório incluir letras maiúsculas, minúsculas e dígitos.

  5. Salve o arquivo de chave gerado no aplicativo cliente e configure-o no sdk do ApsaraVideo Player.

Obter o id exclusivo do aplicativo

Android

As informações de assinatura de um aplicativo Android correspondem ao valor SHA-1 do arquivo keystore. Utilize o recurso signingReport do Android Studio para gerar um relatório de assinatura e obter essas informações.

iOS

Trata-se do Bundle ID do aplicativo iOS.

Desativar baixe offline de vídeo

Após ativar o recurso de baixe offline, é possível desativar o baixe offline para vídeos específicos. Isso impede o baixe desses vídeos por meio do ApsaraVideo Player.

Nota
  • A desativação do baixe offline só é permitida quando o vídeo está no estado Normal.

  • Este recurso impede downloads apenas pelo ApsaraVideo Player. Ele não bloqueia downloads feitos por outros navegadores ou players de terceiros.

  1. Faça login no console do ApsaraVideo VOD.

  2. No painel de navegação à esquerda, escolha Media Files > Audio/Video.

  3. Na coluna Actions do vídeo desejado, clique em More e selecione Disable Download.

  4. Na caixa de diálogo exibida, clique em OK.

Referências

Para obter mais informações sobre como baixar ativos de mídia no ApsaraVideo VOD, consulte Baixar arquivos de mídia.