serenada-core/app.serenada.core/CallQualitySummary

CallQualitySummary

data class CallQualitySummary(val mosScore: Double? = null, val packetLossPct: Double? = null, val medianLatencyMs: Int? = null, val medianJitterMs: Int? = null, val countDisconnects: Int = 0, val countReconnects: Int = 0, val totalDropoutDurationMs: Long = 0, val qualitySampleCount: Int = 0)

Immutable snapshot of aggregate call quality, computed by the SDK and consumed by hosts to populate their call-ended analytics. Updated live during the call and finalized at call end; remains readable after the session stops.

mosScore/packetLossPct/medianLatencyMs/medianJitterMs follow the exact null policy + counter-delta loss rules in the cross-platform contract: packet loss is computed from raw audioPacketsLost/audioPacketsReceived deltas, never by medianing the cumulative loss percentage.

Constructors

CallQualitySummary

constructor(mosScore: Double? = null, packetLossPct: Double? = null, medianLatencyMs: Int? = null, medianJitterMs: Int? = null, countDisconnects: Int = 0, countReconnects: Int = 0, totalDropoutDurationMs: Long = 0, qualitySampleCount: Int = 0)

Properties

countDisconnects

val countDisconnects: Int = 0

Number of dropout starts while in-call.

countReconnects

val countReconnects: Int = 0

Number of dropouts that recovered.

medianJitterMs

val medianJitterMs: Int? = null

Median of sampled audioJitterMs, or null.

medianLatencyMs

val medianLatencyMs: Int? = null

Median of sampled rttMs, or null.

mosScore

val mosScore: Double? = null

MOS estimate. Null unless all three of latency/jitter/loss are defined.

packetLossPct

val packetLossPct: Double? = null

Call-level audio rx packet loss percentage, from counter deltas.

qualitySampleCount

val qualitySampleCount: Int = 0

Count of stats samples that contributed >=1 usable quality field (a latency/jitter gauge, or a loss interval that was actually accumulated). Diagnostic only — the MOS null policy gates on the three medians being non-null, not on this count.

totalDropoutDurationMs

val totalDropoutDurationMs: Long = 0

Sum of dropout interval durations in ms.