当使用阿里云播放器SDK播放视频发生异常时,可借助单点追查功能针对具体某个用户或某次播放会话的异常播放行为进行全链路追踪,以便您能快速诊断问题原因,可有效改善播放体验治理效率。
前提条件
使用单点追查功能之前,您需要作如下准备:
仅支持下述版本的阿里云播放器SDK使用单点追查功能:5.4.9.2及以上版本的Android播放器SDK或iOS播放器SDK、2.16.0及以上版本的Web播放器SDK。最新版播放器SDK下载请参见播放器SDK。
Android播放器SDK或iOS播放器SDK需要获取有效License,详情请参见获取License;Web播放器SDK需要申请开通播放质量监控增值服务后,再接入License,申请和接入License的方法请参见接口说明中的
license
属性。请确保阿里云播放器SDK的埋点日志上报功能已开启,正常情况下,阿里云播放器SDK的埋点日志上报功能为默认开启的。
务必要在创建播放器时就透传traceId,用于识别用户身份,否则将无法使用单点追查功能。透传方式请参见Android播放器基础功能、iOS播放器基础功能、Web播放器接口说明。
系统播放器、第三方(非阿里云)播放器、阿里云播放器非Android或iOS端或Web端均不支持单点追查功能。
使用限制
当前仅支持查询最新10000条会话,超出部分则不会在控制台显示。
仅支持查询最近3日内的播放数据。
操作步骤
登录视频点播控制台。
在点播控制台左侧导航栏的数据中心区域,单击单点追查,进入单点追查页面。
查询播放会话记录。
在请输入客户追踪号的输入框中,输入创建播放器时透传的用于标识用户的traceId,精确查询某个用户或某台设备的播放会话记录。
通过时间(最近3日内)、播放类型(点播和直播)、状态(播放完成、播放中、播放异常)等筛选查询播放会话记录。
单击查看详情,查看播放会话的详细信息。
相关文档
更多关于使用阿里云播放器SDK的常见问题及修复建议,请参见播放器SDK常见问题。