RemoteAudioStats

远端用户的音频统计数据。

Dart

@JsonSerializable(explicitToJson: true, includeIfNull: false)
class RemoteAudioStats {
  const RemoteAudioStats(
      {this.uid,
      this.quality,
      this.networkTransportDelay,
      this.jitterBufferDelay,
      this.audioLossRate,
      this.numChannels,
      this.receivedSampleRate,
      this.receivedBitrate,
      this.totalFrozenTime,
      this.frozenRate,
      this.mosValue,
      this.totalActiveTime,
      this.publishDuration,
      this.qoeQuality,
      this.qualityChangedReason,
      this.e2eDelay});
  @JsonKey(name: 'uid')
  final int? uid;
  @JsonKey(name: 'quality')
  final int? quality;
  @JsonKey(name: 'networkTransportDelay')
  final int? networkTransportDelay;
  @JsonKey(name: 'jitterBufferDelay')
  final int? jitterBufferDelay;
  @JsonKey(name: 'audioLossRate')
  final int? audioLossRate;
  @JsonKey(name: 'numChannels')
  final int? numChannels;
  @JsonKey(name: 'receivedSampleRate')
  final int? receivedSampleRate;
  @JsonKey(name: 'receivedBitrate')
  final int? receivedBitrate;
  @JsonKey(name: 'totalFrozenTime')
  final int? totalFrozenTime;
  @JsonKey(name: 'frozenRate')
  final int? frozenRate;
  @JsonKey(name: 'mosValue')
  final int? mosValue;
  @JsonKey(name: 'totalActiveTime')
  final int? totalActiveTime;
  @JsonKey(name: 'publishDuration')
  final int? publishDuration;
  @JsonKey(name: 'qoeQuality')
  final int? qoeQuality;
  @JsonKey(name: 'qualityChangedReason')
  final int? qualityChangedReason;
  @JsonKey(name: 'e2eDelay')
  final int? e2eDelay;
  factory RemoteAudioStats.fromJson(Map<String, dynamic> json) =>
      _$RemoteAudioStatsFromJson(json);
  Map<String, dynamic> toJson() => _$RemoteAudioStatsToJson(this);
}

uid

远端用户的用户 ID。

quality

远端用户发送的音频流质量。详见 QualityType。

networkTransportDelay

音频发送端到接收端的网络延迟（毫秒）。

jitterBufferDelay

音频接收端到网络抖动缓冲的网络延迟（毫秒）。

注意

当接收端为观众且 ClientRoleOptions 的 audienceLatencyLevel 为 1 时，该参数不生效。

audioLossRate

统计周期内的远端音频流的丢帧率 (%)。

numChannels

声道数。

receivedSampleRate

统计周期内接收到的远端音频流的采样率。

receivedBitrate

接收到的远端音频流在统计周期内的平均码率（Kbps）。

totalFrozenTime

远端用户在加入频道后发生音频卡顿的累计时长（毫秒）。通话过程中，音频丢帧率达到 4% 即记为一次音频卡顿。

frozenRate

音频卡顿的累计时长占音频总有效时长的百分比 (%)。音频有效时长是指远端用户加入频道后音频未被停止发送或禁用的时长。

totalActiveTime

远端用户在音频通话开始到本次回调之间的有效时长（毫秒）。

有效时长是指去除了远端用户进入静音状态的总时长。

publishDuration

远端音频流的累计发布时长（毫秒）。

qoeQuality

接收远端音频时，本地用户的主观体验质量。

qualityChangedReason

接收远端音频时，本地用户主观体验质量较差的原因。详见 ExperiencePoorReason。

mosValue

统计周期内，声网实时音频 MOS（平均主观意见分）评估方法对接收到的远端音频流的质量评分。返回值范围为 [0,500]。返回值除以 100 即可得到 MOS 分数，范围为 [0,5] 分，分数越高，音频质量越好。

声网实时音频 MOS 评分对应的主观音质感受如下：

MOS 分数	音质感受
大于 4 分	音频质量佳，清晰流畅。
3.5 - 4 分	音频质量较好，偶有音质损伤，但依然清晰。
3 - 3.5 分	音频质量一般，偶有卡顿，不是非常流畅，需要一点注意力才能听清。
2.5 - 3 分	音频质量较差，卡顿频繁，需要集中精力才能听清。
2 - 2.5 分	音频质量很差，偶有杂音，部分语义丢失，难以交流。
小于 2 分	音频质量非常差，杂音频现，大量语义丢失，完全无法交流。

e2eDelay

端到端音频延时（毫秒），即自远端用户音频采集起，至本地用户开始播放音频的总时长。