Call quality

The iOS SDK exposes real time information related to call quality. By using this API you can be notified as soon as any degradation of connectivity metrics is observed and adjust your application UI, providing visible feedback to the user.

Accessing call quality component

The iOS SDK provides the ability to receive real-time call quality events through the SinchExperimentalCallDelegate protocol, which includes the method callDidEmitCallQualityEvent(_ call: SinchCall, event: SinchCallQualityWarningEvent). This protocol is part of SinchCallDelegate, enabling the detection and handling of various call quality warning events within the call lifecycle.

public protocol SinchExperimentalCallDelegate: AnyObject {

  func callDidEmitCallQualityEvent(_ call: SinchCall, event: SinchCallQualityWarningEvent)
}

Call quality warning events

To handle call quality events, implement the callDidEmitCallQualityEvent(_ call: SinchCall, event: SinchCallQualityWarningEvent) method in your existing SinchClientMediator. This method processes different types of call quality warning events, allowing your application to respond to connectivity issues effectively.

extension SinchClientMediator: SinchCallDelegate {
  
  ...

  func callDidEmitCallQualityEvent(_ call: SinchCall, event: SinchCallQualityWarningEvent) {
    switch event {
      case .highInboundJitter(let eventType, let mediaStream):
        // Handle high inbound jitter warning
      case .highRemoteInboundRtt(let eventType, let mediaStream):
        // Handle high remote inbound RTT warning
      case .highInboundPacketLoss(let eventType, let mediaStream):
        // Handle high inbound packet loss warning
      case .missingMediaStream(let eventType):
        // Handle missing media stream warning
      case .constantAudioLevel(let eventType, let sourceType):
        // Handle constant audio level warning
      case .lowOSOutputVolumeLevel(let eventType):
        // Handle low OS output volume warning
    }
  }
}

The SinchCallQualityWarningEvent contains information about EventType, MediaStreamType or SourceStreamType. These enums categorize the nature of the call quality issues.

• EventType can be .trigger or .recover . A trigger indicates the onset of a problem, while a recover signifies the resolution of the issue
• MediaStreamType can be .audio or .video , indicating the type of media stream affected
• SourceStreamType can be .inbound or .outbound , referring to the direction of the media stream

The below table summarizes the possible types of SinchCallQualityWarningEvent objects being emmitted by the iOS SDK:

More resources on SDK specifics

For more detailed documentation of properties, classes and other iOS SDK specific structures see the Dokka documentation included inside the SDK archive available at the SDK downloads page.