macOS Release Notes

Version 1.12.2.0

Improvements

  • Added support for Apple M1
  • Support for Jabra Link 400 and Jabra Engage 55
  • Added functions to read and write PanaCast 50 network settings
  • Reduced network traffic

Fixes

  • Preloading device info will now overwrite existing resources
  • Fixed memory leaks in zip file extraction

Details

  • Updates:
    • Added support for Apple M1
    • Added DECT connection type
    • Added support for Jabra Link 400/Engage 55 (will present primary HS as a child device)
    • Added networking device features
  • Added APIs:
    • Jabra_GetUserDefinedDeviceName
    • Jabra_GetSubDeviceProperty
    • Jabra_SetNetworkAuthenticationMode
    • Jabra_GetNetworkAuthenticationMode
    • Jabra_SetNetworkAuthenticationIdentity
    • Jabra_RegisterNetworkStatusChangedCallback
  • Fixes:
    • Memory leak during zip file extraction
    • Increase factory reset wait timer to allow Engage 65/75 to finish before reporting an error
    • Significantly reduced amount of network traffic
    • Jabra_SetDateTime would errorneously reject some valid dates
    • Event enables are now reference counted so they should remain active while they are needed by any clients
    • Jabra_PreloadDeviceInfo/Jabra_PreloadAttachedDeviceInfo was unable to replace existing resources

Version 1.11.1.0

Improvements

  • Native support for Apple M1 processors
  • New link quality data point for supported dongle devices

Fixes

  • Jabra_PreloadAttachedDeviceInfo would reject resources for some devices
  • When specifying an Xpress URL, the URL will now be stripped for any invalid characters
  • Bugfix of possible crash during uninitilization of the SDK

Details

  • Added APIs:
    • Jabra_GetDeviceHiresImagePath
    • Jabra_SetLinkQualityStatusListener
    • Jabra_DectPair
    • Jabra_DectPairSecure
    • Jabra_GetDectPairKey
    • Jabra_SetDectPairKey
    • Jabra_GetConnectedHeadsetNames
    • Jabra_GetDetailedDeviceLanguageInformation
    • Jabra_FreeLanguagePackStats
    • Jabra_GetFirmwareVersionBundle
    • Jabra_GetRemoteControlFirmwareVersion
    • Jabra_GetXpressManagementNetworkStatus
    • Jabra_NotifyXpressConnectionStatusExtended
    • Jabra_RegisterXpressConnectionStatusExtendedCallback
    • Jabra_GetMACAddress
    • Jabra_NextIntelligentZoomMode
    • Jabra_GetPeopleCount
    • Jabra_GetPeopleCountSettings
    • Jabra_SetPeopleCountSettings
    • Jabra_GetSensorRegions
  • Fixes:
    • Bluetooth link quality events were not always forwarded to the correct device
    • Jabra_PreloadAttachedDeviceInfo would reject resources for some devices
    • When specifying an Xpress URL, the URL will now be stripped for any invalid characters
    • Bugfix of possible crash during uninitilization of the SDK

Version 1.10.1.0

Improvements

  • Support for Jabra PanaCast 20
  • New / Core SDK library changes
    • The following APIs have been added
      • Jabra_ConfigureXpressManagement (for Jabra PanaCast 50)
      • Jabra_GetUSBState (for Jabra PanaCast 20)
  • Jabra_GetDiagnosticLogFile() now works with Jabra PanaCast 20 as well as Jabra PanaCast 50

Fixes

  • Jabra_PreloadAttachedDeviceInfo() and Jabra_PreloadDeviceInfo() can now overwrite existing files
  • When Jabra PanaCast 50 is connected, the macOS SDK demo app no longer crashes

Breaking changes

  • Native SDK GetSettings() now returns an empty string instead of NULL for undefined values

Deprecated

  • Removed outdated and uninformative UI screenshots

Details

  • Added APIs:

    • Jabra_ConfigureXpressManagement (for PanaCast 50)
    • Jabra_GetUSBState (for PanaCast 20)
  • Fixes:

    • Jabra_PreloadAttachedDeviceInfo() and Jabra_PreloadDeviceInfo() can now overwrite existing files
    • Native SDK GetSettings() will now return an empty string instead of NULL for undefined values: This fixes: Mac SDK demo app crashing when PanaCast 50 is connected
  • Other:

    • Jabra_GetDiagnosticLogFile() now works with PanaCast 20 as well as PanaCast 50
    • Removed UI screenshots from docs as they were outdated and not very informative

