Após o upload ou processamento de um arquivo de mídia, é possível recuperar e atualizar as informações do ativo correspondente. Este tópico descreve como executar essas operações por meio do console do ApsaraVideo VOD, de uma API ou de um SDK.
Caso de uso 1: Recuperação e atualização via APIs
Para atender a diferentes cenários de negócios, o ApsaraVideo VOD classifica as informações dos ativos de mídia nos tipos a seguir. Utilize APIs específicas para recuperar e atualizar cada tipo de forma independente:
Tipo de informação | APIs para recuperação | APIs para atualização | Casos de uso |
Informações básicas | Recupere dados básicos, como título, duração e status, para exibição em sua aplicação. Também é possível atualizar atributos como título, descrição, miniatura, ID da categoria e tags para gerenciamento de conteúdo. | ||
Informações do arquivo source | As informações do arquivo source são metadados extraídos do próprio arquivo e não podem ser atualizadas. | Obtenha a URL e os parâmetros do arquivo original. Esse recurso é frequentemente utilizado para arquivamento, processamento secundário ou solução de problemas. | |
Informações de reprodução | Não é possível atualizar as informações de reprodução diretamente. No entanto, você pode gerar novos fluxos de áudio e vídeo transcodificando a mídia. SubmitTranscodeJobs | Recupere URLs de reprodução, incluindo credenciais de autenticação. Isso é essencial para a funcionalidade de reprodução de vídeo. |
Recomendamos o uso de um SDK do lado do servidor para chamar as APIs de recuperação e atualização de informações de ativos de mídia. Para mais detalhes, consulte VOD SDK usage guide.
Caso de uso 2: Uso do console
O console oferece uma interface intuitiva para visualizar e gerenciar detalhes individuais de ativos de mídia. Essa abordagem é ideal para a gestão diária pela equipe de operações ou para verificações rápidas durante o desenvolvimento.
Acesse o console do ApsaraVideo VOD.
No painel de navegação à esquerda, escolha Media Files e clique em Audio/Video, Image ou Short Video Material para acessar a página correspondente.
Clique em Manage para visualizar os detalhes de um ativo de mídia.
O exemplo a seguir demonstra como gerenciar um ativo de Audio/Video:
Informações básicas
Na aba Basic information, visualize ou modifique o título, a descrição, a categoria, as tags e a miniatura do áudio ou vídeo. Após editar, clique em Save.
A tabela a seguir descreve os parâmetros.
Parâmetro | Descrição |
Cover | Defina uma miniatura padrão para o vídeo fazendo upload de uma imagem ou selecionando um snapshot do vídeo. Nota É possível fazer upload de uma miniatura personalizada nos formatos JPG ou PNG. A imagem deve ter no máximo 1 MB e resolução de até 1920x1080. |
Name | Nome do arquivo de áudio ou vídeo. Esse nome aparece no player durante a reprodução e pode ter de 1 a 128 bytes. |
Description | Descrição detalhada do arquivo de áudio ou vídeo, com limite de 1.024 bytes. |
Categories | Atribua uma categoria ao vídeo. Para mais informações, consulte Manage media asset categories. |
Tag | Adicione várias tags a cada arquivo de áudio ou vídeo. As tags podem conter caracteres chineses, letras do alfabeto inglês, dígitos e sublinhados (_). Separe múltiplas tags com vírgula (,), ponto e vírgula (;) ou pressionando Enter. |
URLs de vídeo
Visualize as URLs do arquivo source e de todos os fluxos transcodificados em diferentes formatos e qualidades, juntamente com suas resoluções e bitrates correspondentes.
A tabela abaixo descreve as ações disponíveis.
|
Ações |
Descrição |
|
Copy |
Copia a URL de reprodução da qualidade selecionada. Cole a URL em um navegador ou player para pré-visualizar o vídeo. |
|
Preview |
Pré-visualiza o vídeo na qualidade escolhida diretamente no console. |
|
Delete |
Exclui o fluxo de vídeo da qualidade selecionada. |
|
Delete All |
Remove todos os arquivos transcodificados, mantendo apenas o arquivo source. Esta ação é irreversível. Proceda com cautela. |
Código do player Web
Para cada vídeo, utilize os trechos de código HTML ou JavaScript fornecidos. A ferramenta de configuração permite modificar rapidamente parâmetros como tamanho do player e reprodução automática, acelerando a integração.
A aba Web Player Code está disponível apenas para ativos de vídeo.
Para integração, utilize a versão mais recente do ApsaraVideo Player for Web. Para mais informações, consulte ApsaraVideo Player for Web.