Skip to main content

Home > @gnaudio/jabra-js > ICallControl > takeCallLock

ICallControl.takeCallLock() method#

Tries to acquire a call lock. The call lock is a unique, per-device lock, and is required in order to change the state of the device.

Acquiring the call lock should always be the first step in performing call control operations.

Signature:
takeCallLock(): Promise<boolean>;
Returns:

Promise<boolean>

A Promise that resolves with true if the call lock is successfully acquired, false otherwise.

Exceptions#

If you have already call locked the device.

Remarks#

Acquiring a call lock can fail. This can happen due to multiple reasons: - The device is call locked by another softphone that is using the Jabra SDK. This will result in false being returned. - The device is call locked by another instance of your softphone implementation. This will result in false being returned - You've already call locked the device (and therefore can proceed with any other functionality that requires the call lock). This will result in an Exception being thrown.