当您使用Web播放器SDK播放视频出现播放失败、播放卡顿等播放异常现象时,您可以使用诊断工具辅助您排查原因,诊断工具诊断项覆盖视频播放的基础信息、网络信息以及播放日志等维度。本文为您介绍如何使用Web播放器SDK提供的诊断工具进行视频诊断。
前提条件
为了视频播放诊断更准确,需要进行以下设置:
-
开启视频播放域名的Refer防盗链,并将
player.alicdn.com域名添加到白名单。详细操作,请参见配置IP黑白名单。说明player.alicdn.com为Aliplayer播放器的固定地址,请务必将此地址加入到白名单。在Refer防盗链设置弹窗中,允许通过浏览器地址栏直接访问资源URL复选框保持未勾选状态,即不允许空 Referer 字段访问 CDN 资源。
-
在视频播放域名的HTTP消息头,添加允许跨域访问的Access-Control-Allow-Origin。详细操作,请参见关于跨域访问配置说明。
操作步骤
-
打开诊断工具。
您可以通过以下两种方式打开Aliplayer播放器的诊断工具:
-
当播放视频出错时,单击诊断,跳转到诊断工具页面。当播放器出现播放错误时(如提示"获取地址出错啦"),错误界面会显示重试和诊断两个按钮,单击诊断按钮即可打开诊断工具。诊断界面会展示错误码(
code)、视频 ID(vid)、uuid、requestId及播放时间等信息,用于排查问题。 -
直接访问诊断工具:诊断工具。
-
-
基础信息诊断。
在诊断信息页,将显示用户环境的操作系统、浏览器、IP地址和运营商等。诊断结果页面包含诊断信息和视频播放两个Tab。基础信息区块展示系统(Windows NT 10.0)、浏览器(Chrome 90.0.4430.93)等字段;网络信息区块展示图片CDN状态(成功)、脚本CDN状态(成功)、Local DNS、运营商、Local IP、IP运营商等字段。
-
视频播放诊断。
-
在视频播放页,选择类型,即视频的播放方式,提供了原生H5、阿里云H5、阿里云Flash这三种播放方式。
-
填写Source参数(视频播放地址),单击播放,即可开始诊断。如果没有Source参数,也可填写Vid和playAuth参数。
说明Source参数的优先级最高。
-
开始诊断时,播放页面会显示播放日志。播放后,视频区域左侧会叠加显示诊断事件日志,包括开始播放(play)、等待数据(waiting)、开始请求数据(loadstart)、正在请求数据(progress)、源数据加载完成(loadedmetadata)、当前帧的数据已加载(loadeddata)、加载部分可以播放(canplay)、全部加载完毕(canplaythrough)、暂停播放(pause)、播放结束(ended)等事件及对应时间戳。
-