Client upload SDKs - ApsaraVideo VOD: Central de Documentação do Alibaba Cloud

O upload via cliente permite que aplicativos móveis enviem arquivos de mídia diretamente para o armazenamento do ApsaraVideo VOD. Essa abordagem elimina a passagem pelo servidor de aplicação e economiza recursos do servidor.

Visão geral dos recursos

Os SDKs de upload via cliente aceitam envio de arquivos locais e online.

Recurso	Descrição	Observação
Plataformas compatíveis	Web, iOS, Android e mini programa WeChat	N/A
Arquivos de mídia	Os formatos compatíveis estão listados em Formatos de mídia. Aceita uploads de arquivos locais e online (baseados em URL). Nota O upload baseado em URL é compatível apenas com a região China (Shanghai). Permite gravação e upload de vídeos curtos. Oferece upload em lote com operações de adição, exclusão, cancelamento, retomada, travessia e limpeza.	Arquivo local: tamanho máximo de 48,8 TB. Arquivo online: até 5 GB. Nota Codifique as URLs de arquivos online para evitar falhas causadas por caracteres especiais.
Locais de armazenamento	Aceita endereços de armazenamento padrão ou personalizados.	Altere o endereço de armazenamento padrão. Para especificar um endereço de armazenamento, defina o parâmetro StorageLocation ao obter uma URL e credencial de upload.
Gerenciamento de ativos de mídia	Compatível com metadados como títulos, tags, categorias e miniaturas.	Para configurar metadados, defina Title, Tags, CateId e CoverURL ao obter uma URL e credencial de upload.
Transcodificação de áudio e vídeo	Transcodifica arquivos de áudio e vídeo enviados usando um modelo ou fluxo de trabalho especificado.	Para transcodificar arquivos, defina TemplateGroupId e WorkflowId ao obter uma URL e credencial de upload.
Autorização de upload	Compatível com o método de URL e credencial de upload. Compatível com o método de Token STS.	Recomendamos o método de URL e credencial de upload. A seção Processos de upload compara os dois métodos.
Controle de upload	Inclui funcionalidades de iniciar, parar, pausar e retomar.	O SDK gerencia automaticamente o upload retomável. Em caso de falha, o processo continua do ponto em que parou.
Aceleração de upload	Para ativar a aceleração de upload, envie uma solicitação no Yida.	Após a ativação, configure a aceleração definindo o campo `AccelerateConfig` no parâmetro `UserData`.
Alternância de tipo de rede	Permite alternar entre redes móveis (3G/4G) e Wi-Fi.	Para reduzir o consumo de dados móveis, pause os uploads em 3G/4G e retome-os em Wi-Fi.
Notificações de eventos	Configure callbacks para receber notificações sobre eventos de upload. Os eventos compatíveis estão listados em Upload de mídia.	Para definir callbacks, consulte Configuração de callback.

Processos de upload

Os SDKs de upload via cliente encapsulam o OSS SDK para envio de objetos. Os arquivos são transferidos diretamente para o bucket OSS do ApsaraVideo VOD, sem passagem pelo servidor.

Implante um serviço de autorização no servidor de aplicação. Dois métodos são compatíveis: autorização baseada em token STS e autorização baseada em credencial.

Recomendamos a autorização baseada em credencial. Ela oferece configuração mais simples e flexível, segurança aprimorada, maior redundância e controle granular de permissões por vídeo, com múltiplos parâmetros de resposta.

Autorização baseada em credencial

A figura a seguir ilustra o processo de upload baseado em credencial.

Implante um serviço de autorização (SDK do ApsaraVideo VOD) no servidor de aplicação para obter URLs e credenciais de upload.
Nota
Referência da API
- CreateUploadVideo: Obtém uma URL e credencial de upload para arquivos de áudio e vídeo.
- RefreshUploadVideo: Atualiza uma URL e credencial de upload para arquivos de áudio e vídeo.
- CreateUploadImage: Obtém uma URL e credencial de upload para arquivos de imagem.
- CreateUploadAttachedMedia: Obtém uma URL e credencial de upload para ativos de mídia auxiliares.
O cliente solicita uma URL e credencial de upload ao servidor de aplicação.
O servidor de aplicação solicita a URL e a credencial de upload ao ApsaraVideo VOD.
O ApsaraVideo VOD retorna a URL e a credencial de upload.
Nota
- O ApsaraVideo VOD também gera IDs de mídia para uso no gerenciamento de ciclo de vida e 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.
- Também é possível configurar um callback para os resultados do upload.
O servidor de aplicação devolve a URL e a credencial de upload ao cliente.
O cliente inicializa uma instância de upload utilizando a URL e a credencial obtidas.
O cliente constrói os parâmetros de upload e envia a solicitação.
O OSS retorna o resultado do upload.

Autorização baseada em token STS

A figura a seguir ilustra o processo de upload baseado em token STS.

Implante um serviço de autorização (STS SDK) no servidor de aplicação para obter tokens STS temporários.

Nota
Referência da API

AssumeRole: Obtém um token STS para assumir uma função do Resource Access Management (RAM). Obter um token STS.
O cliente solicita um token STS ao servidor de aplicação.
O servidor de aplicação solicita o token ao STS.
O STS retorna o token.
O servidor de aplicação devolve o token STS ao cliente.
O cliente usa o token STS para solicitar uma URL e credencial de upload ao ApsaraVideo VOD.
O ApsaraVideo VOD retorna a URL e a credencial de upload ao cliente.
O cliente constrói os parâmetros de upload e envia a solicitação.
O OSS retorna o resultado do upload.

Integração no lado do cliente

A integração varia conforme a plataforma: