Introduction

You have two ways to work with SDK for Windows:

Programming language Description Target Application
C Direct addressing of the C-library (low level). Native Desktop Application
C# Indirect adressing of the C-library via C#-wrapper (high level). .NET Desktop Application

This introduction covers general topics which are relevant for both approaches.

Known Limitations

This SDK does not work for Windows Apps in Microsoft Store.

Libraries

The extracted .zip-file of SDK for Windows contains several library files.

Relevant library files are:

File path Description
library/[platform]/libjabra.dll C-library for the respective platform (x86, x64 and ARM64).
library/[platform]/JabraSDK.dll C#-wrapper (x86 and x64)
library/Headers/ Folder containing all header files for the C-library. Header files contain functions, structures, definitions and descriptions of all C-library features.

Logging

Logs are essential to monitor your application and especially helpful during troubleshooting.

Log Levels

Log level can be defined by setting the environment variable LIBJABRA_TRACE_LEVEL:

Log Level Description
info Normal system event.
warning Indicator of undesired behaviour. This is the default setting for the logs.
error Indicator of erroneous behaviour.
fatal Indicator of unwanted shutdown or other severe malfunction.

You can set the log level in System Environment Variables in Windows operating system.

Log Storage

Logs are stored in \Users\%USERNAME%\AppData\Roaming\JabraSDK\Logging by default.

  • Application log file size is restricted to 10 MB. If a log exceeds this size, a new file will be created.
  • 10 latest log files can be stored, after that on new log file creation the oldest log is deleted.

Bluetooth devices and dongles

  • Jabra Bluetooth headsets support SDK for Windows only if paired with a compatible Bluetooth dongle.
  • The USB dongle and the paired Bluetooth headset are shown as two separate entries in the list of connected devices of the SDK

Jabra Direct

UC Client applications developed with SDK for Windows do not require Jabra Direct on the target system.

Points to Remember

Concurrency

  • Concurrency is maintained between all the applications which use SDK for Windows including Jabra Direct

Button Customization (Remote MMI)

  • The button configurations should be cleared/reset on device unplug or exit of the application. The application should perform button configuration again on next start up
  • The device does not provide any information on configured buttons. This can lead to problems when more than one application uses button customization.

Firmware Management

  • software developers have to register for the authorization token for the firmware updater

  • For firmware update feature, firmware updater application (JabraSDKFirmwareUpdater) needs to be installed. It will be downloaded from cloud as part of firmware file download for Jabra device from Jabra_DownloadFirmware API

  • Jabra_DownloadFirmware API to be called before calling firmware update API to get the firmware file path