Motorola E680 Technical Manual - Page 38

Vibe and Backlight API - price

Page 38 highlights

10 Vibe and Backlight API Vibe and Backlight API The Vibe and Backlight API allows J2ME applications access to vibrator, backlight, and keypad controls. This API gives a MIDlet the ability to turn these features on or off based on the applications needs. The MIDlet will use this API to enhance the activity being performed by the application. Examples of this enhancement are the following: 1. When in a driving game application, the vibrator is turned on during a crash. 2. An alarm application would have access to turn the vibrator on and off. 3. A stock ticker application turns the backlight on and off when a specified stock hits a target price. Native constraints are in place to protect the battery life of the product. These native constraints will be flexible to allow the operator to make the final call on implementation. For more information refer to the MIDP 2.0 specification. The following are code samples to show implementation of the Vibe and Backlight API: Sample of code for calling of 'vibrate(int)' method of Display class: int duration = 5000;//5 seconds; java.lang.boolean returnValue = display.vibrate(duration); if (returnValue != false) { System.out.println("Invoke vibrate method with parameter = " + duration + ", method returns : " + returnValue); } else { System.out.println("Failed: invoke vibrate(" + duration + "), method returns false"); } 38

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107

38
10
Vibe and Backlight API
Vibe and Backlight API
The Vibe and Backlight API allows J2ME applications access to vibrator, backlight, and
keypad controls. This API gives a MIDlet the ability to turn these features on or off based
on the applications needs. The MIDlet will use this API to enhance the activity being
performed by the application.
Examples of this enhancement are the following:
1.
When in a driving game application, the vibrator is turned on during a crash.
2.
An alarm application would have access to turn the vibrator on and off.
3.
A stock ticker application turns the backlight on and off when a specified stock
hits a target price.
Native constraints are in place to protect the battery life of the product. These native
constraints will be flexible to allow the operator to make the final call on implementation.
For more information refer to the MIDP 2.0 specification.
The following are code samples to show implementation of the Vibe and Backlight API:
Sample of code for calling of ‘vibrate(int)’ method of Display class:
int duration = 5000;//5 seconds;
java.lang.boolean returnValue = display.vibrate(duration);
if (returnValue != false) {
System.out.println("Invoke vibrate method with parameter = "
+ duration + ", method returns : " + returnValue);
}
else {
System.out.println("Failed: invoke vibrate(" + duration +
"), method returns false");
}