如何使用Web播放器SDK诊断工具

更新时间:
复制为 MD 格式

当您使用Web播放器SDK播放视频出现播放失败、播放卡顿等播放异常现象时,您可以使用诊断工具辅助您排查原因,诊断工具诊断项覆盖视频播放的基础信息、网络信息以及播放日志等维度。本文为您介绍如何使用Web播放器SDK提供的诊断工具进行视频诊断。

前提条件

为了视频播放诊断更准确,需要进行以下设置:

  • 开启视频播放域名的Refer防盗链,并将player.alicdn.com域名添加到白名单。详细操作,请参见配置IP黑白名单

    说明

    player.alicdn.comAliplayer播放器的固定地址,请务必将此地址加入到白名单。

    Refer防盗链设置弹窗中,允许通过浏览器地址栏直接访问资源URL复选框保持未勾选状态,即不允许空 Referer 字段访问 CDN 资源。

  • 在视频播放域名的HTTP消息头,添加允许跨域访问的Access-Control-Allow-Origin。详细操作,请参见关于跨域访问配置说明

操作步骤

  1. 打开诊断工具。

    您可以通过以下两种方式打开Aliplayer播放器的诊断工具:

    • 当播放视频出错时,单击诊断,跳转到诊断工具页面当播放器出现播放错误时(如提示"获取地址出错啦"),错误界面会显示重试诊断两个按钮,单击诊断按钮即可打开诊断工具。诊断界面会展示错误码(code)、视频 ID(vid)、uuidrequestId 及播放时间等信息,用于排查问题。

    • 直接访问诊断工具:诊断工具

  2. 基础信息诊断。

    诊断信息页,将显示用户环境的操作系统、浏览器、IP地址和运营商等。诊断结果页面包含诊断信息视频播放两个Tab。基础信息区块展示系统(Windows NT 10.0)、浏览器(Chrome 90.0.4430.93)等字段;网络信息区块展示图片CDN状态(成功)、脚本CDN状态(成功)、Local DNS、运营商、Local IP、IP运营商等字段。

  3. 视频播放诊断。

    1. 视频播放页,选择类型,即视频的播放方式,提供了原生H5阿里云H5阿里云Flash这三种播放方式。

    2. 填写Source参数(视频播放地址),单击播放,即可开始诊断。如果没有Source参数,也可填写VidplayAuth参数。

      说明

      Source参数的优先级最高。

    3. 开始诊断时,播放页面会显示播放日志。播放后,视频区域左侧会叠加显示诊断事件日志,包括开始播放(play)、等待数据(waiting)、开始请求数据(loadstart)、正在请求数据(progress)、源数据加载完成(loadedmetadata)、当前帧的数据已加载(loadeddata)、加载部分可以播放(canplay)、全部加载完毕(canplaythrough)、暂停播放(pause)、播放结束(ended)等事件及对应时间戳。

相关文档

错误码