Todos os produtos
Search
Central de documentação

ApsaraVideo VOD:Use a ferramenta de diagnóstico do Web Player SDK

Última atualização: Jun 27, 2026

O Web Player SDK inclui uma ferramenta de diagnóstico integrada para solucionar falhas e travamentos na reprodução de vídeo. Essa ferramenta coleta dados básicos do ambiente, status da rede e um log de eventos de reprodução em tempo real para identificar a causa raiz sem ferramentas externas.

Pré-requisitos

Antes de começar, configure os seguintes ajustes no domínio de reprodução de vídeo:

  • Ative a proteção contra hotlinking de Referer e adicione player.alicdn.com à lista de permissões. Para mais informações, consulte Configurar uma lista de bloqueios/permissões de endereços IP.

    Nota

    player.alicdn.com é o endereço estático do Aliplayer e deve constar na lista de permissões.

    Nas configurações de Hotlink protection for Referer, desmarque a caixa de seleção Allow Direct Access from Browser Address Bar para bloquear solicitações CDN com Referer vazio.

  • Adicione o cabeçalho Access-Control-Allow-Origin ao domínio de reprodução de vídeo para habilitar o compartilhamento de recursos de origem cruzada (CORS). Para mais informações, consulte Configurar compartilhamento de recursos de origem cruzada.

Diagnosticar problemas de reprodução

  1. Abra a ferramenta de diagnóstico.

    Use um dos métodos abaixo:

    • Pela tela de erro de reprodução: Se ocorrer um erro (por exemplo, a mensagem "Failed to get the URL"), clique em Diagnose na tela de erro. A ferramenta abre já preenchida com o código de erro (code), ID do vídeo (vid), uuid, requestId e timestamp de reprodução.

    • Diretamente: Acesse a ferramenta de diagnóstico.

  2. Verifique as informações básicas.

    A aba Diagnostic Information exibe dados de ambiente e rede coletados da sessão do usuário: - Basic information: sistema operacional (por exemplo, Windows NT 10.0) e navegador (por exemplo, Chrome 90.0.4430.93) - Network information: status do Image CDN, status do Script CDN, DNS local, ISP e endereço IP local

  3. Execute um teste de reprodução.

    1. Na aba Video Playback, selecione um modo de reprodução no menu Type: HTML5, Alibaba Cloud HTML5 ou Alibaba Cloud Flash.

    2. Insira o parâmetro Source (URL direta de reprodução) ou os parâmetros Vid e playAuth e clique em Play.

      Nota

      Se Source e Vid/playAuth forem fornecidos simultaneamente, Source terá prioridade.

    3. Analise o log de eventos de reprodução. Durante a execução, a ferramenta sobrepõe um log de eventos em tempo real no lado esquerdo do vídeo. Cada entrada mostra o nome do evento e seu timestamp. Os eventos registrados são:

      Evento

      Significado

      play

      Reprodução iniciada

      waiting

      Aguardando dados

      loadstart

      Início da solicitação de dados

      progress

      Solicitando dados

      loadedmetadata

      Metadados da source carregados

      loadeddata

      Dados do quadro atual carregados

      canplay

      Dados suficientes para iniciar a reprodução

      canplaythrough

      Dados suficientes para reproduzir até o fim sem buffering

      pause

      Reprodução pausada

      ended

      Reprodução finalizada

Consulte também

Códigos de erro