ApsaraVideo VOD:Download de arquivos de mídia

Cenários

• Download pelo console: ideal para validação rápida ou exportação temporária de poucos arquivos.

• Download via API: recomendado para processamento em lote automatizado de arquivos.

• Download offline com SDK do player: indicado para cenários de aplicativos personalizados.

Cenário 1: Download pelo console

Baixar um único arquivo

O console é a melhor opção para baixar alguns arquivos destinados a testes ou validações rápidas.

1. Faça login no ApsaraVideo VOD console.

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

3. Localize o arquivo desejado, clique em Manage na coluna Actions, selecione a aba Video URL ou Audio URL e clique em Copy na definição desejada.

4. Cole a URL copiada em um navegador ou ferramenta de download para iniciar o processo.

Baixar vários arquivos

Use o recurso de exportação em lote para obter informações de ativos de múltiplos arquivos.

1. Faça login no ApsaraVideo VOD console.

2. No painel de navegação à esquerda, escolha Media Files e selecione Audio/Video ou Image.

3. Use o filtro ou o recurso de pesquisa para localizar e selecionar os arquivos a exportar.

4. Clique no ícone no canto superior direito para exportar as informações dos ativos de mídia.

5. Cole as URLs dos ativos de mídia em um navegador ou ferramenta de download para iniciar o processo.

Cenário 2: Download via API

Obter URLs de download

Use as APIs abaixo para obter URLs de download de arquivos originais, transcodificados e miniaturas.

Obter URLs de download em lote

Executar o download

O exemplo abaixo com Python SDK automatiza o download. Outros exemplos estão disponíveis no OpenAPI Portal.

1. Prepare o ambiente.

   Instale o SDK do VOD para Python.

   pip install aliyun-python-sdk-vod

2. Obtenha a URL de download.

   Chame a operação GetMezzanineInfo para recuperar as informações do arquivo original.

   import json
   from aliyunsdkcore.client import AcsClient
   from aliyunsdkvod.request.v20170321 import GetMezzanineInfoRequest
   
   # Initialize the client
   # Replace with your AccessKey ID, AccessKey secret, and region ID
   client = AcsClient('YOUR_ACCESS_KEY_ID', 'YOUR_ACCESS_KEY_SECRET', 'cn-shanghai')
   
   # 1. Create a request
   request = GetMezzanineInfoRequest()
   request.set_accept_format('json')
   request.set_VideoId("YOUR_VIDEO_ID") # Replace with your video ID
   request.set_OutputType("oss")  # Recommended: Returns the OSS storage address for lower cost
   request.set_AuthTimeout(3600)  # Set the URL validity period to 1 hour (3600 seconds)
   
   # 2. Send the request and get the response
   response = client.do_action_with_exception(request)
   result = json.loads(response)
   
   # 3. Parse the download URL
   download_url = result['Mezzanine']['FileURL']
   print(f"Source file download URL: {download_url}")
   
   # (Optional) Use the requests library to download the file
   import requests
   print("Starting file download...")
   file_response = requests.get(download_url, stream=True)
   if file_response.status_code == 200:
       with open('downloaded_video.mp4', 'wb') as f:
           for chunk in file_response.iter_content(chunk_size=8192):
               f.write(chunk)
       print("File downloaded successfully: downloaded_video.mp4")
   else:
       print(f"Download failed, status code: {file_response.status_code}")
       print(f"Error message: {file_response.text}")

Cenário 3: Download offline com SDK do player

O VOD permite armazenar vídeos em cache localmente em dispositivos móveis para visualização offline em dois modos: download padrão e download seguro.

• Download padrão: o vídeo não é criptografado e pode ser copiado e reproduzido por qualquer player. Adequado para conteúdo público ou cenários com baixa restrição de direitos autorais.

• Download seguro: o vídeo é criptografado e só pode ser reproduzido pelo ApsaraVideo Player SDK integrado à chave correspondente. Recomendado para cursos pagos e conteúdo sensível a direitos autorais.

Etapas

1. Configure o modo de download.

   1. Faça login no ApsaraVideo VOD console. Acesse Configuration Management > CDN Configuration > Download Settings.

   2. Selecione o download padrão ou seguro. Para o download seguro, gere e armazene a chave de criptografia com segurança nesta página.

2. Integre o SDK do player.

   Integre o ApsaraVideo Player SDK ao seu projeto Android ou iOS: Integrate the Android SDK, Integrate the iOS SDK.

3. Conclua o download do vídeo.

   Integre o módulo de download de vídeo ao seu projeto Android ou iOS: Video download for Android, Video download for iOS.

4. Baixe vários vídeos simultaneamente.

   O ApsaraVideo Player SDK não suporta o download de múltiplos vídeos ao mesmo tempo com uma única instância de downloader. Instancie um AliMediaDownloader separado para cada vídeo. Ao baixar vários vídeos, observe os seguintes limites e recomendações:

   • Use o padrão singleton para gerenciar a fila de downloads e mantenha um pool fixo de downloaders ativos, como três a cinco, para processamento simultâneo.

   • Após o término de uma tarefa de download, chame stop() e release() para liberar os recursos do downloader.

   • O PlayAuth tem validade de 3000 segundos. Antes de chamar prepare, verifique se a credencial ainda é válida. Caso tenha expirado, chame updateSource() para renovar a credencial PlayAuth e continuar o download.

Faturamento

As URLs de download dividem-se em duas categorias:

• Endereço de armazenamento

  • Sem um nome de domínio acelerado, os downloads usam diretamente o endereço de armazenamento e geram taxas de outbound traffic.

• Endereço acelerado:

  • Se você configure an accelerated domain name, as URLs de download tornam-se URLs aceleradas, proporcionando downloads mais rápidos e gerando taxas de acceleration service.

  • Ao configurar blacklists and whitelists, restrições como proteção contra hotlinking de Referer e listas de bloqueios de IP são aplicadas, seguindo as mesmas regras da reprodução online.

Perguntas frequentes

Por que não consigo reproduzir o vídeo baixado?

Se a saída transcodificada usar criptografia (como criptografia HLS), o arquivo baixado permanecerá criptografado. Use o ApsaraVideo Player SDK para descriptografá-lo e reproduzi-lo. Video encryption.

Como faço para baixar muitos arquivos de mídia?

Use SearchMedia - Search Media Information com paginação para recuperar as URLs dos arquivos e siga Scenario 2: Download via API para baixar.

Posso adicionar uma marca d'água dinamicamente ao baixar um vídeo?

O ApsaraVideo VOD não suporta a adição dinâmica de marca d'água via API durante o download de um vídeo. Para baixar um vídeo com marca d'água, mas reproduzir uma versão sem ela, configure as versões com e sem marca d'água como definições diferentes. Em seguida, siga o Cenário 1 ou Cenário 2 deste tópico para obter e baixar o arquivo de vídeo na definição necessária.

A expiração da URL afeta um download em andamento?

Se uma URL de download expirar durante a transferência, o download não será interrompido nem ficará mais lento. O processo já iniciado continua até a conclusão. Caso solicite o arquivo novamente e a falha ocorra ou o download fique lento, chame a operação GetPlayInfo para gerar uma nova URL de download. Defina o parâmetro OutputType como oss, estenda o período de validade da URL conforme necessário e tente baixar novamente.