如果您的应用使用阿里云播放器SDK播放视频,您可以通过播放质量监控服务了解您应用的播放质量及用户观看情况。播放质量监控基于阿里云播放器SDK上报的埋点数据提供播放失败率、秒开率、卡顿率等指标供您快速了解视频播放质量情况。
工作原理
播放质量监控服务依赖于阿里云播放器SDK上报的埋点数据,埋点逻辑如下图所示:
指标说明
QoS指标
QoS指标可以了解当前应用的播放服务质量。
指标 | 计算方法 | 说明 |
播放量(次数) | 视频播放的总次数。对调用播放器SDK进行播放行为进行计数。 | 从应用首次调用阿里云播放器SDK进行播放( |
实际播放量(次数) | 实际播放量=视频播放的总次数-播放失败的总次数-起播跳失的次数 | 一般情况下“起播跳失”的占比极低,可以忽略。 |
首帧时间(毫秒) | 用户从调用阿里云播放器SDK发起播放请求到首帧完成播放的时间。 | 若未起播,则没有首帧时间。 |
QoE指标
QoE指标可以了解当前应用的用户观看情况。
指标 | 计算方法 | 说明 |
访问用户数(人) | 对唯一用户标识(阿里云播放器SDK会生成uuid)进行排重计数 | 在当前时间段内,观看视频的用户总数,即应用调用阿里云播放器SDK的活跃用户数量。移动端根据设备ID识别独立用户。 |
人均播放次数(次) | 人均播放次数=播放量÷访问用户数 | - |
平均视频时长(秒) | AVG(视频时长) | 用户播放的所有视频的平均视频时长。 |
前提条件
使用播放质量监控功能之前,您需要做如下准备:
仅支持下述版本的阿里云播放器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播放器接口说明。
使用限制
仅支持查询最近3日内的播放数据,单次查询时间段暂不支持跨日。
操作步骤
登录视频点播控制台。
在左侧导航栏选择
,进入播放质量监控页面。查看各维度指标数据。
支持按以下维度筛选查询数据:
支持按终端类型、系统类型、分辨率、网络类型等维度筛选查询数据。
支持查询近1小时至近3日内的自定义时段数据。
通过单击新增过滤条件,支持按SDK版本、视频格式、是否硬解、运营商、域名、省份设置过滤条件进行查询数据,并可将常用的过滤规则保存下来供后续直接选用,详情如下:
条件内容
说明
SDK版本
指当前应用程序所接入的播放器SDK版本号。
视频格式
指视频文件所采用的编码方式,例如HLS格式、FLV格式等。
是否硬解
指在视频解码过程中是否启用了硬解码功能。
运营商
通过网络服务提供商对播放数据进行区分。
域名
指视频内容所在的服务器地址。
国家
根据用户的地理位置对播放数据进行划分。
中国省份
缩小播放数据范围至省级行政区划内。