Bluetooth Link Quality

This datapoint indicates the quality of the connection between the USB dongle and wireless device. This information can be used to determine if the Bluetooth connection caused a bad call experience for the user.

Datapoint

Supported SDKs

Supported devices

Code Sample

The code sample demonstrates the event subscription. It shows how to parse the event to get back the data for the datapoint.

To receive the first link quality event when the listener is added, it is best practice to only add the listener when the device goes offhook. To make sure you get the value again when a second call starts, remember to remove the listener when the device goes onhook.

There is no function to check if link quality is supported, but an exception is raised when adding the listener on an unsupported device, so make sure to catch it.

using System;
using System.Collections.Generic;
using JabraSDK;

namespace Jabra.TelemetryExample
{
    public class TelemetryPrinter
    {
        public TelemetryPrinter(IDeviceService deviceService)
        {
            deviceService.DeviceAdded += OnDeviceAddedEvent;
        }

        private void OnDeviceAddedEvent(object sender, DeviceAddedEventArgs e)
        {
            try
            {
                // It is not guaranteed that the sender of the LinkQuality event is the device ID,
                // so we create a local function and pass the DeviceId
                void LinkQualityFunc(object linkQualitySender, LinkQualityEventArgs linkQualityArgs) => 
                        OnLinkQualityEvent(e.Device.DeviceId, linkQualityArgs);

                e.Device.LinkQuality += LinkQualityFunc;
            }
            catch
            {
                Console.WriteLine($"Bluetooth link quality not supported for {e.Device.Name} (ID: {e.Device.DeviceId})");
            }
        }

        private void OnLinkQualityEvent(int deviceId, LinkQualityEventArgs e)
        {
            Console.WriteLine($"Bluetooth link quality for device with ID {deviceId} is: {e.LinkQuality}");
        }
    }
}