# 天塞鹰眼
天塞鹰眼系统是菊风云为让开发者能够实时透明地观察通话质量而开发的一对一通话和多方通话的通话质量分析引擎，方便开发者从总体到细节把握通话中各项质量数据变化情况，为产品的优化运营提供坚实的数据支撑。
WARNING
通话质量搜索最近 3个月的数据。
# 一对一通话质量
# 搜索通话
您在登录控制台后，点击导航数据统计-天塞鹰眼进入一对一通话质量界面，在这里您可以通过选择应用，我们默认为您展示过去24小时通话数据，您可以通过时间段筛选，Mos 分筛选，通话状态筛选，通话 ID 或用户 ID 精准查询 ，点击”搜索“按钮，即可显示符合搜索条件的所有通话。
TIP
通话 ID需要在集成过程中通过 serverCallId (opens new window) 函数获取。用户 ID为集成过程中使用的用户 ID 。
# 通话列表板块
通话列表板块用于查看通话记录，展示选择时间段内的所有一对一通话记录，通过展示通话过程中的卡顿、模糊、没有声音、没有画面等信息状态，可以帮助您快速了解这个通话的体验质量。
列表内容包含8个数据，其含义和描述如见下表
| 字段名 | 描述 | 备注 |
|---|---|---|
| 通话 ID | 一对一通话的记录 ID，由纯数字组成，每一通通话的 ID 都是唯一的 | 通过1对1通话详单可查询得到 |
| 开始时间 | 通话开始的时间，当主叫方拨打算作开始时间 | / |
| 结束时间 | 通话结束的时间 | / |
| 目前状态 | 通话状态，只有两种，分别是已结束或者通话中 | / |
| 通话时长 | 通话持续的时长，是从双方接通开始计算，直到其中一方挂断结束 | 通话中的通话时长是上报时的通话时长 |
| 视频 MOS 分 | 通话总体视频质量好坏的评分，5分满分 | 详见 MOS 分介绍 |
| 音频 MOS 分 | 通话总体音频质量好坏的评分，5分满分 | 详见 MOS 分介绍 |
| 媒体 | 通话方式，分为视频通话和音频通话 | 未知即通话暂时没有上报有效的媒体信息，可能通话刚刚接通未收发媒体信息 |
# 参与者板块
接下来选择需要查看的单通通话记录，便会进入参与者板块，展示该通通话的通话用户双方详细信息，一对一通话只有主叫和被叫用户，如下图
用户板块包含8个数据，其含义和描述如见下表
| 字段名 | 描述 | 备注 |
|---|---|---|
| 用户 ID | 用户 ID，用户的唯一标识 | / |
| 主/被叫 | 表示该用户为主叫用户还是被叫用户 | 主叫：主动发起通话 被叫：被动接听通话 |
| 视频 MOS 分 | 该用户在本次通话过程中的总体视频质量评分 | 详见 MOS 分介绍 |
| 音频 MOS 分 | 该用户在本次通话过程中的总体音频质量评分 | 详见 MOS 分介绍 |
| SDK 版本 | 该用户进行本次通话所使用的 SDK 的版本号 | |
| 设备型号 | 该用户进行本次通话所使用的设备的型号 | / |
| 显示概览图 | 选择是否展示该用户的概览图板块 | / |
# 通话质量分析
# 概览图
打开显示概览图，展示所选用户该通通话的多项质量指标概览图，如下图
概览图的内容分为左右两部分，蓝色数据线表示主要数据，每5秒钟一个数据点，鼠标选中会显示该时间点的具体数值。
1.左边的是视频接收估计带宽数据折线图，展示该用户在本次通话过程中的视频接收估计带宽，其中红色虚线段表示该时间段内视频模糊，红色柱状线条表示该时间点存在视频卡顿；
2.右边的是音频接收码率数据折线图，展示该用户在本次通话过程中的音频接收码率，红色柱状线条表示该时间点存在音频卡顿，该图不存在红色虚线段。
# 详细通话质量
概览图点击右上角的”查看详细“按钮，进入该用户的详细质量数据页面，一共包含9项通话质量数据，总体分为左右两栏，左边为发送统计，右边为接收统计，如下图
9项数据描述按顺序如下表所示
| 数据名 | 描述 | 备注 |
|---|---|---|
| 视频码率 | 通话过程中单位时间传送的视频数据位数，单位 Kbps 即千位每秒 | 详见各项质量数据介绍 |
| 音频码率 | 通话过程中单位时间传送的音频数据位数，单位 Kbps 即千位每秒 | 详见各项质量数据介绍 |
| 估计带宽 | 单位 KBps 即千字节每秒 | 详见各项质量数据介绍 |
| 音/视频丢包率 | 通话过程中数据传输的丢失数据包数量占总传输数据组的比率，单位%即百分率 | 详见各项质量数据介绍 |
| 音/视频抖动 | 单位 ms 即毫秒 | 详见各项质量数据介绍 |
| 帧率 | 视频画面每秒显示的帧数，单位 fps | 详见各项质量数据介绍 |
| 音/视频 MOS 分 | 通话过程中每5秒统计的质量 MOS 分 | 详见 MOS 分介绍 |
| 音/视频往返延时 | 单位 ms 即毫秒 | 详见各项质量数据介绍 |
| MOS 分布图 | 该用户整个通话过程中 MOS 分的正态分布，单位% | / |
# 视频码率
视频码率统计分发送和接收，单位 Kbps 即千位每秒，如下图所示
视频码率等级判定区间
| 极优 | 优 | 良 | 中 | 差 | 异常 |
|---|---|---|---|---|---|
| [1000 , 10000) | [500 , 1000) | [300 , 500) | [300 , 100) | [100 , 0] | ⼩于0或⼤于10000 |
# 音频码率
音频码率统计分发送和接收，单位 Kbps 即千位每秒，如下图所示
音频码率等级判定区间
| 极优 | 优 | 良 | 中 | 差 | 异常 |
|---|---|---|---|---|---|
| [1000 , 10000) | [500 , 1000) | [300 , 500) | [300 , 100) | [100 , 0] | ⼩于0或⼤于10000 |
# 估计带宽
估计带宽统计分发送和接收，单位 KBps 即千字节每秒，如下图所示
估计带宽等级判定区间
| 极优 | 优 | 良 | 中 | 差 | 异常 |
|---|---|---|---|---|---|
| [1000 , 10000) | [500 , 1000) | [300 , 500) | [300 , 100) | [100 , 0] | ⼩于0或⼤于10000 |
# 丢包率
丢包率统计分音频接收丢包率、音频发送丢包率、视频接收丢包率、视频发送丢包率，单位%即百分率，如下图所示
丢包率等级判定区间
| 极优 | 优 | 良 | 中 | 差 | 异常 |
|---|---|---|---|---|---|
| [0 , 1) | [1 , 5) | [5 , 15) | [15 , 40) | [40 , 100) | ⼩于0或⼤于100 |
# 抖动
抖动统计分音频接收抖动、音频发送抖动、视频接收抖动、视频发送抖动，单位 ms 即毫秒，如下图所示
抖动等级判定区间
| 极优 | 优 | 良 | 中 | 差 | 异常 |
|---|---|---|---|---|---|
| [0 , 10) | [10 , 25) | [25 , 50) | [50 , 100) | [100 , 10000) | ⼩于0或⼤于10000 |
# 帧率
帧率统计只有视频接收帧率数据，单位 fps，如下图所示
帧率等级判定区间
| 极优 | 优 | 良 | 中 | 差 | 异常 |
|---|---|---|---|---|---|
| [24 , 60] | [17 , 24) | [10 , 17) | [5 , 10) | [0 , 5) | ⼩于0或⼤于60 |
# MOS 分
MOS 分统计分为视频流畅度 MOS 分、视频清晰度 MOS 分、音频 MOS 分，均为接收统计，单位分，如下图所示：
MOS分等级区间判定详见 MOS 分介绍。
# 往返延时
往返延时统计分音频往返延时、视频往返延时，单位 ms 即毫秒，如下图所示
往返延时等级判定区间
| 极优 | 优 | 良 | 中 | 差 | 异常 |
|---|---|---|---|---|---|
| [0 , 50) | [50 , 150) | [150 , 400) | [400 , 800) | 大于等于800 | ⼩于0 |
# MOS 分布图
MOS 分布统计同样分音频 MOS 分、视频流畅度 MOS 分、视频清晰度 MOS 分，均为接收统计，该用户通话过程中各个上报点 MOS 分所占的比率，单位%，如下图所示：
MOS 分布不存在等级判定。
# 多方通话质量
# 搜索通话
您在登录控制台后，点击导航数据统计-天塞鹰眼进入多方通话质量界面，在这里您可以通过筛选应用，我们默认为您展示过去24小时通话数据，您可以通过时间段筛选，Mos 分筛选，通话状态筛选，通话 ID 、用户 ID、会议名称或会议精准查询 ，点击”搜索“按钮，即可显示符合搜索条件的所有通话。
TIP
通话 ID需要在集成过程中通过 sessionId (opens new window) 函数获取。用户 ID为集成过程中使用的用户 ID。
# 通话列表板块
通话列表板块用于查看通话记录，展示选择时间段内的所有多方通话记录，按照通话开始时间倒序排列，如下图
列表内容包含7个数据，其含义和描述如见下表
| 字段名 | 描述 | 备注 |
|---|---|---|
| 通话 ID | 多方通话的记录 ID，由纯数字组成，每一通通话的 ID 都是唯一的 | / |
| 开始时间 | 通话开始的时间 | / |
| 结束时间 | 会议关闭结束的时间 | / |
| 会议名称 | 会议名称，根据设定才会显示 | / |
| 通话时长 | 通话会议持续的时长 | |
| 视频 MOS 分 | 通话总体视频质量好坏的评分，5分满分 | 详见 MOS 分介绍 |
| 音频 MOS 分 | 通话总体音频质量好坏的评分，5分满分 | 详见 MOS 分介绍 |
| 目前状态 | 通话状态，只有两种，分别是已结束或者通话中 | / |
# 参与者板块
接下来选择需要查看的单通会议记录，便会进入参与者板块，展示该会议的通话用户详细信息，如下图
用户板块包含10个数据，其含义和描述如见下表：
| 字段名 | 描述 | 备注 |
|---|---|---|
| 用户 ID | 用户 ID，用户的唯一标识 | / |
| 媒体流向 | 媒体流向四种情况： 1.只有媒体流发送, 图标类似：> 2.有媒体流发送且有接收，图标类似：<> 3.只有媒体流接收，图标类似：< 4.没有发送也没有接收，无方向图标 | 没有标明字段名，而是用方向图标表示 |
| 通话在线状态 | 表示参与者在整个多方通话过程中的在线状态，灰色部分表示当前人员在这段时间内不在会议中，蓝色部分表示其在参会中。 | / |
| 用户进出通话时间 | 表示该用户初次进入会议到最后一次离开会议的时间段 | / |
| 通话总时长 | 表示该用户在本次会议中通话的总共时长 | / |
| 视频 MOS 分 | 该用户在本次通话过程中的总体视频质量评分 | 详见 MOS 分介绍 |
| 音频 MOS 分 | 该用户在本次通话过程中的总体音频质量评分 | 详见 MOS 分介绍 |
| SDK 版本 | 该用户进行本次通话所使用的 SDK 的版本号 | / |
| 设备型号 | 该用户进行本次通话所使用的设备的型号 | / |
| 显示概览图 | 选择是否展示该用户的概览图板块 | / |
# 通话质量分析
# 概览图
打开显示概览图，展示所选用户该通通话的多项质量指标概览图，如下图
概览图的内容分为左右两部分，蓝色数据线表示主要数据，每5秒钟一个数据点，鼠标选中会显示该时间点的具体数值：
1.左边的是视频总体接收估计带宽数据折线图，展示该用户在本次通话过程中接收的所有订阅者的视频估计带宽，其中红色虚线段表示该时间段内视频模糊，红色柱状线条表示该时间点存在视频卡顿；
2.右边的是音频总体接收码率数据折线图，展示该用户在本次通话过程中的音频接收码率，红色柱状线条表示该时间点存在音频卡顿，该图不存在红色虚线段。
# 详细通话质量
概览图点击右上角的”查看详细“按钮，进入该用户的详细质量数据页面，一共包含11项通话质量数据，总体分为左右两栏，左边为发送统计，右边为接收统计，如下图
11项数据描述按顺序如下表所示
| 数据名 | 描述 | 备注 |
|---|---|---|
| 视频码率 | 通话过程中单位时间传送的视频数据位数，单位 Kbps 即千位每秒 | 详见各项质量数据介绍 |
| 音频码率 | 通话过程中单位时间传送的音频数据位数，单位 Kbps 即千位每秒 | 详见各项质量数据介绍 |
| 估计带宽 | 单位 KBps 即千字节每秒 | 详见各项质量数据介绍 |
| 丢包率 | 通话过程中数据传输的丢失数据包数量占总传输数据组的比率，单位%即百分率 | 详见各项质量数据介绍 |
| 抖动 | 单位 ms 即毫秒 | 详见各项质量数据介绍 |
| 帧率 | 视频画面每秒显示的帧数，单位 fps | 详见各项质量数据介绍 |
| 视频 MOS 分 | 通话过程中每5秒统计的视频质量 MOS 分 | 详见 MOS 分介绍 |
| 音频 MOS 分 | 通话过程中每5秒统计的音频质量 MOS 分 | 详见 MOS 分介绍 |
| 往返延时 | 单位 ms 即毫秒 | 详见各项质量数据介绍 |
| 视频 MOS 分布图 | 该用户整个通话过程中视频 MOS 分的正态分布，单位% | / |
| 音频 MOS 分布图 | 该用户整个通话过程中视频 MOS 分的正态分布，单位% | / |
# 视频码率
视频码率统计分发送和接收，单位 Kbps 即千位每秒，如下图所示
其中视频接收码率折线图含有多条数据线，分别是视频总接收码率和该用户接收其他各个订阅者的视频码率。
视频码率等级判定区间
| 极优 | 优 | 良 | 中 | 差 | 异常 |
|---|---|---|---|---|---|
| [1000 , 10000) | [500 , 1000) | [300 , 500) | [300 , 100) | [100 , 0] | ⼩于0或⼤于10000 |
# 音频码率
音频码率统计分发送和接收，单位Kbps即千位每秒，如下图所示
其中音频接收码率折线图含有多条数据线，分别是音频总接收码率和该用户接收其他各个订阅者的音频码率。
音频码率等级判定区间
| 极优 | 优 | 良 | 中 | 差 | 异常 |
|---|---|---|---|---|---|
| [1000 , 10000) | [500 , 1000) | [300 , 500) | [300 , 100) | [100 , 0] | ⼩于0或⼤于10000 |
# 估计带宽
估计带宽统计分总体发送估计带宽和总体接收估计带宽，单位 KBps 即千字节每秒，如下图所示
估计带宽等级判定区间
| 极优 | 优 | 良 | 中 | 差 | 异常 |
|---|---|---|---|---|---|
| [1000 , 10000) | [500 , 1000) | [300 , 500) | [300 , 100) | [100 , 0] | ⼩于0或⼤于10000 |
# 丢包率
丢包率统计分总体接收丢包率、总体发送丢包率，单位%即百分率，如下图所示
丢包率等级判定区间
| 极优 | 优 | 良 | 中 | 差 | 异常 |
|---|---|---|---|---|---|
| [0 , 1) | [1 , 5) | [5 , 15) | [15 , 40) | [40 , 100) | ⼩于0或⼤于100 |
# 抖动
抖动统计分总体接收抖动、总体发送抖动，单位 ms 即毫秒，如下图所示
抖动等级判定区间
| 极优 | 优 | 良 | 中 | 差 | 异常 |
|---|---|---|---|---|---|
| [0 , 10) | [10 , 25) | [25 , 50) | [50 , 100) | [100 , 10000) | ⼩于0或⼤于10000 |
# 帧率
帧率统计为该用户接收的各个订阅者的渲染帧率，单位 fps，如下图所示
帧率等级判定区间
| 极优 | 优 | 良 | 中 | 差 | 异常 |
|---|---|---|---|---|---|
| [24 , 60] | [17 , 24) | [10 , 17) | [5 , 10) | [0 , 5) | ⼩于0或⼤于60 |
# 视频 MOS 分
视频 MOS 分统计分为整体视频 MOS 分和该用户接收的各个订阅者视频 MOS 分，单位分，如下图所示
MOS 分等级区间判定详见 MOS 分介绍。
# 音频 MOS 分
音频 MOS 分统计分为整体音频MOS分和该用户接收的各个订阅者音频 MOS 分，单位分，如下图所示
MOS 分等级区间判定详见 MOS 分介绍。
# 往返延时
往返延时统计即为接收的总体往返延时，单位 ms 即毫秒，如下图所示
往返延时等级判定区间
| 极优 | 优 | 良 | 中 | 差 | 异常 |
|---|---|---|---|---|---|
| [0 , 50) | [50 , 150) | [150 , 400) | [400 , 800) | 大于等于800 | ⼩于0 |
# 视频 MOS 分布图
视频 MOS 分布统计分总视频 MOS 分布和接收的各个订阅者的视频 MOS 分布，会议通话过程中各个上报点 MOS 分所占的比率，单位%，如下图所示
MOS 分布不存在等级判定。
# 音频 MOS 分布图
音频 MOS 分布统计分总音频 MOS 分布和接收的各个订阅者的音频 MOS 分布，会议通话过程中各个上报点 MOS 分所占的比率，单位%，如下图所示
MOS 分布不存在等级判定。
# MOS分详细介绍
MOS 分是通过菊风自研的视频质量模型通过计算得到的客观分数，通过大量的人为主观评价实验打分对比测试之后得到的能较准确合理的评估视频质量的评判标准。取值1-5分，值越大，代表视频质量越好。
MOS 分总共分为3种，分别是视频清晰度 MOS 分、视频流畅度 MOS 分和音频 MOS 分。
MOS 分的等级判定区间
| 极优 | 优 | 良 | 中 | 差 |
|---|---|---|---|---|
| [4.2 , 5] | [3.4 , 4.2) | [2.6 , 3.4) | [1.8 , 2.6) | [1 , 1.8) |
音频 MOS 分 通话过程中音频质量的评分
| 评分 | 表现 |
|---|---|
| 4.2-5分 | 声音正常 |
| 2.6-3.4分 | 音频质量开始下降 |
| 小于2.6 | 音频出现明显卡顿 |
视频清晰度 MOS 分 通话过程中视频画面清晰度的评分
| 评分 | 表现 |
|---|---|
| 4.2-5分 | 视频画面质量正常 |
| 2.6-3.4分 | 视频画面清晰度下降 |
| 小于2.6 | 画面比较模糊 |
视频流畅度 MOS 分 通话过程中视频画面流畅度的评分
| 评分 | 表现 |
|---|---|
| 4.2-5分 | 视频画面质量正常 |
| 2.6-3.4分 | 视频流畅度下降 |
| 小于2.6 | 画面出现明显卡顿 |
而在评价一通通话或者一通通话中某个参与者总体质量评分的时候会将视频清晰度 MOS 分和视频流程度 MOS 分通过特定的计算公式计算出一个总分值，称为视频 MOS 分，也就是在通话列表板块和参与者板块种看到的视频 MOS 分。
视频 MOS 分计算公式 1 + ( 视频流畅度 MOS 分 -1)^0.6 * ( 视频清晰度 MOS 分 -1)^0.4
# 各项质量数据及上报
# 码率
每秒传送的比特(bit)数。即视频单位时间内传送的数据量。通常以bit/s为单位。码率的大小直接影响了视频的观看体验。码率越高，清晰度越高，但是同时带宽占用较大，容易出现卡顿情况。码率越低，清晰度越低，流畅程度越高。
各项质量数据不同数值的效果表现情况介绍，视频码率和估计带宽在不同分辨率下的表现效果也会存在不同，而音频码率在不同编解码下也会有不同的表现，如下。
# 视频发送/接收码率
| 分辨率 | 码率 | 表现 |
|---|---|---|
| 320*180 | 180Kbps 以上 | 清晰流畅 |
| 100-180Kbps | 略卡 | |
| 100Kbps 以下 | 卡顿明显降层 | |
| 640*360 | 470Kbps 以上 | 清晰流畅 |
| 470-260Kbps | 略卡 | |
| 260Kbps 以下 | 卡顿明显降层 | |
| 1280*720 | 1200Kbps 以上 | 清晰流畅 |
| 700-1200Kbps | 略卡 | |
| 700Kbps 以下 | 卡顿明显降层 |
# 音频发送/接收码率
| 编解码 | 码率 | 表现 |
|---|---|---|
| Opus | 6Kbps 以下 | 声⾳断续 |
| 6Kbps 以上 | 声⾳正常 | |
| G729 | 8Kbps 以下 | 声⾳断续 |
| 8Kbps 以上 | 声⾳正常 |
# 视频发送/接收估计带宽
| 分辨率 | 带宽 | 表现 |
|---|---|---|
| 320*180 | 180KBps 以上 | 清晰流畅 |
| 100-180KBps | 略卡 | |
| 100KBps 以下 | 卡顿明显降层 | |
| 640*360 | 470KBps 以上 | 清晰流畅 |
| 470-260KBps | 略卡 | |
| 260KBps 以下 | 卡顿明显降层 | |
| 1280*720 | 1200KBps 以上 | 清晰流畅 |
| 700-1200KBps | 略卡 | |
| 700KBps 以下 | 卡顿明显降层 |
# 音视频发送丢包率/音视频接收丢包率
| 丢包率 | 表现 |
|---|---|
| 5% 以下 | 音视频正常 |
| 5%-20% | 视频略有卡顿，⾳频正常 |
| 20%-40% | 视频卡顿，⾳频断续 |
| 40%-100% | 视频卡顿严重，⾳频断续严重 |
# 音视频发送/接收抖动
| 抖动 | 表现 |
|---|---|
| 100ms 以下 | 音视频延时正常 |
| 100-250ms | 略感音视频延时 |
| 大于250ms | 明显感觉音视频延时 |
# 音视频往返延时
| 延时 | 表现 |
|---|---|
| 200ms 以下 | 音视频延时正常 |
| 200-500ms | 略感音视频延时 |
| 大于500ms | 明显感觉音视频延时 |
# 视频发送/接收帧率
| 帧率 | 表现 |
|---|---|
| 15 帧以上 | 视频基本流畅 |
| 10-15帧 | 视频略卡 |
# 质量数据上报情况
一对一和多方音/视频质量数据均是由终端上报数据，默认为：每5秒统计各项质量数据，每分钟上报服务器一次，即每个通话过程中的每个参与者均会在每5秒统计一次质量数据，然后终端每隔1分钟会将这些质量数据上报至服务器，最后无论是否到1分钟在通话挂断的时候也会上传一次。