Jabra Node.js SDK
Table of Contents
- Pre-requisite
- Installation
- Debugging and Logging
- API Reference
- Examples
- Features supported
- Supported devices
- Bug report
- Changelog
- License
Pre-requisite
-
Node.js version v8.x or earlier
-
On MacOS:
xcode
&python 2.7
. By default, Python is installed on macOS but make sure correct version(2.7.x) is installed. Install Xcode from App store or download it from here. -
On Windows:
Visual C++ Build Tools
&Python 2.7
. You can install all of these using commandnpm install --global --production --add-python-to-path windows-build-tools
. To know more about this tool, see this link. -
For Electron.JS: If you are using
asar
packaging then you need tounpack
some of the resources used in this module. These resources are native library files i.elibjabra.dll
,libjabra.dylib
&libjabra.so
, which is stored in ashared-lib
folder. By default latest electron builder will automatically unpack, but if it does not work then you can provide below option to your build process. To know more, see this link"build": { "asarUnpack": ["node_modules/jabra"] }
Installation
This release can be installed via below command.
npm install --save jabra@latest
Debugging and Logging
Below environment variables are defined for logging and debugging purpose. User can change the values as per preference.
Environment Variable | Value | Description |
---|---|---|
DEBUG | jabra | Debug this nodejs module, debug message will be printed on console |
LIBJABRA_TRACE_LEVEL | fatal, error, warning(default), info, debug | Log levels |
LIBJABRA_RESOURCE_PATH | On Mac: ~/Library/Application Support/JabraSDK/ On Windows: %appdata%/JabraSDK | This determine the system path where logs and device related files are written. |
API Reference
API doc is in html format. See doc folder inside installed module node_module/jabra/doc
and open index.html
.
Examples
Simple Example
This example shows how to ring a Jabra device. User should first register the app on Jabra developer site to get appID. User should pass this appID to initialize jabra
module.
const createJabraApp = ;const jabra = ; // 123 is appID here jabra; jabra;
Multiple device management
const jabra = '123'; // 123 is appID herelet deviceIDList = ; // store the list of attached deviceID jabra; jabra // suppose at some time, deviceIDList = [1, 3, 5] const deviceInstanceList = jabra; // returns the list(Map data structure) of devices const device3 = deviceInstanceList; // get device instance whose deviceID=3device3 // ring device3 returns promise const device1 = deviceInstanceList; // get device instance whose deviceID=1device1 // ring device3 returns promise
Example:
const jabra = '123'; // 123 is appID here;jabra
Features supported
- Device Information (device name, serial number, battery status)
- Remote Call Control(RCC) functionality support for below commands:
- Answer and End Call
- Mute and Unmute Call
- Hold and Resume Call
- Ring indication
- Dongle support (Link360 and Link370)
Supported devices
- Pro 9470
- Pro 9465
- Pro 9460
- Pro 9450
- Biz 2300
- Motion Office
- Evolve 65 USB
- Biz 2400 II CC
- Pro 930
- Pro 935 (single and dual)
- Pro 925 (single and dual)
- Evolve 40
- Evolve 80
- Link 265
- Evolve 30 II
- Evolve 20
- Evolve 30
- Biz 1500
- Biz 2400 II
- Link 260
- Evolve 65t
- Evolve 75
- Evolve 75e
- Engage 50
- Engage 65
- Engage 75
- Motion UC (over Bluetooth)
- Link 360
- Link 370
- Speak 410
- Speak 510
- Speak 710
- Speak 810
- Link 230
- Link 850
- Link 860 (only settings applicable)
Bug Report
If you find any bug or have any suggestion then fill in the form at Jabra developer support site with below details:
- Bug description with steps to reproduce the issue.
- Console log after enabling debug mode for this module, see Debugging and Logging section for more.
- File logs, see Debugging and Logging section for more.
License
Refer LICENSE.md under installed package directory