Se ocorrer um erro durante a reprodução de vídeos com o Alibaba Cloud Player SDK, use o recurso de rastreamento de ponto único para monitorar o comportamento anômalo de um usuário ou sessão de reprodução específica de ponta a ponta. Esse recurso permite diagnosticar rapidamente a causa raiz e gerencie a experiência de reprodução com maior eficiência.
Pré-requisitos
Antes de usar o recurso de rastreamento de ponto único, verifique se as seguintes condições foram atendidas:
O rastreamento de ponto único está disponível apenas nas seguintes versões do Alibaba Cloud Player SDK: 5.4.9.2 ou posterior para Android e iOS, e 2.16.0 ou posterior para Web. Baixe o SDK.
Uma licença válida para o SDK Android, iOS ou Web. Obtenha uma licença.
Verifique se o relatório de logs está ativado no Alibaba Cloud Player SDK. Por padrão, esse recurso vem habilitado.
Passe o parâmetro traceId ao crie o player. Sem esse parâmetro, o rastreamento de ponto único fica indisponível. Para mais informações sobre como passar o parâmetro, consulte Recursos básicos do Alibaba Cloud Player SDK para Android, Recursos básicos do Alibaba Cloud Player SDK para iOS e Referência da API do player Web.
O recurso de rastreamento de ponto único não é compatível com players nativos do sistema, players de terceiros ou o Alibaba Cloud Player SDK em plataformas diferentes de Android, iOS e Web.
Limitações
É possível consultar apenas as 10.000 sessões mais recentes.
Os dados de reprodução estão disponíveis somente para os últimos três dias.
Procedimento
Faça login no console do Alibaba Cloud VOD.
No painel de navegação à esquerda, escolha Data Center > Single-point Tracing.
-
Consulte as sessões de reprodução.
No campo Enter a traceId, insira o traceId fornecido durante a criação do player para consultar sessões de reprodução de um usuário ou dispositivo específico.
Filtre as sessões por período (dentro dos últimos 3 dias), tipo de reprodução (sob demanda ou transmissão ao vivo) e status (Playback Completed, Playing ou Playback Failed).
-
Clique em View Details para visualize as informações detalhadas de uma sessão de reprodução.
A página de detalhes da reprodução contém três seções. A seção Basic information exibe campos como App name, Playback time, client IP, OS, Network type, Device type, SessionId e SDK version. A seção Playback information apresenta métricas como time to first frame, Rebuffering count, Rebuffering duration, status, Codec standard, hardware decoding, Playback progress on exit, resolution, frame rate e video bitrate. A lista de eventos na parte inferior registra os eventos de reprodução em ordem cronológica, com colunas como Topic, Event, Duration (ms), Time e Details.
Documentos relacionados
Para obter informações sobre problemas comuns e soluções ao usar o Alibaba Cloud Player SDK, consulte Perguntas frequentes sobre o Player SDK.