Você pode fazer o upload de arquivos de mídia de servidores de aplicativos para buckets do object storage service (oss) alocados ao ApsaraVideo VOD. O ApsaraVideo VOD fornece SDKs de upload de servidor para linguagens de programação comuns e demonstrações. Os SDKs de upload de servidor encapsulam a lógica usada para obter URLs e credenciais de upload. Basta realizar configure simples antes de usar os SDKs para iniciar os uploads. Este tópico descreve os cenários, o processo de upload e o uso dos SDKs de upload de servidor.
Cenários
Use os SDKs de upload de servidor se quiser realizar uploads automáticos ou fazer o upload de uma grande quantidade de arquivos de vídeo ou arquivos de mídia online. Para enviar arquivos de mídia online, você deve baixe os arquivos para um servidor de aplicativos e, em seguida, fazer o upload desses arquivos para o ApsaraVideo VOD a partir do servidor de aplicativos.
Recurso | Descrição | Observações |
Linguagens de programação | Há suporte para Java, Python, PHP, C e C++. | Para outras linguagens de programação, use os SDKs do oss. Para mais informações, consulte Upload media files using OSS SDKs. |
Arquivos de mídia suportados | Para informações sobre os formatos de arquivo de mídia suportados, consulte Media upload. Você pode fazer o upload de arquivos locais e arquivos online. O upload dos arquivos online ocorre por meio das URLs. |
Nota Para fazer o upload de arquivos de mídia usando URLs, você deve codificar as URLs. Isso evita falhas de upload causadas por caracteres especiais nas URLs. |
Endereços de armazenamento | É possível usar o endereço de armazenamento padrão ou especifique um endereço de armazenamento. | Você pode alterar o endereço de armazenamento padrão. Para mais informações, consulte Manage storage buckets. O upload baseado em URL é compatível apenas na região China (Shanghai). Você pode especifique o endereço de armazenamento ao definir o parâmetro StorageLocation quando chamar uma operação de api para obter uma URL e credencial de upload. |
Upload por uma rede interna | Se quiser implantar o script de upload em uma instância do Elastic Compute Service (ECS), você pode especifique a região onde a instância do ECS reside na lógica de upload. Se a região da instância do ECS for a mesma região de armazenamento do ApsaraVideo VOD, os arquivos serão enviados automaticamente por uma rede interna. Isso acelera os uploads e reduz o tráfego de Internet. | A api do ApsaraVideo VOD só pode ser chamada usando nomes de domínio públicos. Você deve usar uma instância do ECS com acesso à Internet para implantar o script de upload. |
Gerenciamento de ativos de mídia | configure os metadados de mídia, como títulos, tags, categorias e miniaturas da mídia. | É possível configure os metadados ao definir parâmetros como Title, Tags, CateId e CoverURL ao chamar uma operação para obter uma URL e credencial de upload. |
Transcodificação de áudio e vídeo | especifique um modelo de transcodificação ou fluxo de trabalho para transcodificar os arquivos de áudio e vídeo enviados. Você também pode fazer o upload de arquivos de áudio e vídeo sem transcodificação. | configure a transcodificação ao definir parâmetros como TemplateGroupId e WorkflowId quando chamar uma operação para obter uma URL e credencial de upload. |
Controle de upload | Você pode configure a barra de progresso de upload e usar os callbacks de progresso padrão ou personalizados. O recurso de upload retomável é compatível apenas com o SDK de upload de servidor para Java. Os SDKs de upload de servidor para outras linguagens de programação não suportam esse recurso. | Não é possível configure 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 informações sobre as notificações de eventos suportadas, consulte Media upload. | Para mais informações sobre como configure os callbacks, consulte Configure callbacks. |
Autorização de upload | Conceda a permissão de upload usando uma credencial de upload. Nesse caso, você precisa usar um par AccessKey de uma conta da Alibaba Cloud ou de um usuário do ram autorizado para inicializar uma instância de upload. Você também pode conceder a permissão de upload por meio de um token do Security Token Service (STS). Nesse caso, é necessário usar um token STS para inicializar uma instância de upload. | Se conceder a permissão de upload por meio de um token STS, você deve implantar um service para obter tokens STS. |
Aceleração de upload | ative o recurso de aceleração de upload para utilizá-lo. Você deve submit a ticket para ative o recurso de aceleração de upload. | Após ative este recurso, você poderá configure-lo ao definir o |
O ApsaraVideo VOD fornece as seguintes operações de api usadas para obter URLs e credenciais de upload:
Processo de upload
Os SDKs de upload de servidor encapsulam a lógica que pode ser usada para obter URLs e credenciais de upload, bem como a lógica de upload do oss. Basta realizar configure simples antes de usar os SDKs para iniciar os uploads. A figura a seguir mostra um processo completo de upload.
Processo de upload
Integre o SDK de upload de servidor ao seu servidor de aplicativos e conclua as configure de upload. Por exemplo, configure o par AccessKey, o caminho do arquivo, o endereço de armazenamento, as informações do ativo de mídia, as configure de transcodificação e as configure de controle de upload.
-
O servidor de aplicativos usa o SDK de upload de servidor para chamar uma operação de api para obter uma URL de upload, uma credencial de upload e informações do ativo de mídia.
NotaComo alternativa, construa uma solicitação HTTP ou HTTPS para obter uma URL e credencial de upload. No entanto, esse método exige que você construa uma assinatura e pode causar erros. O ApsaraVideo VOD fornece 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 da mídia para o servidor de aplicativos.
NotaO ApsaraVideo VOD gera ids de mídia ao retornar as URLs e credenciais de upload. Os ids de mídia são usados para gerenciamento de ciclo de vida e processamento de mídia.
Para um vídeo, o sistema retorna o id da mídia no parâmetro
VideoId.Para uma imagem, o sistema retorna o id da mídia no parâmetro
ImageId.Para um ativo de mídia auxiliar, o sistema retorna o id da mídia no parâmetro
MediaId.Registre os ids de mídia retornados que 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 aplicativos inicia o upload com base na lógica de upload do oss encapsulada pelo SDK de upload de servidor.
-
O cliente do oss retorna o resultado do upload.
NotaVocê também pode configure um callback com antecedência para ouvir o resultado do upload.
Referências
O procedimento para integrar e usar os SDKs de upload de servidor varia de acordo com a linguagem de programação. Para mais informações sobre como integrar e usar os SDKs de upload de servidor, consulte os seguintes tópicos:
Diferenças entre SDKs de upload de servidor e SDKs de operação de servidor
Os SDKs de upload de servidor e os SDKs de operação de servidor fornecidos pelo ApsaraVideo VOD são diferentes. Os SDKs de upload de servidor encapsulam a lógica de upload completa. Integre os SDKs de upload e inicie os uploads. Os SDKs de operação de servidor integram todos os recursos do ApsaraVideo VOD. Para o recurso de upload, os SDKs de operação de servidor encapsulam apenas a lógica de obtenção de uma URL e credencial de upload. Se você usar os SDKs de operação de servidor para fazer o upload de arquivos de mídia, deverá desenvolver a lógica de upload. Por exemplo, você deve obter uma URL e credencial de upload do ApsaraVideo VOD, decodificar a URL e a credencial de upload codificadas em Base64 e usar o oss para fazer o upload dos arquivos. Para mais informações sobre os SDKs de operação de servidor do ApsaraVideo VOD, consulte Referência do SDK de Servidor.