Resources | developer.brewmp.com Resources | developer.brewmp.com

Developer

resources

Event types

The following are some event types used in Brew MP. These event categories classify the type of event based on where the event was generated.

Applet events are events generated by the shell for applet control:

  • EVT_APP_START
  • EVT_APP_STOP
  • EVT_APP_SUSPEND
  • EVT_APP_RESUME
  • EVT_BROWSE_URL
  • EVT_APP_START_BACKGROUND
  • EVT_APP_MESSAGE

AEE Shell events are events generated by the shell:

  • EVT_NOTIFY
  • EVT_ALARM

Device events are generated by device state changes:

  • EVT_FLIP
  • EVT_HEADSET
  • EVT_KEYGUARD
  • EVT_SCR_ROTATE

User events are private to the application. Developers can define their own private events within the range starting at EVT_USER:

  • EVT_USER

Touch events are generated by touch-enabled devices:

  • EVT_POINTER_DOWN
  • EVT_POINTER_UP
  • EVT_POINTER_MOVE
  • EVT_POINTER_STALE_MOVE

Multitouch events are also generated by touch-enabled devices:

  • EVT_POINTER_MT_DOWN
  • EVT_POINTER_MT_MOVE
  • EVT_POINTER_MT_UP

Special events include EVT_APP_NO_SLEEP, which is sent to an applet after long periods in which the applet is running timers but the user is not interacting with the device. Brew MP sends this event to the applet to check whether to allow the device to enter power-saving mode, usually at a slower clock rate. If the applet responds by returning TRUE, Brew MP does not allow the phone to enter low power mode. Note that returning TRUE results in shorter battery life; applets should use this capability sparingly.

For a comprehensive list of events, see the header file AEEEvent.h, and the AEEEvent structure in the http://developer.brewmp.com/reference/api-all.