Skip to main content

DLNotificationMgr

Summary​

The DLNotificationMgr namespace handles device notification features such as vibration. The interface described here is found in dl_notification.js.

Functions​

FunctionDescription
hasVibratorCheck if the device has a vibrator.
vibrateVibrate the device for the specified duration in milliseconds.
vibratePatternVibrate the device with a pattern.
vibrateCancelCancel any ongoing vibration.

Constants​

ConstantsDescription
DL_NOTIFICATION_MGR_VERThe version of DLNotificationMgr.

Functions​

hasVibrator​

hasVibrator(): boolean

Check if the device has a vibrator.

Returns​

True if the device has vibration hardware.

Example​

if (DLNotificationMgr.hasVibrator()) {
    console.log("Vibrator available");
}

vibrate​

vibrate(durationMs: number): boolean

Vibrate the device for the specified duration in milliseconds.

Parameters​

  • durationMs: Duration in milliseconds.

Returns​

True if vibration was started successfully.

Example​

if (!DLNotificationMgr.vibrate(500)) {
    alert("Error: Vibrate request failed.");
}

vibratePattern​

vibratePattern(pattern: string, repeat: number): boolean

Vibrate the device with a pattern.

Parameters​

  • pattern: Comma-separated list of durations (wait,vibrate,wait,vibrate,...).
  • repeat: Index into pattern to repeat from, or -1 for no repeat.

Returns​

True if vibration pattern was started successfully.

Example​

if (!DLNotificationMgr.vibratePattern("0,200,100,200,100,400", -1)) {
    alert("Error: Pattern vibration failed.");
}

vibrateCancel​

vibrateCancel(): boolean

Cancel any ongoing vibration.

Returns​

True if cancel was successful.

Example​

if (!DLNotificationMgr.vibrateCancel()) {
    alert("Error: Cancel failed.");
}

Constants​

DL_NOTIFICATION_MGR_VER​

The version of the DLNotificationMgr.