Version 1.9.0.0

Improvements

  • Support for Jabra PanaCast 50
  • The following features for Jabra PanaCast can be controlled where device support is available:
    • Whiteboard
    • Dual stream
    • Image controls
    • Pan, tilt, zoom
    • Intelligent zoom
    • Picture-in-picture
    • People count
    • Networking

For specific details regarding feature support for your relevant Jabra PanaCast device, see the PanaCast Component page. - The following new APIs support proxied setups. This allows you to preload manifest files, which is required for set ups where the SDK is unable to access the Jabra cloud service where the manifest files are hosted: - Jabra_PreloadDeviceInfo (undeprecated) - Jabra_GetLocalManifestVersion - Jabra_PreloadAttachedDeviceInfo - Other - Battery status is now reported through the device log

Fixes

  • In most Jabra devices, when requesting or performing a factory reset on an actively streaming device – for example – during an active call, the reset function no longer returns a success response
  • The Jabra_SetSettings call now executes successfully after failed attempts
  • The SDK no longer attempts to connect to the backend for third-party devices

Known Issues

  • When Jabra PanaCast 50 is connected, the macOS SDK demo app crashes

Details

  • Added APIs for Panacast 50:

    • Jabra_EnableRemoteManagement
    • Jabra_IsRemoteManagementEnabled
    • Jabra_SetXpressUrl
    • Jabra_GetXpressUrl
    • Jabra_SetPasswordProvisioning
    • Jabra_GetPasswordProvisioning
    • Jabra_NotifyXpressConnectionStatus
    • Jabra_RegisterXpressConnectionStatusCallback
    • Jabra_GetEthernetIPv4Status
    • Jabra_GetWLANIPv4Status
    • Jabra_GetDiagnosticLogFile
    • Jabra_TriggerDiagnosticLogGeneration
    • Jabra_RegisterDiagnosticLogCallback
    • Jabra_SetPanTilt
    • Jabra_GetPanTilt
    • Jabra_GetPanTiltLimits
    • Jabra_SetPanTiltRelativeAction
    • Jabra_SetZoomRelativeAction
    • Jabra_SetZoom
    • Jabra_GetZoom
    • Jabra_GetZoomLimits
    • Jabra_SetIntelligentZoomLatency
    • Jabra_GetIntelligentZoomLatency
    • Jabra_SetSecondVideoStream
    • Jabra_GetSecondVideoStream
    • Jabra_SetVideoHDRDefault
    • Jabra_GetVideoHDRDefault
    • Jabra_SetVideoHDR
    • Jabra_GetVideoHDR
    • Jabra_RestoreVideoRoomDefaults
    • Jabra_SetContrastLevel
    • Jabra_SetSharpnessLevel
    • Jabra_SetBrightnessLevel
    • Jabra_SetSaturationLevel
    • Jabra_SetWhiteBalance
    • Jabra_GetContrastLevel
    • Jabra_GetSharpnessLevel
    • Jabra_GetBrightnessLevel
    • Jabra_GetSaturationLevel
    • Jabra_GetWhiteBalance
    • Jabra_GetContrastLimits
    • Jabra_GetSharpnessLimits
    • Jabra_GetWhiteBalanceLimits
    • Jabra_GetSaturationLimits
    • Jabra_GetBrightnessLimits
    • Jabra_SetVideoTransitionStyle
    • Jabra_GetVideoTransitionStyle
    • Jabra_SetRoomCapacity
    • Jabra_GetRoomCapacity
    • Jabra_SetRoomCapacityNotificationEnabled
    • Jabra_GetRoomCapacityNotificationEnabled
    • Jabra_SetNotificationStyle
    • Jabra_GetNotificationStyle
    • Jabra_SetNotificationUsage
    • Jabra_GetNotificationUsage
    • Jabra_SetVideoMode
    • Jabra_GetVideoMode
    • Jabra_IsCameraStreaming
    • Jabra_IsVideoDeviceStreaming
    • Jabra_StorePTZPreset
    • Jabra_ApplyPTZPreset
    • Jabra_StoreColorControlPreset
    • Jabra_ApplyColorControlPreset
    • Jabra_GetPictureInPicture
    • Jabra_SetPictureInPicture
    • Jabra_ResetImageQualityControls
    • Jabra_ResetPanTiltZoom
    • Jabra_RegisterCameraStatusCallback
    • Jabra_SetWhiteboardPosition
    • Jabra_GetWhiteboardPosition
    • Jabra_SetWhiteboardOnMainStream
    • Jabra_GetWhiteboardOnMainStream
    • Jabra_GetRemoteControlBatteryStatus
  • Added device constants APIs: (very limited device support for now)

    • Jabra_GetConstants
    • Jabra_GetConst
    • Jabra_ReleaseConst
    • Jabra_AsInt
    • Jabra_AsBool
    • Jabra_AsString
    • Jabra_GetField
    • Jabra_ListElement
  • New APIs to support proxied setups:

    • Jabra_PreloadDeviceInfo (undeprecated)
    • Jabra_GetLocalManifestVersion
    • Jabra_PreloadAttachedDeviceInfo
  • Fixes:

    • macOS 11.x: Firmware updater failed to download
    • When requesting a factory reset on an actively streaming device, it should not return success
    • Calling Jabra_SetSettings a 2nd time with the same payload after one failed attempt should now properly try again
    • SDK should no longer attempt to connect to the backend for third party devices
  • Other:

    • Battery status is now reported through the device log

