nsIHapticFeedback

by 2 contributors:

Draft
This page is not complete.

Mobile Only in Gecko 2.0
Available only in Firefox Mobile as of Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)

Implemented to provide support for haptic feedback (that is, vibration support).
1.0
28
Introduced
Gecko 2.0
Inherits from: nsISupports Last changed in Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)

Implemented by: @mozilla.org/widget/hapticfeedback;1 as a service:

var hapticFeedback = Components.classes["@mozilla.org/widget/hapticfeedback;1"]
                     .getService(Components.interfaces.nsIHapticFeedback);

Once you have the service, you can initiate haptic feedback (that is, cause the device to vibrate, if it's supported) by calling performSimpleAction():

hapticFeedback.performSimpleAction(Components.interfaces.nsIHapticFeedback.LongPress);

Method overview

void performSimpleAction(in long isLongPress);

Constants

Press length constants

Constant Value Description
ShortPress 0 Specify as the action type to perform a short vibration.
LongPress 1 Specify as the action type to perform a long vibration.

Methods

performSimpleAction()

Perform haptic feedback.

void performSimpleAction(
  in long isLongPress
);
Parameters
isLongPress
The press length; this will determine how long the vibration should last. See Press length constants for permitted values.

Document Tags and Contributors

Contributors to this page: Sheppy, MarkFinkle
Last updated by: Sheppy,