A pré-visualização de áudio e vídeo permite que os nós de borda da CDN retornem apenas um trecho com duração limitada de um arquivo de mídia, em vez do arquivo completo. Esse recurso é comum em serviços de vídeo sob demanda (VOD) para oferecer uma avaliação gratuita a usuários não premium antes da assinatura.
Formatos suportados
|
Formato |
Suporte |
Observações |
|
TS |
Suportado |
Configure por meio deste recurso |
|
MP3 |
Suportado |
Configure por meio deste recurso |
|
FLV |
Não suportado |
Utilize a busca de vídeo com o parâmetro end como alternativa |
|
MP4 |
Não suportado |
Utilize a busca de vídeo com o parâmetro end como alternativa |
|
HLS |
Sem suporte nativo |
Envie um ticket para solicitar a configuração |
Como funciona
Quando um cliente envia uma solicitação com um parâmetro de duração da pré-visualização, o nó de borda da CDN retorna somente a parte especificada do arquivo. Por exemplo:
http://example.com/sample.ts?free_time=15Esse comando retorna os primeiros 15 segundos de sample.ts. O nome e o valor do parâmetro configurados no console devem corresponder exatamente ao que o cliente envia na URL da solicitação.
Comportamento do parâmetro:
|
Cenário |
Comportamento |
|
Nome do parâmetro definido, sem valor padrão configurado |
O nó de borda retorna a duração especificada em cada solicitação recebida |
|
Solicitação do cliente excede a duração total da pré-visualização |
A duração total configurada prevalece. Para evitar cortes prematuros, solicite um tempo ligeiramente superior ao desejado — por exemplo, solicite 15 segundos para pré-visualizar 13 segundos de conteúdo |
Ative a pré-visualização de áudio e vídeo
Procedimento
Faça login no console da CDN.
No painel de navegação à esquerda, clique em Domain Names.
Na página Domain Names, localize o nome de domínio desejado e clique em Gerencie na coluna Actions.
No painel de navegação do domínio, clique em Video.
-
Na seção Audio/video Preview, ative a opção Audio/video Preview e defina o Custom Preview Parameter. No campo Custom Preview Parameter, insira o nome do parâmetro de consulta que seu cliente utiliza nas solicitações. O valor corresponde à duração da pré-visualização em segundos. Por exemplo, se você definir o Custom Preview Parameter como
free_timee o cliente enviarfree_time=15, o nó de borda retornará 15 segundos do arquivo solicitado.
Clique em OK.
Próximos passos
Para configurar a pré-visualização de arquivos FLV ou MP4, consulte Configurar busca de vídeo.