Version 1.8.8.4

  • Reintroducing the Call Lock functionality. This functionality ensures that two softphones do not use the same Jabra device at the same time - it does so by controlling access to the call control functionality in the SDK library. Call Lock consists of three API functions:

    • Jabra_GetLock()
    • Jabra_ReleaseLock()
    • Jabra_IsLocked().

    By acquiring a lock beforehand softphones can co-exist without interfering with each other, if acquiring the lock fails another softphone is currently using the device. See more information on the Call Lock page.

  • New APIs for Active Noise Cancellation and hear-through. Hear-through allows the users to get audio from their surroundings in the headset. Look for AmbienceMode.

Details

New APIs :

  • The following are the new APIs supported
    • Jabra_GetDateTime
    • Jabra_GetLock
    • Jabra_ReleaseLock
    • Jabra_IsLocked
    • Jabra_GetAmbienceMode
    • Jabra_SetAmbienceMode
    • Jabra_GetSupportedAmbienceModes
    • Jabra_GetSupportedAmbienceModeLevels
    • Jabra_GetAmbienceModeLevel
    • Jabra_SetAmbienceModeLevel
    • Jabra_GetSupportedAmbienceModeBalance
    • Jabra_GetAmbienceModeBalance
    • Jabra_SetAmbienceModeBalance
    • Jabra_GetAmbienceModeNoiseLevel
    • Jabra_GetAmbienceModeSetting
    • Jabra_SetAmbienceModeSetting
    • Jabra_GetAmbienceModeLoop
    • Jabra_SetAmbienceModeLoop
    • Jabra_SetAmbienceModeChangeListener
    • Jabra_IsManualBusylightSupported
    • Jabra_GetManualBusylightStatus
    • Jabra_SetManualBusylightStatus
    • Jabra_RegisterManualBusylightEvent
    • Jabra_GetPanicCodes
    • Jabra_ClearPanicCodes

Version 1.8.7.15

Support for macOS Big Sur

version 1.8.7.12

The following are the new APIs supported:

  • Jabra_RebootDevice
  • Jabra_EnableFirmwareLock
  • Jabra_GetSecureConnectionMode
  • Jabra_RegisterDectInfoHandler

Breaking changes

Please note the following breaking change from version 1.8.3.10.

Jabra SDK does not support sending STD HID to the device.
If you need this you have to use another way.

Version 1.8.3.10

The following are the new APIs supported:

  • Jabra_InitializeV2
  • Jabra_SetHidEventsFromNonJabraDevices
  • Jabra_IsHidEventsFromNonJabraDevicesEnabled
  • Jabra_SetStdHidEventsFromJabraDevices
  • Jabra_IsStdHidEventsFromJabraDevicesEnabled
  • Jabra_GetSku
  • Jabra_GetBatteryStatusV2
  • Jabra_CopyJabraBatteryStatus
  • Jabra_FreeBatteryStatus
  • Jabra_RegisterBatteryStatusUpdateCallbackV2
  • Jabra_RegisterDectInfoHandler
  • Jabra_FreeDectInfoStr
  • Jabra_GetCustomerSupportUrl
  • Jabra_SetJackConnectorStatusListener
  • Jabra_SetHeadDetectionStatusListener
  • Jabra_SetLinkConnectionStatusListener

The following are the deprecated APIs in this release:

  • Jabra_GetBatteryStatus (now V2)
  • Jabra_RegisterBatteryStatusUpdateCallback (now V2)
  • Jabra_Initialize (now V2)