C#-Wrapper

This section explains how you use the C#-wrapper to integrate .NET Desktop Applications with SDK for Windows.

The .NET Application addresses the C library through a C# wrapper.

Device Service

The Device Service reports connected Jabra devices that support telephony.

Access and use the Device Service as shown below:

private IServiceFactory ServiceFactory;
public static IDeviceService MyDeviceService;
void LoadSDK()
{
    // Get a device service interface
    ServiceFactory = new ServiceFactory();
    ServiceFactory.SetClientId(""); // Your Partner Key as provided from developer.jabra.com
    DeviceService = ServiceFactory.CreateDeviceService();
    // Subscribe for device added, removed, raw button input, translated button input, first scan done etc.
    DeviceService.FirstScanDone += DeviceService_FirstScanDone;
    DeviceService.DeviceAdded += DeviceService_DeviceAdded;
    DeviceService.DeviceRemoved += DeviceService_DeviceRemoved;
    DeviceService.RawButtonInput += DeviceService_RawButtonInput;
    DeviceService.TranslatedButtonInput += DeviceService_TranslatedButtonInput;
}
private void DeviceService_TranslatedButtonInput(object sender, TranslatedButtonInputEventArgs e)
{
    throw new NotImplementedException();
}
private void DeviceService_RawButtonInput(object sender, RawButtonInputEventArgs e)
{
    throw new NotImplementedException();
}
private void DeviceService_DeviceRemoved(object sender, DeviceRemovedEventArgs e)
{
    throw new NotImplementedException();
}
    private void DeviceService_FirstScanDone(object sender, EventArgs e)
{
    throw new NotImplementedException();
}
private void DeviceService_DeviceAdded(object sender, DeviceAddedEventArgs e)
{
    throw new NotImplementedException();
}

Users can also provide the optional parameters for configuring the SDK at initialization using IConfigurationParams.

Subscriptions

Available subscriptions are:

SetFirmwareUpdaterPath() to be called to set the path to the firmware updater executable that will be invoked when updating the device.

User needs to subscribe for LoggingEvent to log the events like:

• DEVICE CONNECTED
• DEVICE DISCONNECTED
• BATTERY STATUS CHARGING
• BATTERY STATUS LOW
• BATTERY STATUS LEVEL

Audio Link

For wireless headsets, the radio link between the headset and its base or Bluetooth USB adapter is usually closed if there are no active calls. This is done to preserve battery time.

When the radio link is closed, there is no audio path between the headset and its base or Bluetooth USB adapter.

If you want audio to and from the headset outside calls, you can manually open and close an audio (radio) link with the method SetAudioLinkState().

Bluetooth Adapter Interface

The Jabra Bluetooth adapter interface is used to connect a Bluetooth device with the Jabra Bluetooth adapter.

The following methods are available in this interface:

Button Events Interface

The button events interface enables the user to configure Button Events in Jabra devices. IsButtonConfigurationSupported property reports whether the device supports configuration of button events.

The other methods provided by button event interface are:

Remote MMI v2 Interface (Button Configuration)

Remote MMIv2 is used for controlling buttons and LEDs of supported Jabra devices.

Methods provided by this interface are:

Device logging events

Some devices are able to send a variety of events happening in the headset to the computer. Events can be for example button presses or call control events.

In order to log device events, a listener function that will handle the data must be created.

Step 1: Prepare the listener function

Print the data on a terminal: cs private void DeviceLoggingInputListener(object sender, DeviceLoggingEventArgs e) { Console.WriteLine("DeviceLoggingInput from device {0}: {1}", e.DeviceId, e.Data); }

Step 2: Setup Device Logging

Add the listener function from the previous step to the IDeviceService: cs ServiceFactory serviceFactory = new ServiceFactory(); serviceFactory.SetClientId(""); // Initialize with your Partner Key from developer.jabra.com IDeviceService deviceService = serviceFactory.CreateDeviceService(); deviceService.DeviceAdded += DeviceAttachedListener; // Subscribing to device attached deviceService.DeviceLoggingInput += DeviceLoggingInputListener; // Subscribing to device logging events

Step 3: Enable Device Logging

To receive events for a device, device logging must be enabled.

Enable device logging like this:

private void DeviceAttachedListener(object sender, DeviceAddedEventArgs e)
{
    bool enabled = e.Device.IsDeviceLogEnabled; // Checking status

    if (enabled == false)
        e.Device.DeviceLoggingConfiguration(true); // Enabling
}

Now you can receive DeviceLogging events.

Data Format for Device Logs

The device logging data is formatted as a JSON string with varying fields depending on the event.

Some of those fields are:

DECT Density events

Some devices support DECT density events. You can register a listener for them in a similar manner to the device logging events.

Step 1: Prepare the listener function

Create a listener function like this:

private void DectInformationInputListener(object sender, DectInformationEventArgs e)
{
    string dectInfoRawDataStr = string.Join(" ", Array.ConvertAll(e.DectInformation.RawData, Convert.ToUInt32));
    // do something with dectInfoRawDataStr...
}

Step 2: Setup the DECT events

Add the listener to IDeviceService:

ServiceFactory serviceFactory = new ServiceFactory();
serviceFactory.SetClientId(""); // Initialize with your Partner Key from developer.jabra.com
IDeviceService deviceService = serviceFactory.CreateDeviceService();
deviceService.DeviceAdded += DeviceAttachedListener; // Subscribing to device attached
deviceService.DectInformationInput += DectInformationInputListener; // Subscribing to DECT density events

Step 3: Enable DECT density logging

To receive events for a device, DECT density logging must be enabled.

Enable DECT density logging like this:

private void DeviceAttachedListener(object sender, DeviceAddedEventArgs e)
{
    bool enabled = e.Device.IsDeviceLogEnabled; // Checking status

    if (enabled == false)
        e.Device.DeviceLoggingConfiguration(true); // Enabling
}

Now you have subscribed to DECT density events.

Firmware Update

There are several methods for Firmware Update functionality.

These methods are: