Você pode enviar arquivos de mídia de servidores de aplicação para buckets do Object Storage Service (OSS) alocados ao ApsaraVideo VOD. O ApsaraVideo VOD oferece SDKs de upload para servidor nas linguagens de programação mais comuns, além de demos. Esses SDKs encapsulam a lógica necessária para obter URLs e credenciais de upload. Basta configurar os parâmetros básicos antes de iniciar os uploads com os SDKs. Este tópico descreve os cenários, o processo de upload e o uso dos SDKs de upload para servidor.
Cenários
Use os SDKs de upload para servidor quando precisar automatizar uploads ou transferir um grande volume de arquivos de vídeo ou arquivos de mídia online. Para enviar arquivos de mídia online, baixe-os primeiro para um servidor de aplicação e, em seguida, envie-os para o ApsaraVideo VOD a partir desse servidor.
Recurso | Descrição | Observações |
Linguagens de programação | Suporte para Java, Python, PHP, C e C++. | Para outras linguagens, use os SDKs do OSS. Para mais informações, consulte Upload de arquivos de mídia com SDKs do OSS. |
Arquivos de mídia suportados | Para detalhes sobre os formatos de arquivo de mídia suportados, consulte Upload de mídia. É possível enviar arquivos locais e online. Arquivos online são transferidos por meio de URLs. |
Nota Ao fazer upload via URL, codifique o endereço para evitar falhas causadas por caracteres especiais. |
Endereços de armazenamento | Use o endereço de armazenamento padrão ou especifique um personalizado. | É possível alterar o endereço de armazenamento padrão. Para mais informações, consulte Gerenciar buckets de armazenamento. O upload baseado em URL está disponível apenas na região China (Shanghai). Defina o parâmetro StorageLocation ao chamar uma operação de API para obter a URL e a credencial de upload caso precise especificar o endereço de armazenamento. |
Upload via rede interna | Se você implantar o script de upload em uma instância do Elastic Compute Service (ECS), especifique a região da instância na lógica de upload. Quando a região da instância ECS coincidir com a região de armazenamento do ApsaraVideo VOD, os arquivos serão enviados automaticamente pela rede interna. Isso acelera as transferências e reduz o consumo de tráfego de Internet. | A API do ApsaraVideo VOD só aceita chamadas via nomes de domínio públicos. Portanto, implante o script de upload em uma instância ECS com acesso à Internet. |
Gerenciamento de ativos de mídia | Configure metadados de mídia, como títulos, tags, categorias e miniaturas. | Parâmetros como Title, Tags, CateId e CoverURL permitem configurar os metadados durante a chamada da operação que obtém a URL e a credencial de upload. |
Transcodificação de áudio e vídeo | Especifique um modelo ou fluxo de trabalho de transcodificação para processar os arquivos de áudio e vídeo enviados. Também é possível enviar arquivos de áudio e vídeo sem transcodificá-los. | Configure a transcodificação definindo parâmetros como TemplateGroupId e WorkflowId ao chamar a operação para obter a URL e a credencial de upload. |
Controle de upload | Configure a barra de progresso de upload e utilize callbacks de progresso padrão ou personalizados. O recurso de upload retomável está disponível exclusivamente no SDK de upload para servidor em Java. Os SDKs para outras linguagens não oferecem suporte a essa funcionalidade. | Não é possível configurar a barra de progresso de upload para arquivos M3U8. |
Notificações de eventos | Configure callbacks para receber notificações sobre eventos de upload. Para mais detalhes sobre as notificações de eventos suportadas, consulte Upload de mídia. | Para saber como configurar os callbacks, consulte Configurar callbacks. |
Autorização de upload | Conceda permissão de upload por meio de uma credencial de upload. Nesse caso, use um par de AccessKey de uma conta Alibaba Cloud ou de um usuário RAM autorizado para inicializar uma instância de upload. Alternativamente, conceda a permissão usando um token do Security Token Service (STS). Nessa situação, use o token STS para inicializar a instância de upload. | Caso opte pela autorização via token STS, implante um serviço dedicado para obter esses tokens. |
Aceleração de upload | Ative o recurso de aceleração de upload para utilizá-lo. É necessário submit a ticket para ativar esse recurso. | Após a ativação, configure o recurso definindo |
O ApsaraVideo VOD fornece as seguintes operações de API para obter URLs e credenciais de upload:
Processo de upload
Os SDKs de upload para servidor encapsulam tanto a lógica de obtenção de URLs e credenciais quanto a lógica de upload do OSS. Basta configurar os parâmetros básicos antes de iniciar os uploads com os SDKs. A figura a seguir ilustra o processo completo de upload.
Processo de upload
Integre o SDK de upload para servidor ao seu servidor de aplicação e conclua as configurações de upload. Por exemplo, configure o par de AccessKey, o caminho do arquivo, o endereço de armazenamento, as informações do ativo de mídia, as definições de transcodificação e os controles de upload.
-
O servidor de aplicação usa o SDK de upload para servidor para chamar uma operação de API e obter a URL de upload, a credencial de upload e as informações do ativo de mídia.
NotaComo alternativa, construa uma solicitação HTTP ou HTTPS para obter a URL e a credencial de upload. No entanto, esse método exige a construção manual de uma assinatura, o que pode gerar erros. O ApsaraVideo VOD oferece as seguintes operações relacionadas a URLs e credenciais de upload:
-
O ApsaraVideo VOD retorna a URL de upload, a credencial de upload e o ID de mídia para o servidor de aplicação.
NotaO ApsaraVideo VOD gera IDs de mídia ao retornar URLs e credenciais de upload. Esses IDs são essenciais para o gerenciamento do ciclo de vida e o processamento de mídia.
Para vídeos, o ID de mídia é retornado no parâmetro
VideoId.Para imagens, o ID de mídia é retornado no parâmetro
ImageId.Para ativos de mídia auxiliares, o ID de mídia é retornado no parâmetro
MediaId.Registre os IDs de mídia retornados, pois eles são necessários para tarefas subsequentes, como gerenciamento de ativos de mídia, reprodução de áudio e vídeo e processamento de mídia.
O servidor de aplicação inicia o upload com base na lógica de upload do OSS encapsulada pelo SDK de upload para servidor.
-
O cliente OSS retorna o resultado do upload.
NotaTambém é possível configurar previamente um callback para monitorar o resultado do upload.
Referências
O procedimento de integração e uso dos SDKs de upload para servidor varia conforme a linguagem de programação. Para mais informações sobre como integrar e usar esses SDKs, consulte os tópicos a seguir:
Diferenças entre SDKs de upload para servidor e SDKs de operação para servidor
Os SDKs de upload para servidor e os SDKs de operação para servidor fornecidos pelo ApsaraVideo VOD têm finalidades distintas. Os SDKs de upload encapsulam toda a lógica de upload, permitindo que você integre o SDK e inicie as transferências imediatamente. Já os SDKs de operação integram todos os recursos do ApsaraVideo VOD. No que diz respeito ao upload, os SDKs de operação encapsulam apenas a lógica para obter a URL e a credencial. Se optar pelos SDKs de operação para enviar arquivos de mídia, desenvolva a lógica de upload por conta própria. Isso inclui obter a URL e a credencial no ApsaraVideo VOD, decodificar o conteúdo em Base64 e usar o OSS para transferir os arquivos. Para mais informações sobre os SDKs de operação para servidor do ApsaraVideo VOD, consulte Server SDK Reference.