A visualização de vídeo permite que os usuários assistam ou ouçam conteúdos, como vídeos e áudios, por um tempo limitado. Esse recurso é comum em serviços pagos, como cursos e minisséries. Este tópico descreve como ativar a visualização de vídeo no ApsaraVideo VOD e obter uma url de visualização.
Como funciona
O Alibaba Cloud ApsaraVideo VOD (VOD) oferece o recurso de visualização. Você pode obter uma url de visualização definindo uma duração ao chamar a operação da API do lado do servidor GetPlayInfo ou construindo manualmente uma URL assinada com as informações de visualização.
Se a duração de visualização especificada exceder a duração total do vídeo original, os usuários poderão reproduzir o vídeo inteiro usando a url de visualização retornada pelo ApsaraVideo VOD.
O recurso de visualização de vídeo do ApsaraVideo VOD baseia-se no Alibaba Cloud cdn. O princípio básico é o seguinte: o player envia uma solicitação contendo uma url de visualização (um nome de domínio acelerado por cdn) com a duração especificada. A nuvem autentica a url de visualização. Se a autenticação for bem-sucedida, o sistema retorna o conteúdo do arquivo especificado. Caso contrário, o acesso é negado e um erro 403 é retornado. A figura a seguir mostra o fluxo de trabalho de visualização de vídeo.

-
Configure um nome de domínio acelerado por cdn e ative o recurso de visualização de vídeo.
ImportanteAntes de usar o recurso de visualização, configure um nome de domínio e ative o recurso. Para obter mais informações, consulte Ativar o recurso de visualização.
O player envia uma solicitação de visualização para o ApsaraVideo VOD.
-
O ApsaraVideo VOD gera uma url de visualização com base na configuração do nome de domínio e na duração especificada na solicitação.
NotaChame uma operação de API do lado do servidor para gerar uma url de visualização ou construa-a manualmente. Para obter mais informações, consulte Chamar uma operação de API para obter uma url de visualização ou Construir manualmente uma url de visualização.
O player envia uma solicitação ao cdn para reproduzir o vídeo de visualização.
Limites
O recurso de visualização de vídeo suporta os formatos de arquivo MP4 e HLS. Para vídeos MP4, os metadados devem estar no cabeçalho do arquivo. Vídeos MP4 com metadados no final do arquivo não são suportados. Ao usar o ApsaraVideo VOD para transcodificar um vídeo para o formato de contêiner MP4, os metadados são colocados no cabeçalho do arquivo.
-
A duração da visualização depende dos keyframes. Por padrão, um keyframe é gerado a cada 10 segundos para arquivos de saída transcodificados pelo ApsaraVideo VOD. Portanto, recomenda-se não usar o recurso de visualização para vídeos curtos. Para vídeos longos, defina a duração da visualização como pelo menos 30 segundos.
NotaÉ possível modificar o intervalo de keyframes nos modelos de transcodificação. Para obter mais informações, consulte Modelos de Transcodificação.
Para arquivos HLS, a precisão da visualização baseia-se na duração de um segmento TS. A duração da visualização é arredondada para cima até o múltiplo mais próximo da duração do segmento TS. Por exemplo, se um segmento TS tiver 10 segundos de duração e você definir a duração da visualização como 15 segundos, uma visualização de 20 segundos será retornada.
Ativar o recurso de visualização de vídeo
Antes de chamar uma operação de API ou construir manualmente uma URL para obter uma url de visualização, configure um nome de domínio e ative o recurso de visualização de vídeo. Siga estas etapas:
-
Configure um nome de domínio acelerado por cdn. Para obter mais informações, consulte Adicionar um nome de domínio acelerado.
ImportanteO recurso de visualização de vídeo está disponível apenas para nomes de domínio configurados como nomes de domínio acelerados por cdn.
-
Ative a assinatura de URL para um nome de domínio e também ative o recurso de visualização. Para obter mais informações, consulte Assinatura de URL.
ImportanteSe o recurso de visualização de vídeo estiver desativado para um nome de domínio, não será possível incluir parâmetros de visualização nas solicitações ao ApsaraVideo VOD. A URL retornada ficará inacessível. Portanto, ative a chave Support Previewing ao ativar a assinatura de URL.
A figura a seguir mostra a interface do console para ativar o recurso de visualização de vídeo.
NotaPara construir manualmente uma url de visualização, use o parâmetro privateKey para calcular o valor de autenticação. Defina esse parâmetro com o valor da Primary Key ou Secondary Key obtida no console. Anote o valor da chave para uso futuro.

Ative a busca de origem Range e a busca de vídeo para o nome de domínio. Para obter mais informações, consulte Configurar busca de origem Range e Busca de vídeo.
Chamar uma operação de API para obter uma url de visualização
O ApsaraVideo VOD fornece uma operação de API para obter URLs de reprodução de vídeo. Para obter mais informações sobre a operação de API, consulte Obter URLs de reprodução de áudio e vídeo. Integre um sdk do lado do servidor e use-o para chamar essa operação e obter uma url de visualização. Para obter a url de visualização, siga estas etapas:
Antes de chamar esta operação, certifique-se de que o recurso de visualização esteja ativado. Para obter mais informações, consulte Ativar o recurso de visualização.
Integre o sdk apropriado do lado do servidor. Para obter mais informações, consulte Início Rápido para SDKs do ApsaraVideo VOD.
Chame a operação de API Obter URL de reprodução de áudio e vídeo usando o sdk. Ao chamar a operação de API, defina o parâmetro PreviewTime dentro do parâmetro PlayConfig para especificar a duração da visualização. O servidor retorna uma url de visualização com base na duração especificada. Para obter mais informações sobre o parâmetro PlayConfig, consulte PlayConfig.
Construir manualmente uma url de visualização
Construa manualmente uma URL assinada que contenha informações de visualização. Siga estas etapas:
Antes de construir uma url de visualização, certifique-se de que o recurso de visualização esteja ativado. Para obter mais informações, consulte Ativar o recurso de visualização.
-
Construa uma URL assinada que contenha os parâmetros de visualização. Diferentemente da construção de uma URL assinada para reprodução completa, inclua o parâmetro de duração da visualização
previewTimeno cálculo do hash MD5 para a assinatura da URL.Cálculo de hash MD5 para uma URL de vídeo completo
Cálculo de hash MD5 para uma url de visualização
MD5(uri-timestamp-rand-uid-PrivateKey)MD5(uri-timestamp-rand-uid-PrivateKey-previewTime)NotaPara obter mais informações sobre os parâmetros para o cálculo do hash MD5 e como construir manualmente uma URL assinada, consulte Configurar assinatura de URL. Se quiser permitir a reprodução completa do vídeo, não inclua o parâmetro previewTime.
Anexe
&end=ao final da URL assinada construída. Em seguida, adicione o parâmetro de visualizaçãopreviewTimeapós&end=para gerar a url de visualização completa.