RTCOutboundRtpStreamStats: qpSum 属性

qpSum 属性是 RTCOutboundRtpStreamStats 字典的一个值,它通过将此发送器在与该 RTCOutboundRtpStreamStats 对象对应的视频轨道上至今产生的每个帧的量化参数 (QP) 值相加而生成。

通常,此数字越大,视频数据的压缩程度就越高。

一个无符号 64 位整数,表示由 RTCOutboundRtpStreamStats 对象描述的轨道上至今发送的每个帧的量化参数 (QP) 值之和。由于 QP 的值通常越大表示压缩因子越高,因此此和越大,通常表示流的压缩程度越高。

注意:此值仅适用于视频媒体。

使用说明

量化 是对一系列值应用有损压缩的过程,从而得到单个量子值。该值替代了该系列值,从而减少了整个数据集中出现的不同值的数量,使数据更易于压缩。量化过程和压缩量可以通过一个或多个参数来控制。

需要注意的是,QP 的值可能会定期变化(甚至每帧变化一次),因此很难确定压缩程度。您只能进行估计。您可以使用 RTCSentRtpStreamStats.framesEncoded 获取至今已编码的帧数,并从那里计算平均值。有关执行此操作的函数,请参见下面的计算平均量化

此外,QP 值的确切含义取决于所使用的编解码器。例如,对于 VP8 编解码器,QP 值可以是 1 到 127 之间的任何值,它位于帧头元素 "y_ac_qi" 中,其值在RFC 6386,第 19.2 节中定义。H.264 使用范围为 0 到 51 的 QP;在这种情况下,它是一个索引,用于在量化过程中推导出一个缩放矩阵。此外,QP 可能不是编解码器用于调整压缩的唯一参数。有关详细信息,请参阅各个编解码器规范。

示例

计算平均量化

下面显示的 calculateAverageQP() 函数计算包含 RTP 流统计信息的对象的平均 QP,如果该对象未描述 RTP 流,则返回 0。

js
function calculateAverageQP(stats) {
  let frameCount = 0;

  switch (stats.type) {
    case "inbound-rtp":
    case "remote-inbound-rtp":
      frameCount = stats.framesDecoded;
      break;
    case "outbound-rtp":
    case "remote-outbound-rtp":
      frameCount = stats.framesEncoded;
      break;
    default:
      return 0;
  }

  return status.qpSum / frameCount;
}

规范

规范
WebRTC 统计 API 的标识符
# dom-rtcoutboundrtpstreamstats-qpsum

浏览器兼容性

BCD 表仅在启用 JavaScript 的浏览器中加载。