O upload de mídia envia seus recursos de mídia para o ApsaraVideo VOD e é um pré-requisito para outros services do ApsaraVideo VOD, como gerenciamento de ativos de mídia, processamento de mídia, entrega e reprodução. Este tópico descreve o que confirme antes do upload, os métodos de upload disponíveis, as notificações de eventos de upload e o que fazer após o upload.
Antes do upload
Formatos de mídia suportados
O ApsaraVideo VOD suporta o upload de arquivos de mídia, como vídeos, áudio, imagens e ativos de mídia auxiliares (marcas d'água, legendas e arquivos de material). Os arquivos podem ser locais ou de rede (arquivos de rede usam upload por pull de URL). A tabela a seguir lista os formatos suportados por cada tipo de mídia.
Insira a extensão do nome do arquivo ao fazer o upload. As extensões não diferenciam maiúsculas de minúsculas. Por exemplo, MP4 e mp4 são equivalentes.
| Tipo de mídia | Formatos de arquivo suportados |
| Vídeo |
Nota Para enviar um arquivo M3U8 pelo console do ApsaraVideo VOD, use apenas o upload por pull de URL. Para enviar um arquivo M3U8 local, utilize a api ou o SDK do ApsaraVideo VOD. Para mais detalhes, consulte Upload media files by using the ApsaraVideo VOD api
|
| Áudio | MP3, WMA, WAV, AAC, RA, M4A, FLAC, APE, AC3, AMR, CAF, ACM. |
| Imagem | PNG, JPG, JPEG, GIF, HEIC. |
| Ativo de mídia auxiliar |
|
O upload de mídia do ApsaraVideo VOD suporta apenas os tipos de mídia listados acima. Para enviar outros tipos de arquivo, siga as etapas em Upload files to oss.
Regiões de armazenamento
O ApsaraVideo VOD armazena recursos de mídia com base no object storage service (oss) da Alibaba Cloud. Cada nó de armazenamento corresponde a uma região de armazenamento, e o ApsaraVideo VOD atribui um endereço de armazenamento para cada região.
Ao enviar arquivos pelo console do ApsaraVideo VOD ou pelo cliente para PC, o endereço de armazenamento baseia-se na região em que você fez login ou selecione. Ao utilizar um SDK ou api, especifique o endereço de armazenamento por meio de um parâmetro, como o parâmetro StorageLocation da operação UploadMediaByURL.
O ApsaraVideo VOD suporta as seguintes regiões de armazenamento e IDs de região:
|
Região de armazenamento |
ID da região |
|
China (Shanghai) |
cn-shanghai |
|
China (Beijing) |
cn-beijing |
|
China (Shenzhen) |
cn-shenzhen |
|
China (Hong Kong) |
cn-hongkong |
|
Japan (Tokyo) |
ap-northeast-1 |
|
Singapore |
ap-southeast-1 |
|
Indonesia (Jakarta) |
ap-southeast-5 |
|
Germany (Frankfurt) |
eu-central-1 |
|
US (Silicon Valley) |
us-west-1 |
Por padrão, o ApsaraVideo VOD não compartilha dados entre regiões na mesma conta. Antes de iniciar o upload, certifique-se de que a região de envio corresponda à sua região de negócios real. Caso contrário, talvez você não encontre seus arquivos.
Sobre endereços de armazenamento
|
Configurações de endereço de armazenamento disponíveis |
Descrição |
|
Ative o endereço de armazenamento do sistema ApsaraVideo VOD |
Após ativar o ApsaraVideo VOD, cada região de service recebe, por padrão, um bucket de armazenamento independente (um bucket do sistema ApsaraVideo VOD). Ative esse bucket para enviar e gerencie recursos de mídia sem configurações adicionais. Para mais detalhes, consulte Manage storage buckets. |
|
Adicionar um endereço de armazenamento |
Adicione seu próprio bucket do oss ao ApsaraVideo VOD para transcodificar, capturar snapshots e reproduzir arquivos de mídia armazenados nesse bucket. Para mais detalhes, consulte Manage storage buckets. |
|
Modifique o endereço de armazenamento padrão |
Após ativar endereços de armazenamento para múltiplas regiões ou adicionar vários endereços, modifique o endereço padrão. Durante o upload, especifique um endereço de armazenamento ou deixe-o em branco. Se nenhum for especificado, o ApsaraVideo VOD usará o endereço padrão. Para mais detalhes, consulte Manage storage buckets. |
Faturamento de armazenamento
O armazenamento do ApsaraVideo VOD oferece dois métodos de faturamento: pagamento conforme o uso (pós-pago) e planos de recursos (pré-pagos).
Para pagamento conforme o uso, consulte Media asset storage billing.
Para planos de recursos, consulte ApsaraVideo VOD storage plan.
Métodos de upload
O ApsaraVideo VOD fornece métodos de upload manual e programático (automatizado) para diferentes cenários de uso. Utilize as orientações a seguir para escolha o método adequado e consulte a tabela de visão geral para obter detalhes.
Enviar rapidamente poucos arquivos pequenos: Use o console.
Enviar arquivos grandes ou execute uploads longos: Use o cliente para PC.
Uploads em lote ou integração automatizada: Use o SDK de upload do lado do servidor.
Enviar arquivos de rede: Use o upload por pull de URL.
| Método de upload | Cenários | Descrição | |
| Upload manual | Upload files to the ApsaraVideo VOD console | Cenários que exigem uma maneira rápida e prática de enviar recursos de mídia para o ApsaraVideo VOD. Nota Devido às políticas de segurança do console, uploads longos podem falhar para arquivos grandes quando a sessão de login expira. Para evitar esse problema, envie arquivos grandes com o cliente para PC. |
|
| Upload files using the Windows client | Arquivos grandes, uploads longos e cenários operacionais de baixa complexidade. |
| |
| Integração programática | Upload using Upload SDK |
Nota Recomendamos o SDK de upload. Se o SDK de upload não suportar sua linguagem, utilize um SDK nativo do oss para concluir o upload. |
|
| Upload media files using oss SDKs |
|
Nota Para Java, Python, PHP e C/C++, recomendamos o SDK de upload do ApsaraVideo VOD. | |
| Batch upload from URLs | Cenários em que os arquivos não estão armazenados em um servidor ou terminal local e devem ser enviados a partir de uma URL acessível pela rede pública. |
|
Comparação de recursos por método de upload
A tabela a seguir compara os recursos suportados por cada método durante o upload. As marcas ① e ② correspondem às explicações de recursos que seguem a tabela.
|
Grupo |
Recurso |
console |
Cliente para PC |
SDK do lado do servidor-Java |
SDK do lado do servidor-Python |
SDK do lado do servidor-PHP |
SDK do lado do servidor-C/C++ |
SDK do oss |
|
Gerenciamento de ativos de mídia |
Defina o título da mídia |
Suportado |
Suportado |
Suportado |
Suportado |
Suportado |
Suportado |
Suportado |
|
Especifique a categoria da mídia |
Suportado |
Suportado |
Suportado |
Suportado |
Suportado |
Suportado |
Suportado |
|
|
Defina tags de mídia |
Não suportado |
Suportado |
Suportado |
Suportado |
Suportado |
Suportado |
Suportado |
|
|
Defina a miniatura do vídeo |
Não suportado |
Não suportado |
Suportado |
Suportado |
Suportado |
Suportado |
Suportado |
|
|
Transcodificação de áudio e vídeo① |
Grupo de modelos de transcodificação |
Suportado |
Suportado |
Suportado |
Suportado |
Suportado |
Suportado |
Suportado |
|
Workflow de mídia |
Suportado |
Não suportado |
Suportado |
Suportado |
Suportado |
Suportado |
Suportado |
|
|
Sem transcodificação |
Suportado |
Suportado |
Suportado |
Suportado |
Suportado |
Suportado |
Suportado |
|
|
Controle de upload② |
Obter progresso do upload |
Suportado |
Suportado |
Suportado |
Suportado |
Suportado |
Suportado |
Suportado |
|
Upload retomável |
Não suportado |
Não suportado |
Suportado apenas pelo SDK de upload Java |
Suportado |
Não suportado |
Não suportado |
Não suportado |
|
|
Upload multipartido |
Ativado por padrão |
Ativado por padrão |
Ativado por padrão |
Ativado por padrão |
Ativado por padrão |
Ativado por padrão |
Ativado por padrão |
As notas a seguir explicam os grupos de recursos marcados com ① e ② na tabela anterior.
Transcodificação de áudio e vídeo①
Configure a transcodificação ao enviar um arquivo de áudio ou vídeo (especificando um grupo de modelos de transcodificação ou um workflow de mídia), e a transcodificação iniciará automaticamente após a conclusão do upload. Também é possível optar por não transcodificar. No entanto, observe que Apenas vídeos nos seguintes formatos podem ser reproduzidos sem transcodificação: MP4, FLV, M3U8, MP3 e WEBM.
Transcodificar com um grupo de modelos de transcodificação: O uso de um grupo de modelos de transcodificação é o método de processamento padrão do ApsaraVideo VOD. Durante o upload, selecione o método de processamento por grupo de modelos de transcodificação. O ApsaraVideo VOD inicia a transcodificação automaticamente após a conclusão do upload.
Transcodificar com um workflow de mídia: Após crie um workflow de mídia que contenha tarefas de transcodificação, selecione o método de processamento por workflow de mídia durante o upload. Depois que o upload for concluído, o ApsaraVideo VOD executará automaticamente o workflow especificado para finalizar a transcodificação.
Sem transcodificação: Se não precisar de transcodificação durante o upload, selecione o modelo No Transcoding no grupo de modelos de transcodificação.
Controle de upload②
Upload multipartido: O arquivo a ser enviado é dividido em várias partes enviadas separadamente e combinadas em um único objeto após a conclusão do upload. O ApsaraVideo VOD envia arquivos usando upload multipartido por padrão.
Ao usar o upload multipartido, se o upload falhar, arquivos fragmentados poderão ser gerados. Eles são limpos automaticamente após cerca de sete dias. Você também pode chamar a operação DeleteMultipartUpload para limpar os arquivos fragmentados manualmente.
Obter progresso ou status do upload.
Upload retomável: Se um erro de rede causar falha no upload, o ApsaraVideo VOD retoma o envio a partir da última parte enviada com sucesso, garantindo a continuidade do processo.
O upload retomável é gerenciado internamente pelo SDK de upload (cliente). Não é necessário gerencie pontos de interrupção ou recuperação de fragmentos, pois um novo envio após falha causada por exceção recomeça do ponto de interrupção.
Notificações de eventos de upload
Após a conclusão do upload de um arquivo de mídia, obtenha o progresso e o status do processamento em tempo hábil por meio de um endereço de callback pré-configurado. O ApsaraVideo VOD suporta dois métodos de callback para notificações de eventos: callback HTTP (compatível com https) e callback do Message service (MNS). Para saber mais sobre a configuração de callback, consulte Event notification. Para concluir a configuração, consulte Configure callbacks. Todos os métodos de upload suportam notificações de eventos. Os eventos relacionados ao upload estão listados na tabela a seguir.
Para detalhes sobre cada evento, consulte Event notifications.
| Nome do evento | Tipo de evento | Descrição |
| Video Upload Complete | FileUploadComplete | Gerado após o servidor do ApsaraVideo VOD terminar de receber um arquivo de áudio ou vídeo enviado. Nota Para áudio e vídeo não transcodificados (ou apenas áudio), a URL de reprodução só fica disponível após o recebimento da notificação do evento Video Upload Complete. Se a transcodificação foi desativada durante o upload, após receber essa notificação, chame a operação Submit media transcoding jobs para transcodificar. |
| Image Upload Complete | ImageUploadComplete | Gerado após o servidor do ApsaraVideo VOD terminar de receber um arquivo de imagem enviado. |
| Auxiliary Media Upload Complete | AttachedMediaUploadComplete | Gerado após o servidor do ApsaraVideo VOD terminar de receber um arquivo de ativo de mídia auxiliar enviado. |
| Video Upload from URL Complete | UploadByURLComplete | Após chamar a tarefa Upload media files by URL, o evento UploadByURLComplete é gerado quando a cloud termina de puxar e enviar o vídeo. |
| Stream Transcode Complete | StreamTranscodeComplete | Gerado quando um stream de definição e formato específicos para um vídeo (por exemplo, um arquivo MP4 em definição padrão) termina a transcodificação. Nota Para áudio e vídeo transcodificados, a URL de reprodução só fica disponível após o recebimento da notificação do evento Stream Transcode Complete. Tentar reproduzir antes de receber o callback pode causar falha na reprodução. |
| Video Transcode Complete | TranscodeComplete | Gerado quando todos os streams de um vídeo terminam a transcodificação. Nota Para garantir que todas as definições estejam disponíveis antes da reprodução, aguarde até receber a notificação do evento Video Transcode Complete antes de prosseguir. Tentar reproduzir antes de receber o callback pode causar falha na reprodução. |
O que fazer após o upload
Depois que os recursos de mídia são enviados para o ApsaraVideo VOD, eles assumem diferentes status de mídia dependendo da situação e do estágio de processamento dos negócios. Recursos de áudio e vídeo em diferentes status suportam operações distintas. Por exemplo, áudio e vídeo com status Uploading, Upload Failed ou Blocked só podem ser excluídos e não suportam outras operações (não é possível iniciar transcodificação, capturar snapshots de vídeo ou revisar ativos de mídia). Áudio e vídeo com status Normal suportam todas as operações, incluindo transcodificação, snapshots de vídeo, revisão de ativos de mídia e reprodução. Para detalhes sobre os status de mídia, consulte status: video status e status: image status.
Os services do ApsaraVideo VOD disponíveis após o upload e as observações para entrega e reprodução subsequentes são os seguintes:
| service do ApsaraVideo VOD | Descrição | Referências |
| Gerenciamento de ativos de mídia (após o upload) | Após a conclusão do upload, use o ApsaraVideo VOD para gerencie arquivos de mídia, como arquivos source de vídeo, arquivos de stream transcodificados e arquivos de imagem. | Media asset management |
| Processamento de mídia | O ApsaraVideo VOD suporta operações pós-upload, como transcodificação de áudio e vídeo, revisão automatizada, edição online (edição de vídeo na cloud) e processamento de IA. Nota Os metadados dos arquivos de áudio e vídeo enviados para o armazenamento do ApsaraVideo VOD (como resolução, duração e bitrate) são extraídos por padrão, e miniaturas e sprites são capturados para vídeos por padrão. Esse pré-processamento é totalmente gratuito. | Media processing |
| Reprodução de áudio e vídeo | Após concluir o upload de áudio ou vídeo, o arquivo não está necessariamente pronto. O servidor do ApsaraVideo VOD precisa confirme que terminou de receber o arquivo. Use notificações de eventos para determinar quando o áudio ou vídeo enviado estará pronto para reprodução.
|
|
Segurança do upload
Em cenários de upload programático, tanto as credenciais de upload quanto o STS resolvem questões de autorização e segurança durante o envio, impedindo que arquivos de mídia sejam enviados e reproduzidos maliciosamente.
Para os cenários de cada método, consulte Credential method vs. STS method.
Para uso específico, consulte a documentação da operação de cada método de upload para desenvolvedores.
-
Upload from servers -Upload media files using oss SDKs Upload from clients
-
-
Restringir uploads de arquivos com leitura pública
Desde 31 de janeiro de 2024, o ApsaraVideo VOD não suporta mais a modificação de permissões de arquivo por meio do cabeçalho x-oss-object-acl do oss. Isso evita efetivamente problemas como vazamentos de recursos de mídia ou picos de custos devido a acessos maliciosos causados pelo upload direto de arquivos com leitura pública. Para restringir o upload de arquivos com leitura pública em seus próprios buckets do oss no ApsaraVideo VOD, utilize os seguintes métodos de gerenciamento de permissões:
Para autorizar o ApsaraVideo VOD a acessar seu oss e outros recursos, clique em cloud Resource Access Authorization para conceder a autorização.
Crie uma política personalizada que proíba o upload de arquivos com ACL de objeto de leitura pública para seus próprios buckets do oss. Para o procedimento e o conteúdo da política, consulte The policy that prohibits the upload of objects whose ACL is public read to oss buckets.
Conceda à função AliyunVODDefaultRole a permissão de proibir o upload de arquivos com ACL de objeto de leitura pública para seus próprios buckets do oss criada na etapa anterior.
Para conceder a permissão à função AliyunVODDefaultRole
Faça login no Resource Access Management (RAM) console. Para o procedimento, consulte Manage RAM user permissions.
No painel de navegação à esquerda, clique em Roles e localize e clique em AliyunVODDefaultRole.
Na aba Permissions, clique em Grant Permission.
No painel exibido, selecione a aba Custom Policy, escolha a política desejada e conclua a autorização.
Aceleração de upload
O ApsaraVideo VOD oferece aceleração de upload para melhorar a transferência de arquivos de longa distância e arquivos grandes no nível de GB ou TB. A aceleração aplica-se a uploads entre regiões (como transferências transoceânicas), por exemplo, ao enviar vídeos da China continental para um endereço de armazenamento na região de Singapore.
Como ative
Para ative a aceleração de upload, envie a ticket. Forneça seu UID da conta Alibaba Cloud e o endereço de armazenamento que deseja acelerar.
Faturamento
A aceleração de upload é um recurso de valor agregado do ApsaraVideo VOD e é cobrada por uso. Para detalhes de faturamento, consulte Billing for transfer acceleration.
Nenhuma cobrança é feita se você ative o recurso mas não utilizá-lo.
Limitações
Apenas Upload files to the ApsaraVideo VOD console não suporta aceleração. Todos os outros métodos de upload a suportam.
Faturamento
O upload de ativos de mídia para o ApsaraVideo VOD não gera taxas adicionais. As cobranças relacionadas provêm dos recursos do service ApsaraVideo VOD da Alibaba Cloud que você utiliza.
|
Item de faturamento |
Descrição |
|
Taxas de armazenamento |
Custos de armazenamento para arquivos de mídia após o upload, cobrados por volume de armazenamento e duração. |
|
Taxas de tráfego |
O tráfego de upload é gratuito (tráfego de entrada do cliente para o ApsaraVideo VOD não é cobrado). O tráfego de reprodução downstream é cobrado separadamente. |
|
Taxas de transcodificação |
Se a transcodificação for acionada após o upload, a cobrança é feita pela duração do arquivo de saída e especificação de transcodificação. Não há cobrança se nenhuma transcodificação for realizada. |
|
Taxas de aceleração de upload |
Ao ative e usar a aceleração de upload, cobra-se adicionalmente pelo tráfego acelerado. |
Para detalhes de faturamento, consulte Basic service billing e Resource plans.