Starting the device vibra

Context

The StartVibraL() call starts the device vibration feature. If StartVibraL() is called again before the first vibration completes, the first vibration is interrupted and the second vibrations starts immediately, that is, the periods of vibration are not cumulative. The vibration can be interrupted with the method StopVibraL() before the specified interval has elapsed. Vibra settings of the vibration feature in the user profile must be active.

Note: The device may have implementation defined or hardware imposed limits to the duration of the vibration feature. In such circumstances, any vibration is cut off at that limit even if the duration parameter is greater than the limit.

The following code snippet demonstrates how to start the device vibration feature with factory-defined intensity:

iVibra->StartVibraL( 5000 ); // Start vibra for five seconds.

The following code snippet demonstrates how to start the device vibration feature with client-defined intensity:

iVibra->StartVibraL( 5000, 50 ); // Start vibra for five seconds with intensity 50.