Todos os produtos
Search
Central de documentação

:Perguntas frequentes sobre parâmetros

Última atualização: Jun 27, 2026

Este tópico descreve alguns parâmetros importantes do ApsaraVideo VOD.

O que é um videoID? Por que o videoID é necessário? Como obter um videoID?

Por motivos de segurança, ao enviar um arquivo de mídia para o ApsaraVideo VOD, você recebe um ID de vídeo (videoID) em vez de uma URL. Também é possível obter um videoID pela OpenAPI. Para mais informações, consulte Obter URLs de reprodução de áudio e vídeo.

O sistema retorna um videoID após o envio de um arquivo para o ApsaraVideo VOD.

Também é possível obter um videoID no console do ApsaraVideo VOD seguindo estas etapas:

  1. Faça login no console do ApsaraVideo VOD.

  2. No painel de navegação à esquerda, em Media Files, clique em Audio/Video.

  3. Localize o videoID na lista de vídeos.

Use os videoIDs obtidos no console para testar downloads e reproduções. Para mais detalhes sobre como enviar ativos de mídia, consulte Visão geral do SDK de upload.

O que são AccessKey ID e AccessKey secret? Como obtê-los?

Seu AccessKey ID e seu AccessKey secret da Alibaba Cloud são credenciais exclusivas para acessar as APIs da Alibaba Cloud. O AccessKey ID identifica sua conta, enquanto o AccessKey secret assina seus parâmetros de acesso para evitar modificações não autorizadas. O AccessKey secret funciona como uma senha de login e deve ser mantido em sigilo absoluto.

Procedimento de obtenção:

  1. Faça login no console do ApsaraVideo VOD.

  2. Passe o mouse sobre seu perfil de usuário na barra de menus e clique em AccessKey Management no menu de atalho.

  3. Na página AccessKey Management, crie uma nova AccessKey ou visualize o AccessKey secret de um AccessKey ID existente.

O que é uma playKey? Como obtê-la?

A playKey, também conhecida como chave de API, serve para autenticação durante a reprodução. O kit de desenvolvimento de software (SDK) do player usa essa chave para autenticar solicitações ao recuperar a URL de reprodução do vídeo. Esse mecanismo atua como uma camada adicional de segurança sobre a AccessKey padrão da Alibaba Cloud e ajuda a prevenir hotlinking. O ApsaraVideo VOD fornece playKeys padrão para as plataformas Flash, H5, iOS e Android.

Nota

Por questões de segurança, insira um código de verificação móvel para visualizar sua playKey.

Procedimento de obtenção:

  1. Faça login no console do ApsaraVideo VOD.

  2. No painel de navegação à esquerda, em Configuration Management, escolha CDN Configuration > Download Settings. Ative o modo de download seguro.

  3. Na seção Get Key, insira o Unique App Identifier e a Private Key.

  4. Clique em Generate and Download Key.

O que é um playauth? Como obtê-lo?

O player oferece três modos de reprodução de vídeo para diferentes cenários. O método playauth é o mais seguro e utiliza o modo de reprodução setAuthInfo.

O playauth é uma credencial de reprodução. O serviço ApsaraVideo VOD combina informações como videoID, AccessKey ID e AccessKey secret e criptografa esses dados em uma única string que o player utiliza para executar a reprodução.

Modo de reprodução

Cenário

Vantagens e desvantagens

Uso recomendado

setDataSource

Testes

Risco de vazamento. Exige que o AccessKey ID e o AccessKey secret sejam escritos diretamente no código do cliente. Se o cliente for comprometido, suas credenciais podem ser expostas.

Não recomendado para uso comercial

setAuthInfo

Uso comercial

Seguro. Nenhuma URL ou link de vídeo fica exposto.

Recomendado para uso comercial

Reproduzir URLs locais e de rede

Reproduz vídeos locais e vídeos a partir de uma URL

Simples. Permite reproduzir vídeos de outras plataformas.

Ideal para reproduzir vídeos locais ou provenientes de uma URL de rede

Fluxo: O servidor obtém a credencial de reprodução > O servidor envia a credencial ao cliente > O cliente reproduz o vídeo.

  1. Obtenha a credencial de reprodução: Em seu servidor, chame o SDK de autenticação de reprodução do lado do servidor para solicitar uma credencial ao serviço ApsaraVideo VOD.

  2. Reproduza o vídeo: O SDK do player usa o videoID e a credencial de reprodução para recuperar a URL de reprodução do vídeo no serviço ApsaraVideo VOD. Em seguida, o SDK carrega e decodifica o fluxo de vídeo para execução.

Importante

Uma credencial de reprodução tem validade de 100 segundos. Ela serve exclusivamente para recuperar a URL de reprodução de um vídeo específico e não pode ser reutilizada ou aplicada a outros vídeos. Caso a credencial expire, a recuperação da URL de reprodução falhará e será necessário obter uma nova credencial.

O SDK do player recupera automaticamente a URL de reprodução usando a credencial para decodificar e reproduzir o vídeo. Essa URL permanece válida por 30 minutos. Se a credencial de reprodução expirar, obtenha uma nova e passe-a ao SDK do player para atualizar a URL de reprodução.

Para proteger sua conta Alibaba Cloud, recomendamos o uso da AccessKey de um usuário RAM. Essa prática é especialmente importante em cenários de reprodução via web.