Todos os produtos
Search

Este produto

    ApsaraVideo VOD:Configurações comuns de reprodução

    Central de documentação

    ApsaraVideo VOD:Configurações comuns de reprodução

    Última atualização: Jul 10, 2026

    O ApsaraVideo VOD fornece URLs de reprodução para diferentes cenários. Controle o tipo de URL de reprodução ajustando a configuração do nome de domínio, as definições de transcodificação e as opções de reprodução.

    Configuração de nome de domínio

    • Adicionar um nome de domínio

    • Configuração de autenticação de URL

      • Tempo de expiração: use o parâmetro AuthTimeout para definir o tempo de expiração de uma URL acelerada por CDN. Para detalhes sobre o cálculo da expiração da URL, consulte a seção "Tempo de expiração da URL" em Autenticação de URL.

      • Autenticação secundária:

    • Seleção de múltiplos nomes de domínio

      Se o servidor de origem estiver configurado com vários nomes de domínio, defina o campo PlayDomain do parâmetro PlayConfig para retornar uma URL de reprodução referente a um nome de domínio de CDN específico. Para mais informações, consulte Personalizar a reprodução de mídia usando PlayConfig.

      Para distribuir vídeos diferentes por meio de nomes de domínio acelerados distintos, use um dos seguintes métodos:

      • Método 1: ao chamar a operação GetPlayInfo, especifique um nome de domínio acelerado diferente para cada vídeo usando o campo PlayDomain do parâmetro PlayConfig. Por exemplo, defina PlayConfig={"PlayDomain":"cdn-a.example.com"} para o Vídeo A e PlayConfig={"PlayDomain":"cdn-b.example.com"} para o Vídeo B. A operação retorna URLs de reprodução com os nomes de domínio correspondentes.

      • Método 2: após obter a URL de reprodução, substitua o nome de domínio na URL pelo nome de domínio acelerado desejado no código. Por exemplo, substitua cdn-default.example.com na URL retornada por cdn-b.example.com.

      Antes de usar qualquer um dos métodos, adicione vários nomes de domínio acelerados e conclua a configuração de CNAME em Distribution and Acceleration > Domain Name Management.

    • Aceleração HTTPS

      Por padrão, a API de reprodução retorna URLs de imagem e de reprodução via HTTP. Para obter URLs HTTPS, ative a aceleração HTTPS para os nomes de domínio de CDN. Para mais detalhes, consulte Aceleração HTTPS.

    Configurações de transcodificação

    O ApsaraVideo VOD permite escolher se deseja transcodificar os arquivos de mídia enviados.

    • Ao transcodificar os arquivos, o service de reprodução retorna URLs referentes aos arquivos transcodificados. O formato, a definição, o status de criptografia e o ID da marca d'água dependem das configurações de transcodificação.

    • Caso não transcodifique os arquivos, o service de reprodução retorna uma URL para o arquivo source enviado. Apenas arquivos MP4, FLV, M3U8, MP3 e WEBM podem ser reproduzidos diretamente sem transcodificação.

    Para mais informações, consulte Modelos de transcodificação.

    Configurações de reprodução

    O service de reprodução oferece suporte a três métodos de reprodução:

    • Visualização no console: nenhuma configuração necessária.

    • URL de reprodução: chame a operação GetPlayInfo e use as configurações de reprodução para filtrar as URLs retornadas.

    • Player: configure as opções de reprodução no ApsaraVideo Player SDK. O player filtra e seleciona automaticamente uma URL de reprodução.

    Configurações da API de reprodução

    A operação GetPlayInfo do ApsaraVideo VOD permite filtrar resultados pelos critérios abaixo para diferentes cenários de reprodução.

    • Definição

      O parâmetro Definition possibilita selecionar várias definições para alternância adaptativa conforme as condições da rede. Se este parâmetro não for definido, a API de reprodução retorna URLs para todas as definições disponíveis do vídeo especificado.

    • Formato do arquivo de saída

      O parâmetro Formats especifica o formato de contêiner do arquivo transcodificado. Somente MP4, MP3 e M3U8 são suportados. É possível especificar vários valores.

    • Tipo de stream de saída

      O parâmetro StreamType define se o stream é de vídeo ou áudio.

    • Tipo de arquivo de saída

      O parâmetro OutputType:

      • Sem a configuração de um nome de domínio acelerado por CDN, a API de reprodução retorna uma URL de origem OSS por padrão.

      • Após configurar um nome de domínio acelerado por CDN, a API retorna uma URL acelerada por CDN como padrão.

      • Também é possível definir o parâmetro OutputType para obter uma URL de origem OSS ou uma URL acelerada por CDN.

    • Tipo de resultado de saída

      O parâmetro ResultType: por padrão, o ApsaraVideo VOD fornece apenas uma URL de reprodução para cada combinação de definição e formato. Se você enviar um novo trabalho de transcodificação para um vídeo já transcodificado, serão criadas várias URLs para cada combinação. A API de reprodução retorna apenas a URL de stream mais recente por padrão. Para recuperar todas as URLs de todos os streams transcodificados, defina ResultType como Multiple.

      Importante

      Se um vídeo possuir mais de 100 URLs de stream de saída, definir ResultType como Multiple retornará no máximo 100 URLs.

    Configurações do player

    O ApsaraVideo Player SDK usa uma credencial de reprodução para obter automaticamente uma URL de reprodução. O SDK está disponível para Web (H5 e Flash), iOS e Android.

    • ApsaraVideo Player SDK para Web

      • O player H5 suporta a definição do tipo de stream de saída (mediaType), formato do arquivo de saída (format) e definição (definition). Para mais informações, consulte Recursos.

      • O player Flash suporta apenas a reprodução de arquivos de vídeo. É possível definir o tipo de stream de saída (mediaType) e o formato do arquivo de saída (format).

    • ApsaraVideo Player SDK para iOS

      É possível definir o formato do arquivo de saída (format) e a definição preferida (quality).

    • ApsaraVideo Player SDK para Android

      É possível definir o formato do arquivo de saída (format) e a definição preferida (quality).