Media upload overview - ApsaraVideo VOD - ApsaraVideo VOD: Central de Documentação do Alibaba Cloud

O upload de mídia registra recursos de mídia no ApsaraVideo VOD e habilita serviços subsequentes, como gerenciamento de ativos de mídia, processamento de mídia e entrega de conteúdo. Este tópico aborda formatos compatíveis, métodos de upload, configurações de armazenamento e fluxos de trabalho pós-upload.

Formatos de mídia compatíveis

O ApsaraVideo VOD permite o upload de vídeos, áudios, imagens e ativos de mídia auxiliares (marcas d'água, legendas e arquivos de material). Os arquivos podem ser locais ou online (enviados por URL).

Nota

As extensões de arquivo são obrigatórias e não diferenciam maiúsculas de minúsculas. MP4 e mp4 são equivalentes.

Tipo de mídia	Formatos de arquivo
Vídeo	MPEG: MP4, TS, 3GP, MPG, MPEG, MPE, DAT, VOB, ASF, entre outros. AVI: AVI. Windows Media Video: WMV e ASF. Flash Video: FLV e F4V. Real Video: RM e RMVB. QuickTime: MOV. Matroska: MKV. HLS: M3U8. Nota O console aceita uploads de M3U8 apenas por URL. Para enviar arquivos M3U8 locais, use a API ou o SDK. Enviar arquivos de mídia com a API do ApsaraVideo VOD. Outros: DV, GIF, M2T, M4V, MJ2, MJPEG, MTS, OGG, QT, SWF e WEBM.
Áudio	MP3, WMA, WAV, AAC, RA, M4A, FLAC, APE, AC3, AMR, CAF e ACM.
Imagem	PNG, JPG, JPEG, GIF e HEIC.
Ativo de mídia auxiliar	Marca d'água: PNG, GIF, APNG e MOV. Legenda: SRT, ASS, STL, TTML e VTT. Material: JPG, GIF, PNG, MP4, MAT e ZIP.

Nota

O ApsaraVideo VOD aceita apenas os tipos de arquivo listados. Para outros tipos, Envie arquivos para o OSS.

Métodos de upload

O ApsaraVideo VOD oferece métodos de upload manuais e programáticos.

	Método de upload	Casos de uso	Descrição
Upload manual	Enviar arquivos pelo console do ApsaraVideo VOD	Envio rápido e simples de ativos de mídia. Nota Uploads de arquivos grandes pelo console podem falhar se a sessão expirar. Use o cliente para PC nesses casos.	Faça login no console do ApsaraVideo VOD para enviar arquivos de mídia após ativar o serviço. Permite enviar áudio e vídeo de arquivos locais ou URLs.
Upload manual	Enviar arquivos pelo cliente Windows	Envio de arquivos grandes e tarefas de upload de longa duração.	Requer download e instalação. Disponível apenas para Windows. Aceita apenas uploads de arquivos locais.
Integração programática	Enviar arquivos com um SDK de upload	Ideal para uploads automatizados e migrações de vídeo em grande escala. Indicado para envio de arquivos de mídia online. Nota Sempre que possível, use um SDK de upload. Se os SDKs fornecidos não forem compatíveis com sua linguagem, utilize um SDK nativo do OSS.	O SDK de upload server-side encapsula a obtenção de credenciais e URL de upload e integra as funcionalidades de upload do OSS. Exige configuração mínima. Linguagens compatíveis: Java, Python, PHP e C/C++.
	Enviar arquivos com um SDK do OSS	Ideal para uploads automatizados e migrações massivas de vídeo. Utilizado para envio de arquivos de mídia online.	Com um SDK nativo do OSS, implemente toda a lógica de upload: obtenha a URL e as credenciais de upload no ApsaraVideo VOD, decodifique-as em Base64 e chame as operações do OSS para concluir o envio. Linguagens compatíveis: Java, Python, PHP, .NET, Go, Node.js e C/C++. Nota Para Java, Python, PHP e C/C++, prefira o SDK de upload do ApsaraVideo VOD.
	Enviar arquivos por URL	Recomendado para arquivos acessíveis por URLs públicas.	Os arquivos só podem ser enviados para as regiões China (Shanghai) e Singapore. Este método não aceita uploads de arquivos locais.

Comparação de recursos por método de upload

A tabela a seguir compara os recursos de upload disponíveis em cada método:

Grupo	Recurso	Console	Cliente para PC	Upload from servers	Upload from clients	UploadMediaByURL	Upload media files using OSS SDKs	Upload OSS objects
Gerenciamento de ativos de mídia	Título da mídia	Compatível	Compatível	Compatível	Compatível	Compatível	Compatível	Compatível
	Categoria da mídia	Compatível	Compatível	Compatível	Compatível	Compatível	Compatível	Compatível
	Tags de mídia	Não compatível	Compatível	Compatível	Compatível	Compatível	Compatível	Compatível
	Miniatura do vídeo	Não compatível	Não compatível	Compatível	Compatível	Compatível	Compatível	Compatível
Transcodificação de áudio e vídeo^①	Grupo de modelos de transcodificação	Compatível	Compatível	Compatível	Compatível	Compatível	Compatível	Compatível
	Fluxo de trabalho	Compatível	Não compatível	Compatível	Compatível	Compatível	Compatível	Compatível
	Sem transcodificação	Compatível	Compatível	Compatível	Compatível	Compatível	Compatível	Compatível
Controle de upload^②	Progresso do upload	Compatível	Compatível	Compatível	Compatível	Compatível	Compatível	Compatível
	Upload retomável	Não compatível	Não compatível	Compatível apenas com o SDK de upload server-side para Java	Compatível	Não compatível	Compatível apenas com o SDK do OSS para Java	Não compatível
	Upload multipart	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

Transcodificação de áudio e vídeo^①

Configure a transcodificação durante o upload especificando um grupo de modelos de transcodificação ou um fluxo de trabalho de mídia. A transcodificação inicia automaticamente após o upload. Também é possível desativar a transcodificação. No entanto, apenas arquivos nos seguintes formatos podem ser reproduzidos sem transcodificação: MP4, FLV, M3U8, MP3 e WEBM.

Especificar um grupo de modelos de transcodificação: Selecione Transcoding Template Group durante o upload. A transcodificação começa automaticamente após o envio. Este é o método padrão.
Especificar um fluxo de trabalho de mídia: Crie um fluxo de trabalho com uma tarefa de transcodificação e selecione Media Workflow durante o upload. O fluxo de trabalho executa automaticamente após o upload.
Para desativar a transcodificação durante o upload, selecione o modelo No Transcoding no grupo de modelos de transcodificação.

Controle de upload^②

Upload multipart: Divide um arquivo em partes, envia-as separadamente e as reassembleia. Ativado por padrão.

Nota
Se um upload multipart falhar, as partes restantes serão excluídas automaticamente após sete dias. Para excluí-las imediatamente, chame a operação DeleteMultipartUpload.
Monitore o progresso e o status do upload.
Upload retomável: Retoma uploads interrompidos a partir da última parte enviada com sucesso.

Nota
O SDK de upload client-side inclui funcionalidade nativa de upload retomável e retoma automaticamente a partir do ponto de interrupção.

Armazenamento

Regiões de armazenamento

O ApsaraVideo VOD utiliza o Object Storage Service (OSS) para armazenar ativos de mídia em nós de armazenamento globais. Cada nó corresponde a uma região com um endereço de armazenamento dedicado.

Endereço de armazenamento

Nota

Os dados são isolados por região e não compartilhados entre regiões, mesmo dentro da mesma conta. Certifique-se de que a região de upload corresponda à região de serviço desejada.

Configuração	Descrição
Enable VOD system storage address	Ao ativar o ApsaraVideo VOD, um bucket de armazenamento padrão (bucket do sistema VOD) é criado em cada região, pronto para uso imediato. Gerenciar buckets de armazenamento.
Add a storage address	Adicione seus próprios buckets do OSS ao ApsaraVideo VOD para transcodificação, captura de snapshots e reprodução de arquivos nesses buckets. Gerenciar buckets de armazenamento.
Change the default storage address	Após adicionar vários endereços de armazenamento, você pode alterar o padrão. Os uploads são direcionados ao endereço padrão, a menos que você especifique outro. Gerenciar buckets de armazenamento.

A tabela a seguir lista as regiões compatíveis e seus IDs.

Nota

Uploads via console e cliente para PC utilizam o endereço de armazenamento da região selecionada. Uploads via SDK e API aceitam um parâmetro de endereço de armazenamento, como o parâmetro StorageLocation na operação Upload por pull baseado em URL.

Região	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

Faturamento

O armazenamento do ApsaraVideo VOD é cobrado via pagamento conforme o uso (pós-pago) ou planos de recursos (pré-pago).

Pagamento conforme o uso: Faturamento para armazenamento de ativos de mídia.
Planos de recursos: Plano de armazenamento do ApsaraVideo VOD.

Notificações de eventos de upload

O ApsaraVideo VOD envia notificações de eventos após cada upload via callbacks HTTP(S) ou MNS. Configure callbacks para receber atualizações de status de processamento. A tabela a seguir descreve os eventos de upload.

Nota

Detalhes completos dos eventos: Notificação de eventos.

Nome do evento	Tipo	Descrição
Upload de Vídeo Concluído	FileUploadComplete	Disparado após a conclusão do upload de um arquivo de áudio ou vídeo. Nota Para arquivos de áudio ou vídeo não transcodificados, a URL de reprodução fica disponível somente após o evento FileUploadComplete. Se você desativar a transcodificação durante o upload, ainda poderá chamar a operação Submit media transcoding jobs para transcodificar o arquivo após receber a notificação do evento FileUploadComplete.
Upload de Imagem Concluído	ImageUploadComplete	Disparado após a conclusão do upload de um arquivo de imagem.
Upload de Mídia Auxiliar Concluído	AttachedMediaUploadComplete	Disparado após a conclusão do upload de um ativo de mídia auxiliar.
Upload de Vídeo por URL Concluído	UploadByURLComplete	Disparado quando a operação UploadMediaByURL termina de puxar e enviar um vídeo.
Transcodificação concluída para um único stream	StreamTranscodeComplete	Disparado quando um stream de vídeo é transcodificado para uma definição e formato específicos (por exemplo, SD em MP4). Nota Para arquivos transcodificados, aguarde o evento StreamTranscodeComplete antes de obter a URL de reprodução. A reprodução pode falhar antes do recebimento deste callback.
Transcodificação de Vídeo Concluída	TranscodeComplete	Disparado quando todos os streams de um vídeo terminam a transcodificação. Nota Aguarde o evento TranscodeComplete para garantir que todas as definições estejam disponíveis. A reprodução pode falhar antes deste callback.

Autorização de upload

Para uploads de desenvolvedores, autorize com credenciais de upload ou tokens do Security Token Service (STS) para evitar uploads maliciosos e reprodução não autorizada.

Comparação entre credenciais de upload e tokens STS.
Detalhes de autorização por método de upload:
Desde 31 de janeiro de 2024, o ApsaraVideo VOD não suporta mais o cabeçalho OSS x-oss-object-acl para modificar permissões de arquivo. Para proibir uploads com leitura pública em seus buckets OSS do ApsaraVideo VOD:
1. Autorize o ApsaraVideo VOD a acessar seus recursos do OSS. Clique em Cloud Resource Access Authorization.
2. Crie uma política personalizada para proibir o upload de objetos com ACL de leitura pública em seus buckets OSS. Conteúdo da política e instruções: Proibir upload de objetos com ACL de leitura pública em seus buckets OSS.
3. Conceda a política personalizada criada na etapa anterior à função AliyunVODDefaultRole.
  
  Faça login no console do RAM para conceder permissões (Gerenciar permissões de usuário do RAM).
  
  No painel de navegação à esquerda, clique em Roles. Localize e clique em AliyunVODDefaultRole. Na aba Permissions, clique em Add Permissions. No painel exibido, selecione a aba Custom Policy e escolha a política desejada.

Aceleração de upload

A aceleração de upload melhora transferências de longa distância e de arquivos grandes (GB/TB). É ideal para uploads entre regiões, como transferir vídeos da China continental para um bucket na região de Singapore.

Como ativar

Para ativar a aceleração de upload, envie um ticket. Forneça seu Account ID e o bucket a ser acelerado.

Faturamento

A aceleração de upload é cobrada por uso (faturamento para aceleração de transferência).

Nota

Não há cobrança por este recurso se você não o utilizar.

Limitações

Todos os métodos de upload suportam aceleração, exceto o upload de arquivos pelo console do ApsaraVideo VOD.

Próximos passos

Nota

Os ativos enviados recebem um status baseado no estágio de processamento. Ativos com status Uploading, Upload Failed ou Blocked só podem ser excluídos. Ativos com status Normal permitem todas as operações: transcodificação, captura de snapshot, revisão e reprodução. Status: status do vídeo e Status: status da imagem.

A tabela a seguir descreve os serviços pós-upload e considerações sobre reprodução.

Serviço	Descrição	Referências
Gerenciamento de ativos de mídia (pós-upload)	Gerencie arquivos de mídia enviados, incluindo vídeos originais, streams transcodificados e imagens.	Media asset management
Processamento de mídia	Operações pós-upload incluem transcodificação, revisão automatizada, edição online e processamento com IA. Nota O ApsaraVideo VOD extrai automaticamente metadados (resolução, duração, taxa de bits) e captura miniaturas e sprites para vídeos. Essas operações de pré-processamento são gratuitas.	Media processing
Reprodução de áudio e vídeo	Os arquivos enviados não ficam imediatamente disponíveis para reprodução. Notificações de eventos informam quando um arquivo está pronto. Arquivos não transcodificados: a URL de reprodução fica disponível após o evento FileUploadComplete. Arquivos transcodificados: a URL de reprodução fica disponível após o evento StreamTranscodeComplete. Aguarde o evento TranscodeComplete para garantir que todas as definições estejam prontas.	Receba notificações de eventos como FileUploadComplete. Chame uma API para obter a URL de reprodução de áudio e vídeo.